Перейти к основному содержимому

Подключение через 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-оператор прокси пока не поддерживают.