3x-uiПодписка
Запуск сервера подписок 3x-ui — форматы base64/JSON/Clash, порты и пути, TLS, заголовки ответа и пользовательские шаблоны.
Подписка — это единый URL, который возвращает все конфигурации клиента. Клиентские приложения периодически обновляют его, поэтому при изменении входящего соединения клиенты подхватывают изменения автоматически. Сервер подписок работает как отдельный сервер от панели.
Включение и настройка
Сервер подписок включён по умолчанию (subEnable). Настройте его в
параметрах подписки панели:
| Параметр | По умолчанию | Назначение |
|---|---|---|
subPort | 2096 | Порт прослушивания (отдельный от панели). |
subListen | (все) | Адрес привязки. |
subPath | /sub/ | Базовый путь для необработанных URL подписок. |
subDomain | (нет) | Публичный хост; если задан, сервер отвечает только для этого Host. |
subCertFile / subKeyFile | (нет) | Сертификат + ключ TLS — когда заданы, сервер работает по HTTPS. |
subEncrypt | true | Кодировать тело необработанной подписки в base64. |
subUpdates | 12 | Рекомендуемый интервал обновления (часы), отправляемый клиентам. |
URL подписки выглядит так:
https://<sub-host>:<sub-port>/sub/<sub-id>где <sub-id> — это Sub ID клиента.
Форматы вывода
Формат выбирается по пути, у каждого свой переключатель включения:
| Формат | Путь | Включается | Вывод |
|---|---|---|---|
| Необработанные ссылки | /sub/ | всегда (если включён) | Список ссылок vless://, vmess://, … (закодированных в base64, когда включён subEncrypt). |
| JSON | /json/ | subJsonEnable | Полные клиентские конфигурации Xray. |
| Clash / Mihomo | /clash/ | subClashEnable | YAML-профиль. |
В подписке появляются только включённые входящие соединения, использующие
VLESS, VMess, Trojan, Shadowsocks или Hysteria2, упорядоченные по их индексу
сортировки подписки. Запрос /sub/ с заголовком Accept: text/html (или
?html=1) возвращает удобочитаемую информационную страницу вместо
необработанного тела.
Заголовки ответа
Подписки возвращают стандартные заголовки, которые читают совместимые приложения:
Subscription-Userinfo—upload,download,total(байты;total=0означает без ограничений) иexpire(Unix-секунды).Profile-Update-Interval— интервал обновления в часах (subUpdates).Profile-Title,Support-Url,Profile-Web-Page-Url,Announce— необязательный брендинг, отображаемый некоторыми клиентами.
Пользовательские шаблоны страниц
Укажите в subThemeDir папку с пользовательским шаблоном информационной
страницы, чтобы оформить HTML-страницу подписки в фирменном стиле. Примечание
для каждого клиента на каждой ссылке полностью шаблонизируется — см.
Ссылки для обмена → переменные примечаний.
Разместите сервер подписок за TLS (задайте subCertFile/subKeyFile или
обратный прокси), чтобы содержимое подписки
не передавалось в открытом виде.
Клиенты
Управление клиентами 3x-ui — учётные данные, лимиты трафика и срока действия, ограничения по IP, группы, массовые операции, внешние ссылки и статус онлайн.
Ссылки для обмена
Форматы ссылок для обмена в 3x-ui (vless, vmess, trojan, ss, hysteria2, mtproto), переменные шаблона примечания и инспектор ссылок в браузере.