> Markdown-версия страницы https://tuna.am/docs/guides/proxy/. Оглавление документации — [llms.txt](https://tuna.am/llms.txt), весь текст одним файлом — [llms-full.txt](https://tuna.am/llms-full.txt). Markdown-версия есть у любой страницы: добавьте `.md` к адресу без слеша на конце.

# Подключение через SOCKS5-прокси

В некоторых корпоративных сетях и изолированных контурах прямого выхода в интернет нет: наружу пускают только через SOCKS5-прокси. Чтобы tuna CLI работал в такой сети, укажите адрес прокси: через него CLI будет ходить к API и подключать туннели к нодам. Поддерживается SOCKS5, в том числе с логином и паролем, — в tuna-cli 0.42.0 и новее.

## Как задать прокси

Адрес прокси задаётся в формате `socks5://[логин:пароль@]хост[:порт]`. Порт по умолчанию — `1080`.

Флагом `--proxy` — он есть у всех команд:

```shell
tuna http 8080 --proxy socks5://proxy.corp.local:1080

```

Переменной окружения `TUNA_PROXY`:

```shell
export TUNA_PROXY=socks5://user:password@proxy.corp.local:1080
tuna http 8080

```

Ключом `proxy` в [конфигурационном файле](https://tuna.am/docs/guides/config-file.md) — тогда он действует при каждом запуске. Отдельной команды для этого ключа нет, допишите его в файл сами:

```yaml
---
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`](https://tuna.am/docs/tunnels/guides/multi-tunnels.md).
* Проверки `tuna diagnose`.

Соединения с вашим локальным сервисом идут напрямую: прокси нужен только для выхода в интернет.

## Фоновый сервис

Передайте прокси в команде туннеля или задайте `TUNA_PROXY` перед установкой [сервиса](https://tuna.am/docs/tunnels/guides/service.md):

```shell
tuna service install -- tuna http 8080 --subdomain=web --proxy socks5://user:password@proxy.corp.local:1080

```

`install` уберёт `--proxy` из командной строки сервиса и передаст адрес в его окружение как `TUNA_PROXY`, чтобы пароль от прокси не было видно в списке процессов.

## Диагностика

`tuna diagnose` первой строкой показывает, через какой прокси идут проверки. Пароль скрыт:

```text
Proxy: socks5://user:xxxxx@proxy.corp.local:1080

```

В ошибках подключения через прокси есть `via proxy` и адрес прокси. Например, при неверном пароле (в `tuna diagnose` она будет в строке `tuna API: FAIL`):

```text
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 в корпоративной сети](https://tuna.am/docs/guides/corporate-network.md#firewall-addresses).

## Ограничения

* Только SOCKS5. HTTP-прокси и список исключений `NO_PROXY` не поддерживаются.
* [`tuna bastion ssh`](https://tuna.am/docs/bastion.md) запускает системный `ssh` и прокси из настроек tuna не использует. Для него настройте `ProxyCommand` в `~/.ssh/config`.
* [Tuna Mesh](https://tuna.am/docs/mesh.md) работает через WireGuard по UDP и через SOCKS5-прокси не подключается.
* Tuna Desktop и [Kubernetes-оператор](https://tuna.am/docs/tunnels/guides/kubernetes-operator.md) прокси пока не поддерживают.
