Подключение через SOCKS5-прокси
В некоторых корпоративных сетях и изолированных контурах прямого выхода в интернет нет: наружу пускают только через SOCKS5-прокси. Чтобы tuna CLI работал в такой сети, укажите адрес прокси: через него CLI будет ходить к API и подключать туннели к нодам. Поддерживается SOCKS5, в том числе с логином и паролем, — в tuna-cli 0.42.0 и новее.
Как задать прокси
Адрес прокси задаётся в формате socks5://[логин:пароль@]хост[:порт]. Порт по умолчанию — 1080.
Флагом --proxy — он есть у всех команд:
tuna http 8080 --proxy socks5://proxy.corp.local:1080
Переменной окружения TUNA_PROXY:
export TUNA_PROXY=socks5://user:password@proxy.corp.local:1080
tuna http 8080
Ключом proxy в конфигурационном файле — тогда он действует при каждом запуске. Отдельной команды для этого ключа нет, допишите его в файл сами:
---
version: "1"
apiKey: tak_***
proxy: socks5://user:password@proxy.corp.local:1080
Если прокси задан в нескольких местах, приоритет такой: флаг, переменная, конфиг.
Схемы socks5:// и socks5h:// работают одинаково: имена хостов всегда резолвит прокси, поэтому CLI работает даже без DNS. Другая схема, например http://, — ошибка only socks5:// is supported, и команда не запустится.
ALL_PROXY, HTTPS_PROXY и NO_PROXY CLI не читает — только TUNA_PROXY. Иначе у пользователей с системным прокси для браузера трафик tuna молча пошёл бы другим путём.
Что идёт через прокси
- Все запросы к API и загрузка записей SSH-сессий.
- Подключения туннелей к нодам:
http,tcp,ssh,app,postgres,mysql,redis,kubernetesи другие, в том числеtuna start. - Проверки
tuna diagnose.
Соединения с вашим локальным сервисом идут напрямую: прокси нужен только для выхода в интернет.
Фоновый сервис
Передайте прокси в команде туннеля или задайте TUNA_PROXY перед установкой сервиса:
tuna service install -- tuna http 8080 --subdomain=web --proxy socks5://user:password@proxy.corp.local:1080
install уберёт --proxy из командной строки сервиса и передаст адрес в его окружение как TUNA_PROXY, чтобы пароль от прокси не было видно в списке процессов.
Диагностика
tuna diagnose первой строкой показывает, через какой прокси идут проверки. Пароль скрыт:
Proxy: socks5://user:xxxxx@proxy.corp.local:1080
В ошибках подключения через прокси есть via proxy и адрес прокси. Например, при неверном пароле (в tuna diagnose она будет в строке tuna API: FAIL):
via proxy socks5://user:xxxxx@proxy.corp.local:1080: socks connect tcp proxy.corp.local:1080->api.tuna.am:443: username/password authentication failed
Если не проходят проверки до нод, убедитесь, что прокси пускает соединения на порт 443 к адресам из раздела Работа tuna в корпоративной сети.
Ограничения
- Только SOCKS5. HTTP-прокси и список исключений
NO_PROXYне поддерживаются. tuna bastion sshзапускает системныйsshи прокси из настроек tuna не использует. Для него настройтеProxyCommandв~/.ssh/config.- Tuna Mesh работает через WireGuard по UDP и через SOCKS5-прокси не подключается.
- Tuna Desktop и Kubernetes-оператор прокси пока не поддерживают.