# SMProxy documentation

> Documentation for SMProxy — a VPN client for VLESS, Reality, VMess, Trojan, Shadowsocks and WireGuard/AmneziaWG on iOS, iPadOS, macOS, Apple TV, Android, Android TV, Windows and Linux. Covers provider integration (subscription formats, HTTP headers, deep links, routing profiles) and every app setting. Russian pages live at the same paths without the /en/ prefix.

- [Главная](https://docs.smproxy.io/en/index/): WireGuard/AmneziaWG. iOS, iPadOS, macOS, Apple TV, Android, Android TV, Windows and Linux.

## Для разработчиков

- [Обзор](https://docs.smproxy.io/en/dev-docs/index/): SMProxy App is a free cross-platform client for Vless/Reality, VMess, Trojan, Shadowsocks, Socks, WireGuard and AmneziaWG, built on the Xray core. The app do…
- [Стоимость — сейчас всё бесплатно](https://docs.smproxy.io/en/dev-docs/pricing-everything-is-free-right-now/): SMProxy App is in active development and open testing, so all features are free right now and will stay that way for a long time: subscription import, all se…
- [Что требует активного Provider ID](https://docs.smproxy.io/en/dev-docs/what-needs-an-active-provider-id/): One place to check instead of hunting for the 🔒 marks. Active means the Provider ID sent with the subscription belongs to a provider account that is currentl…
- [Добавление подписки](https://docs.smproxy.io/en/dev-docs/adding-a-subscription/): Paste an https://… link — the server returns the config body and headers.
- [Метаданные подписки](https://docs.smproxy.io/en/dev-docs/subscription-metadata/): The subscription endpoint response is the body (server list) plus metadata (branding, expiry, updates). Metadata can be delivered two ways, and the client re…
- [Заголовки запроса](https://docs.smproxy.io/en/dev-docs/request-headers-client-server/): Every subscription fetch carries these headers, so a panel can identify the device and bind a subscription to it (a routing-profile download carries only the…
- [Описание сервера](https://docs.smproxy.io/en/dev-docs/server-description/): A per-server caption shown under the server name instead of the default protocol label (VLESS | TCP | Reality). Use it to say something the label can't — Net…
- [Идентификатор подписки](https://docs.smproxy.io/en/dev-docs/subscription-id-subid/): Send a subid and that stops happening: the app treats a matching subid as the same subscription, replaces its URL with the new one and refreshes its servers …
- [Скрытие URL подписки](https://docs.smproxy.io/en/dev-docs/hiding-the-subscription-url-hide-settings/): hide-settings: 1 stops the subscription URL and its raw content from leaving the device. It puts the subscription into exactly the same state as an encrypted…
- [Два канала, одно правило](https://docs.smproxy.io/en/dev-docs/two-channels-one-rule-who-set-a-value-can-clear-it/): The same keys can arrive two ways — in the subscription response (an HTTP header or a #key: line) and from the provider account (applied to online devices wi…
- [Форматы ссылок](https://docs.smproxy.io/en/dev-docs/link-formats/): Everything the client accepts, in one place. All schemes are case-insensitive.
- [Профили маршрутизации](https://docs.smproxy.io/en/dev-docs/routing-profiles/): A routing profile is a full rule set: what goes straight out, what goes through the tunnel and what is blocked, plus optional split-DNS. It answers “my subsc…
- [Обход блокировок](https://docs.smproxy.io/en/dev-docs/censorship-bypass/): DPI systems often block by SNI (the destination domain) read from the TLS ClientHello — the first packet of every TLS/Reality handshake. Fragmentation splits…
- [GeoIP / GeoSite](https://docs.smproxy.io/en/dev-docs/geoip-geosite/): The Geo rules the tunnel uses live inside the imported Xray config and are resolved against the geoip.dat / geosite.dat databases. The app ships with built-i…
- [WireGuard и AmneziaWG](https://docs.smproxy.io/en/dev-docs/wireguard-amneziawg/): WireGuard and AmneziaWG servers behave like any others: they sit in the same list next to VLESS/Trojan/Shadowsocks and the user picks them the same way. Ther…
- [Deep-links](https://docs.smproxy.io/en/dev-docs/deep-links-smproxy/): Encryption uses a shared AES-256-GCM key; addhw binds a link to a single device (anti-sharing). Tapping a link goes through the deep-link handler; pasting in…
- [Сообщения и уведомления](https://docs.smproxy.io/en/dev-docs/messages-notifications/): A provider can send users in-app messages. They arrive inside the Provider ID check response and land in the app inbox (bell icon + unread counter), optional…
- [Генераторы ссылок](https://docs.smproxy.io/en/dev-docs/tools/): Ready-made tools on the website: no registration, everything is computed in the browser.
- [Документация для ИИ](https://docs.smproxy.io/en/dev-docs/ai-assistants/): You can connect the SMProxy documentation to an AI assistant, and it will answer questions
- [Кабинет провайдера](https://docs.smproxy.io/en/dev-docs/provider-portal/): The portal at provider.smproxy.io is
- [Provider ID](https://docs.smproxy.io/en/dev-docs/provider-id/): Provider ID links a subscription to a provider account so the provider can see usage statistics for their subscription. It restricts nothing — the app works …
- [Подтверждение домена](https://docs.smproxy.io/en/dev-docs/domain-verification-statistics-without-a-provider-id/): Statistics only work when the app knows your Provider ID. If a build does not send it — an older release, a client you do not control, a config imported by h…
- [Перевод на другой домен](https://docs.smproxy.io/en/dev-docs/moving-users-to-another-domain/): Your subscription domain gets blocked, or you simply move to a new one. Both cases are handled from the portal — you do not have to change anything in your p…

## Настройки приложения

- [Что где настраивается](https://docs.smproxy.io/en/settings/index/): SMProxy has two independent layers of configuration — don't confuse them. The provider's configuration always owns routing, chains, balancers and DNS rules. …
- [Подключение](https://docs.smproxy.io/en/settings/connection/): Proxy-only mode is useful when another VPN or an MDM profile already owns the system VPN slot, or when only one application should be routed. It requires SOC…
- [Быстрое переключение](https://docs.smproxy.io/en/settings/quick-toggle/): Turn the tunnel on and off without opening the app. On both platforms you add the control yourself, once.
- [Локальный прокси](https://docs.smproxy.io/en/settings/local-proxy/): Ports are configurable and persist when the proxy is toggled off. Defaults sit outside the 10808–10810 range on purpose, because subscription configs commonl…
- [DNS](https://docs.smproxy.io/en/settings/dns/): Resolves DNS inside the tunnel instead of through the system resolver. A subscription's own DNS section always takes precedence.
- [Мультиплексирование](https://docs.smproxy.io/en/settings/multiplexing/): Multiplexing carries several logical connections over one physical connection to the server. It can reduce handshake overhead, but it is not automatically be…
- [Раздельная маршрутизация](https://docs.smproxy.io/en/settings/split-routing/): Decide what actually goes through the tunnel and what goes straight out — by address, and on Android by app. Both lists work the same way: the list itself is…
- [Профили маршрутизации](https://docs.smproxy.io/en/settings/routing-profiles/): A routing profile is a complete rule set — what goes straight out, what goes through the tunnel and what is blocked, plus optional DNS. Where the routing rul…
- [Обход блокировок](https://docs.smproxy.io/en/settings/censorship-bypass/): Splits the TLS handshake so DPI systems can't match the SNI in a single packet. A provider can also drive it for its own users via a subscription header, and…
- [Подписки](https://docs.smproxy.io/en/settings/subscriptions/): A subscription is also refreshed regardless of these settings when it looks expired, so a renewal on the provider's side is picked up rather than reported as…
- [Приватность, данные и внешний вид](https://docs.smproxy.io/en/settings/privacy-data-appearance/): Apple platforms ask for consent before sending any diagnostic check-in. This gate is intentionally Apple-only, to satisfy App Store requirements.
- [Системные требования](https://docs.smproxy.io/en/settings/system-requirements/)
- [Чего SMProxy не делает](https://docs.smproxy.io/en/settings/what-smproxy-does-not-do/): Everything above reflects what the apps do today. Defaults and platform availability may change as the apps evolve.