3x-uiTUIC
Настройка входящего подключения TUIC в 3x-ui — параметры перегрузок QUIC, 0-RTT рукопожатия и многопользовательская аутентификация.
TUIC (v5) — это протокол проксирования, работающий поверх транспортного уровня QUIC (HTTP/3). Он использует 0-RTT рукопожатия, мультиплексирование соединений без блокировки начала очереди и настраиваемый контроль перегрузок для поддержания стабильной связи на сетях с потерями пакетов.
TUIC работает как встроенный нативный Go-сервер прямо внутри процесса 3x-ui. Расшифрованный трафик направляется в ядро Xray-core через локальный SOCKS5-мост, что обеспечивает полную поддержку правил маршрутизации Xray, каскадирования (например, TUIC → VLESS / WARP), персональных квот клиентов (totalGB) и управления клиентами в памяти.
Ключевые параметры
Параметры сервера, QUIC и клиентского профиля
| Поле | Описание |
|---|---|
| Порт | UDP-порт для входящих QUIC-соединений клиентов. |
| Сертификат и ключ | Полная цепочка SSL-сертификата и приватный ключ. Протокол QUIC требует обязательного шифрования TLS; поддерживаются сертификаты Let's Encrypt / ACME или самоподписанные. |
| SNI | Server Name Indication для профиля клиента. Укажите домен, покрытый сертификатом сервера; это поле не настраивает сертификат listener'а. |
| Контроль перегрузок | Алгоритм QUIC в настройках сервера и экспортируемом профиле: bbr, cubic или new_reno. Сервер использует BBR или New Reno; при выборе CUBIC клиентский профиль сохраняет CUBIC, а сервер пока применяет New Reno. |
| ALPN | Токены протоколов уровня приложений (по умолчанию: h3). |
| Режим UDP Relay | Режим UDP в профиле клиента: native (QUIC datagrams) или quic (однонаправленные потоки). Сервер принимает оба режима независимо от этого значения. |
| Zero-RTT Handshake | Включает 0-RTT возобновление сессий для мгновенного повторного подключения клиентов без ожидания завершения рукопожатия. |
| Таймаут аутентификации | Максимальное время (в секундах) на прохождение аутентификации клиентом (по умолчанию: 3s). |
| Максимальный простой | Таймаут бездействия (в секундах) перед закрытием неактивных QUIC-соединений (по умолчанию: 15s). |
| Максимальный размер пакета | Максимальный размер пакета UDP-релея в байтах (по умолчанию: 1500). |
Настройка в панели
Добавьте инбаунд
Создайте новый инбаунд и выберите протокол TUIC. Задайте UDP-порт (например, 8443 или 443).
Укажите TLS-сертификат
Укажите пути к файлам сертификата и приватного ключа (или вставьте их содержимое напрямую). Убедитесь, что поле SNI совпадает с доменом сертификата.
Настройте параметры QUIC
Панель автоматически подставляет рекомендованные настройки (bbr, h3, native). При необходимости настройте таймауты или включите Zero-RTT Handshake.
Добавьте клиентов
Для каждого клиента требуется Email (идентификатор), UUID (токен) и Пароль. Идентификатор Email для TUIC должен занимать 1–255 байт UTF-8. Старые клиенты с некорректными идентификаторами исключаются из обслуживания TUIC с предупреждением; для восстановления доступа сократите идентификатор. Панель автоматически генерирует надёжные случайные данные при создании клиента.
Экспортируйте и подключитесь
Скопируйте ссылку tuic://… или откройте окно QR-кода, чтобы скачать готовый конфигурационный файл Clash / Mihomo YAML.
Поддержка клиентами и конфигурация
TUIC v5 поддерживается всеми популярными клиентами, включая Clash Verge Rev, Mihomo, Flclash, sing-box и v2rayN.
Конфигурация Clash / Mihomo
Панель предоставляет автоматический экспорт в формат YAML прямо в окне QR-кода клиента:
proxies:
- name: "3x-ui-tuic"
type: tuic
server: vpn.example.com
port: 8443
uuid: 8a47f2b1-5e8c-4a3d-9b1e-7f6c5d4a3b2a
password: secure-random-password
alpn:
- h3
sni: vpn.example.com
congestion-controller: bbr
udp-relay-mode: native
reduce-rtt: false
skip-cert-verify: falseФормат ссылки для обмена
Ссылки TUIC используют стандартный формат URI:
tuic://<uuid>:<password>@<host>:<port>?congestion_control=bbr&alpn=h3&sni=vpn.example.com&udp_relay_mode=native&allow_insecure=0#RemarkАрхитектура и возможности
- Нативный Go-движок: TUIC v5 работает на 100% нативно на Go внутри процесса 3x-ui. Никаких внешних сторонних бинарников скачивать не требуется.
- Маршрутизация и каскады в Xray: Трафик проходит через движок маршрутизации Xray. Идентификатор Email клиента передаётся в правила
userдля TCP и обоих режимов UDP. Поддерживаются теги инбаундов (in-<port>-udp), правила по доменам/IP и каскадирование через любой outbound. Ставьте специфичные правилаinboundTag+userвыше общих правилuser: Xray выбирает первое совпадение. - Персональные квоты трафика: Лимиты трафика (
totalGB) и сроки действия (expiryTime) учитываются и применяются индивидуально для каждого клиента. - Скорость и общий трафик: Нативные счётчики клиентов TUIC опрашиваются раз в 10 секунд и передаются в панель для отображения скорости. Xray отдельно считает общий трафик инбаунда через локальный relay. Отдельная policy отключает в relay пользовательские счётчики трафика и учёт loopback-IP: источником клиентского трафика, скорости и активности остаётся нативный TUIC.
- Ограничения UDP: На одно QUIC-соединение допускается до 256 активных UDP-ассоциаций. Неактивные ассоциации закрываются через пять минут. Это лимит на соединение, а не общий лимит узла. TUIC использует выделенный локальный SOCKS-порт из диапазона
64001–65000; 3x-ui проверяет его конфликты с управляемыми инбаундами и relay-портами. - Обновление клиентов: Включённость, квоты и срок проверяет нативный TUIC; сброс квоты восстанавливает доступ без перезапуска Xray. Добавление, удаление или переименование клиента заменяет только внутренний SOCKS relay его inbound. Аккаунты проверяются до замены и повторно сверяются с работающим relay после неё. При ошибке восстанавливается прежний relay и планируется повторная попытка. Ошибки изолированы в группе связанных relay: исправные TUIC inbound и независимые изменения Xray продолжают применяться. Изменения маршрутизации, зависящие от неудачной смены тега, ожидают восстановления этого relay. Связанные изменения клиентов и inbound тоже откладываются; новые TUIC-сессии допускаются после применения их правил маршрутизации. Новые relay-соединения ожидают до 10 секунд во время замены или отката; открытые TCP-потоки и UDP-ассоциации продолжают работать. Пакеты новых UDP-ассоциаций помещаются в ограниченную очередь, не блокируя действующие потоки того же QUIC-соединения. При отключении клиента ожидание отменяется. Переполнение очереди или недоступность relay всё ещё могут привести к отказу нового запроса; остальные протоколы продолжают работать. Изменение только TUIC-пароля или параметров клиентского профиля не меняет relay-аккаунты.
- Развёртывание: Инбаунд TUIC можно создать на дочернем узле или клонировать туда. TUIC-сервер запускает панель самого узла, поэтому на узле нужна панель v3.8.0 или новее; более старый узел главная панель отклоняет.