Редакция от 5 сентября 2026 года
Здесь описано то, что клиент умеет сегодня. Разделы, помеченные «скоро», ещё не реализованы — они перечислены, чтобы было видно направление, а не чтобы по ним что-то пробовать.
Клиент разбирает семь протокольных схем, десять с учётом коротких синонимов. Схемы, которых нет в списке, он пропускает.
| протокол | схема | что это |
|---|---|---|
| vless | vless:// | VLESS, в том числе Reality |
| hysteria2 | hysteria2:// · hy2:// | Hysteria2 поверх QUIC |
| trojan | trojan:// | Trojan |
| ss | ss:// | Shadowsocks |
| vmess | vmess:// | VMess |
| socks | socks:// · socks5:// | SOCKS5-прокси |
| wireguard | wireguard:// · wg:// | WireGuard |
Ссылку на конфигурацию можно вставить в поле или из буфера обмена. Тело ответа принимается в трёх видах: строки в base64, те же строки открытым текстом и одиночная ссылка на один сервер.
Каждая ссылка превращается в самостоятельный профиль. Локальные socks- и http-входы клиент в профиль не кладёт намеренно: незапароленный локальный socks на устройстве — это дыра.
Сервер конфигурации может передать клиенту четыре заголовка. Все они необязательны.
| заголовок | назначение |
|---|---|
| Profile-Title | имя профиля в списке клиента |
| Profile-Update-Interval | через сколько часов обновлять |
| Subscription-Userinfo | upload, download, total, expire — байты и unix-время |
| Support-URL | ссылка на поддержку провайдера |
Subscription-Userinfo передаётся одной строкой вида upload=0; download=0; total=0; expire=0 — байты и unix-время. Ноль в total означает отсутствие ограничения, ноль в expire — отсутствие срока.
| раздел | о чём будет |
|---|---|
| Provider API скоро | конфигурация провайдера по хешу домена, оформление, лимит устройств |
| Deep links скоро | управление клиентом по ссылке: импорт, подключение, маршрутизация |
| HWID скоро | аппаратный идентификатор устройства и привязка к нему |
Кода за этими разделами пока нет. Как появится — документация придёт вместе с ним, а не раньше.
Список схем сверен с разбором ссылок в клиенте, заголовки — с кодом, который их отдаёт. При расхождении документации и поведения клиента верно поведение: напишите нам, и мы поправим страницу.