SMProxy documentation¶
SMProxy is a client for VLESS, Reality, VMess, Trojan, Shadowsocks, WireGuard/AmneziaWG, Hysteria 2 and TUIC v5. iOS, iPadOS, macOS, Apple TV, Android, Android TV, Windows and Linux.
The app ships no servers and provides no VPN service: the user imports a subscription from a provider and connects. Everything is free — there are no paid tiers and no gated features.
Developer documentation¶
Integration for subscription providers and panels.
Subscriptions & servers
- Adding a subscription — three ways to import
- Subscription metadata — response headers: branding, expiry, updates
- Request headers — what the app tells you about itself
- Link formats — VLESS, VMess, Trojan, Shadowsocks, WireGuard, Hysteria 2, TUIC, deep links
- Hiding the subscription URL —
hide-settings
Routing & censorship bypass
- Routing profiles — rules, DNS, auto-updating profiles
- Censorship bypass — TLS fragmentation, noise packets, DoH
- WireGuard & AmneziaWG — obfuscation parameters by version
- GeoIP / GeoSite — your own databases for rules
Account & tools
- What needs an active Provider ID — what works without one and what doesn't
- Provider portal — statistics, messages, Provider ID
- Link generators — WireGuard converter, routing builder, encrypted links
- Documentation for AI — connect the MCP server in one command
App settings¶
What is configured inside the app, and on which platforms.
- What's configured where — the map: subscription, settings, profile
- Connection — run mode, MTU, auto-connect, kill switch
- Split routing — which apps and sites bypass the tunnel
- DNS · Local proxy · Multiplexing
- System requirements — minimum OS versions
Documentation for AI assistants¶
The documentation has its own MCP server: an assistant connects in one command and then finds the right page by itself, instead of inventing header names.
Setup for Cursor, VS Code, Codex and others is on the Documentation for AI page.
If your assistant has no MCP support, point it at the whole documentation in one file: llms-full.txt; the page index is at llms.txt.
The app¶
Downloads and release notes: GitLab · Website: smproxy.io