TUIC на Linux: установка клиента и запуск из терминала

Что такое TUIC и почему выбирают его на Linux

TUIC (Tunnel with UDP In Conjunction) — это протокол проксирования, который использует QUIC (Quick UDP Internet Connections) для передачи данных. Он предназначен для создания низколатентных и стабильных туннелей, особенно в условиях нестабильных сетей. В отличие от TCP-based прокси, TUIC работает поверх UDP, что снижает задержки и уменьшает влияние потери пакетов.

На Linux TUIC-клиент чаще всего распространяется как одиночный бинарный файл tuic-client. Его просто загрузить из официального репозитория GitHub и запустить из терминала — никаких зависимостей и сложных установщиков. В этой статье вы найдёте полный рабочий процесс: от скачивания до диагностики.

Предварительные требования и установка клиента TUIC

Убедитесь, что у вашей системы есть:

• Архитектура x86_64 или ARM64 (проверьте командой uname -m);
• Права на запись в каталог установки (например, /usr/local/bin);
• Инструмент для извлечения архивов (tar обычно уже установлен);
• Опционально: curl или wget для загрузки файла.

Скачивание с GitHub Releases

Перейдите на страницу релизов TUIC и найдите файл для вашей архитектуры, например tuic-client-1.0.0-x86_64-linux. Скопируйте ссылку на архив и загрузите его:

curl -LO https://github.com/EAimTY/tuic/releases/download/1.0.0/tuic-client-1.0.0-x86_64-linux.tar.gz

Распакуйте и переместите бинарник в системный путь:

tar -xzf tuic-client-1.0.0-x86_64-linux.tar.gz
sudo mv tuic-client /usr/local/bin/
sudo chmod +x /usr/local/bin/tuic-client

Установка из пакетного менеджера

Некоторые дистрибутивы (например, Arch Linux) имеют пакет tuic. Для Arch:

sudo pacman -S tuic

Но версии в репозиториях могут отставать — свежие бинарники всегда доступны на GitHub.

Сборка из исходников

Если вам нужна ночная сборка или вы используете нестандартную архитектуру, соберите из исходного кода:

git clone https://github.com/EAimTY/tuic.git
cd tuic
cargo build --release --bin tuic-client
# Бинарник появится в target/release/

Сборка требует Rust и Cargo. Это более длинный путь, но он даёт максимум контроля.

Настройка конфигурации клиента TUIC

TUIC-клиент принимает JSON-файл конфигурации. В нём описываются локальный прокси, параметры сервера и транспортный протокол. Разберём минимальный рабочий конфиг:

{
  "relay": {
    "server": "your-server.com",
    "port": 443,
    "token": "ваш-секретный-токен",
    "ip": "1.2.3.4",
    "congestion_control": "bbr",
    "udp_relay_mode": "native",
    "zero_copy": true
  },
  "local": {
    "port": 1080,
    "ip": "127.0.0.1",
    "username": "",
    "password": ""
  },
  "log_level": "info"
}

Основные поля:

• relay.server — адрес сервера TUIC (домен или IP);
• relay.port — порт сервера (обычно 443, чтобы маскироваться под HTTPS);
• relay.token — строка-пароль для аутентификации;
• relay.ip — IP-адрес сервера (если домен не резолвится, или для обхода DNS-проблем);
• relay.congestion_control — алгоритм контроля перегрузки QUIC: cubic или bbr;
• relay.udp_relay_mode — режим UDP-релея: native или quic;
• relay.zero_copy — включает оптимизацию копирования данных;
• local.port — порт локального SOCKS5-прокси;
• local.ip — адрес прослушивания (обычно 127.0.0.1);
• local.username и local.password — опционально, для защиты локального прокси;
• log_level — уровень логирования: info, warn, error, debug, trace.

Если вы используете TLS-сертификат, укажите пути к сертификатам:

"relay": {
  "certificates": "/path/to/cert.pem",
  "private_key": "/path/to/key.pem"
}

Обычно клиенту не нужен сертификат, если сервер использует публичный сертификат Let's Encrypt — тогда просто укажите домен в server.

Запуск TUIC из терминала и проверка подключения

Когда конфигурация готова, запустите клиент:

tuic-client -c config.json

Если вы переместили конфиг в другое место, укажите полный путь. При успешном запуске вы увидите сообщение о том, что локальный прокси слушает порт 1080.

Проверьте прокси с помощью curl:

curl --socks5-hostname 127.0.0.1:1080 https://example.com

Если используете HTTP-прокси, добавьте флаг --proxy:

curl --proxy http://127.0.0.1:1080 https://example.com

Также можно проверить UDP-проброс, например через dig с опцией +tries:

dig @8.8.8.8 example.com +tries=3 -p 53

Запуск TUIC как systemd-сервиса

Для постоянной работы создайте unit-файл /etc/systemd/system/tuic-client.service:

[Unit]
Description=TUIC Client
After=network-online.target
Wants=network-online.target

[Service]
ExecStart=/usr/local/bin/tuic-client -c /etc/tuic/config.json
Restart=on-failure
RestartSec=5
User=nobody
Group=nogroup

[Install]
WantedBy=multi-user.target

Затем выполните:

sudo systemctl daemon-reload
sudo systemctl enable --now tuic-client
sudo systemctl status tuic-client

Разбор параметров TUIC: QUIC, UDP, TLS

TUIC использует QUIC как транспортный протокол. QUIC построен на UDP и обеспечивает мультиплексирование, шифрование TLS по умолчанию и контроль перегрузки. Это даёт преимущества при использовании в высоколатентных сетях или при частой смене IP.

Параметр congestion_control управляет алгоритмом: cubic — классический, хорошо работает в стабильных сетях; bbr — оптимизирован для сетей с потерями пакетов, часто быстрее на низких скоростях. Экспериментируйте.

UDP-релейный режим может быть native (передаёт UDP как есть) или quic (инкапсулирует в отдельные QUIC-потоки). Для совместимости с большинством приложений используйте native.

TLS — это обязательная часть QUIC. TUIC поддерживает как собственные сертификаты, так и публичные. Если сервер использует самоподписанный сертификат, клиент должен доверять ему — либо добавьте сертификат в системное хранилище, либо укажите его в конфиге через certificates.

Важные флаги командной строки

• -c — путь к конфигурационному файлу;
• -v — версия;
• -d — запуск в фоне (демон);
• -log — файл лога (например, tuic.log).

Диагностика: клиент, сервер, сеть и DNS

Если соединение не работает, разделите проблему на четыре уровня: клиент, сервер, сеть, DNS.

Клиентская проверка

• Проверьте синтаксис конфига: tuic-client -c config.json -v покажет ошибки;
• Убедитесь, что локальный порт не занят: netstat -tulpn | grep 1080;
• Запустите с log_level: "debug" и просмотрите вывод — там будет указано, какое именно соединение с сервером не удаётся.

Серверная проверка

• Проверьте, что сервер TUIC запущен: systemctl status tuic-server;
• Убедитесь, что порт открыт в файрволе: sudo ufw status;
• Проверьте, что UDP-пакеты не блокируются (QUIC использует UDP);
• Совместимость токена — сверьте значения на клиенте и сервере.

Сеть и DNS

• Зарезолвите домен сервера: dig your-server.com;
• Попробуйте указать IP напрямую в relay.ip, чтобы исключить DNS-проблемы;
• Используйте ping -c 5 1.2.3.4 для проверки базовой связности;
• Для проверки QUIC можно использовать qlog или tshark, но это уже экспертный уровень.

Частые ошибки и как их исправить

Вот список типичных ситуаций, с которыми сталкиваются пользователи:

• «connection reset» или «timeout» — чаще всего сервер недоступен, порт закрыт или интернет-провайдер блокирует UDP. Проверьте фаервол и попробуйте другой порт (например, 853, который ассоциируется с DNS-over-TLS).
• «malformed configuration» — ошибка в JSON. Проверьте запятые, кавычки и скобки с помощью jq . config.json.
• UDP не работает — проверьте параметр udp_relay_mode и убедитесь, что сервер поддерживает этот режим.
• Слишком низкая скорость — попробуйте сменить congestion_control на bbr, если он доступен на вашем ядре.
• Ошибка TLS — если сервер использует самоподписанный сертификат, укажите его в конфиге и проверьте срок действия.

Безопасность и финальные рекомендации

TUIC-клиент хранит конфигурацию с токеном, поэтому защитите файл правами доступа: chmod 600 config.json. Никогда не публикуйте свои токены и не используйте чужие конфигурации из непроверенных источников. Всегда загружайте бинарники только из официального репозитория EAimTY/tuic.

Для автоматического обновления можно написать простой скрипт, который скачивает последний релиз через GitHub API. Но не забывайте проверять подписи и хеши, если они публикуются.

Мы разобрали установку, настройку и диагностику. Теперь вы знаете, что за протоколом TUIC стоит QUIC и TLS, и можете гибко настраивать своего клиента под конкретную сеть.