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

Статья 139 из 141

Гайды

SSH-туннели: проброс портов -L, -R и SOCKS-прокси -D, autossh и PuTTY

SSH умеет передавать не только команды, но и любые TCP-соединения. Это называется пробросом портов, или SSH-туннелем. С ним вы открываете админ-панель или базу данных на VPS, не публикуя их порты в интернет: сервис слушает только 127.0.0.1, а вы подключаетесь к нему через зашифрованное SSH-соединение.

Нужен только рабочий вход по SSH: подключение, лучше по ключу. На сервере ничего устанавливать не нужно.

Флаг Направление Пример задачи
-L порт на вашем компьютере ведёт к порту на сервере открыть панель или БД, которая слушает 127.0.0.1 на VPS
-R порт на сервере ведёт к порту на вашем компьютере показать локальный сайт через VPS
-D SOCKS-прокси на вашем компьютере, выход в сеть с сервера открыть в браузере несколько внутренних сервисов сервера

Все примеры ниже проверены с OpenSSH 9.6 (Ubuntu 24.04).

Допустим, на сервере работает панель на 127.0.0.1:8080. Снаружи она недоступна, и это правильно. Откройте туннель:

Окно терминала
ssh -N -L 8080:127.0.0.1:8080 user@IP_СЕРВЕРА

Формат: -L [локальный_адрес:]локальный_порт:куда:порт_назначения. Адрес назначения 127.0.0.1 здесь означает сам сервер, потому что соединение до него устанавливает уже сервер.

  • -N не открывает shell, только держит туннель. Остановить: Ctrl+C.
  • -f отправляет ssh в фон после подключения: ssh -f -N -L ....

Теперь откройте в браузере http://127.0.0.1:8080. Проверка на тестовом сервере:

Окно терминала
curl -s http://127.0.0.1:8080/
panel on 127.0.0.1:8080 (server side)

По умолчанию ssh слушает локальный порт только на 127.0.0.1 вашего компьютера, поэтому другие устройства в вашей сети туннелем не воспользуются.

PostgreSQL и MySQL на VPS не нужно открывать наружу. Для DBeaver, pgAdmin или DataGrip пробросьте порт на свободный локальный:

Окно терминала
ssh -N -L 15432:127.0.0.1:5432 user@IP_СЕРВЕРА # PostgreSQL
ssh -N -L 13306:127.0.0.1:3306 user@IP_СЕРВЕРА # MySQL / MariaDB

В клиенте укажите хост 127.0.0.1 и порт 15432 или 13306. Во многих клиентах есть и встроенная вкладка SSH, она делает то же самое. Подробнее о базах: PostgreSQL, MySQL.

Если сервис работает в Docker и опубликован как 127.0.0.1:8080:80, туннель тоже указывайте на 127.0.0.1:8080.

Окно терминала
ssh -N -D 1080 user@IP_СЕРВЕРА

На вашем компьютере появится SOCKS5-прокси 127.0.0.1:1080. Все соединения через него выходят с сервера. Так можно открыть сразу несколько внутренних сервисов VPS без отдельного -L для каждого.

Проверка через curl. Вариант --socks5-hostname передаёт имя хоста на сервер, и DNS тоже разрешается там:

Окно терминала
curl --socks5-hostname 127.0.0.1:1080 http://127.0.0.1:8080/
panel on 127.0.0.1:8080 (server side)

127.0.0.1 в этом запросе снова означает сервер. В Firefox прокси задаётся в параметрах сети, в режиме ручной настройки: узел SOCKS 127.0.0.1, порт 1080, SOCKS v5. Включите там же передачу DNS-запросов через прокси.

Обратный туннель открывает порт на сервере и ведёт его к вашему компьютеру. Например, у вас локально работает сайт на 127.0.0.1:3000:

Окно терминала
ssh -N -R 9000:127.0.0.1:3000 user@IP_СЕРВЕРА

На сервере появится порт 127.0.0.1:9000, который ведёт к вам. Проверено:

$ ss -ltn | grep 9000
LISTEN 0 128 127.0.0.1:9000 0.0.0.0:*
$ curl -s http://127.0.0.1:9000/
local service exposed via -R

Порт слушает только 127.0.0.1 сервера. Чтобы отдать сервис в интернет, настройте на сервере Nginx, который проксирует домен на 127.0.0.1:9000: Nginx на VPS, HTTPS. Можно и открыть порт напрямую, указав GatewayPorts clientspecified в /etc/ssh/sshd_config и адрес 0.0.0.0:9000 в -R, но тогда сервис окажется в интернете без HTTPS и защиты.

Обычный ssh не переподключается после обрыва связи. autossh следит за ssh и запускает его заново. Установка на компьютере или сервере, откуда идёт туннель:

Окно терминала
apt install -y autossh

Ключ для туннеля должен быть без пароля, а ключ сервера заранее добавлен в known_hosts. Иначе туннель не поднимется с ошибкой Host key verification failed:

Окно терминала
ssh-keygen -t ed25519 -N "" -f /root/.ssh/tunnel_key
ssh-copy-id -i /root/.ssh/tunnel_key.pub user@IP_СЕРВЕРА
ssh-keyscan -t ed25519 IP_СЕРВЕРА >> /root/.ssh/known_hosts

Создайте /etc/systemd/system/ssh-tunnel-panel.service:

[Unit]
Description=SSH tunnel to panel (autossh)
After=network-online.target
Wants=network-online.target
[Service]
Environment="AUTOSSH_GATETIME=0"
ExecStart=/usr/bin/autossh -M 0 -N -o "ServerAliveInterval 30" -o "ServerAliveCountMax 3" -o "ExitOnForwardFailure yes" -i /root/.ssh/tunnel_key -L 127.0.0.1:9100:127.0.0.1:8080 user@IP_СЕРВЕРА
Restart=always
RestartSec=10
[Install]
WantedBy=multi-user.target
Окно терминала
systemctl daemon-reload
systemctl enable --now ssh-tunnel-panel
  • -M 0 отключает собственный мониторинг autossh. Обрыв замечает сам ssh через ServerAliveInterval: 3 пропущенных ответа по 30 секунд.
  • ExitOnForwardFailure yes завершает ssh, если порт занят, чтобы autossh попробовал снова.
  • Restart=always поднимет autossh, если завершится и он.

Мы принудительно убили процесс ssh, и autossh сразу запустил новый:

autossh[19327]: ssh exited on signal 9, restarting ssh
autossh[19327]: starting ssh (count 2)
autossh[19327]: ssh child pid is 19395

В Windows 10 и 11 клиент OpenSSH встроен. Команды в PowerShell те же:

Окно терминала
ssh -N -L 8080:127.0.0.1:8080 user@IP_СЕРВЕРА
ssh -N -D 1080 user@IP_СЕРВЕРА
ssh -N -R 9000:127.0.0.1:3000 user@IP_СЕРВЕРА

Окно PowerShell должно оставаться открытым, пока нужен туннель.

В PuTTY:

  1. В Session укажите адрес сервера.
  2. Откройте Connection → SSH → Tunnels.
  3. Для -L: в Source port введите 8080, в Destination 127.0.0.1:8080, выберите Local и нажмите Add.
  4. Для -D: Source port 1080, поле Destination оставьте пустым, выберите Dynamic, Add.
  5. Для -R: выберите Remote.
  6. Вернитесь в Session, сохраните профиль кнопкой Save и нажмите Open.
  • Для туннелей создайте отдельного пользователя и ограничьте его ключ в ~/.ssh/authorized_keys на сервере:
restrict,port-forwarding,permitopen="127.0.0.1:8080" ssh-ed25519 AAAA... tunnel

С такой строкой ключ может пробросить только 127.0.0.1:8080. На попытку открыть другой адрес сервер отвечает administratively prohibited. Проверено. Опция restrict также запрещает агент, X11 и выделение терминала, но не запрещает выполнить команду. Если нужен совсем закрытый пользователь, задайте ему shell /usr/sbin/nologin.

  • Не открывайте локальный конец туннеля на 0.0.0.0 без необходимости: тогда туннелем сможет пользоваться любой в вашей сети.
  • SSH-доступ защищайте ключами и fail2ban, смотрите также усиление SSH.
  • Туннель не заменяет файрвол: сервисы на сервере всё равно должны слушать только 127.0.0.1.
Симптом Причина и решение
bind [127.0.0.1]:8080: Address already in use локальный порт занят другой программой или старым туннелем. Выберите другой порт или завершите процесс: pkill -f "ssh -N -L 8080"
channel 1: open failed: connect failed: Connection refused туннель поднят, но на сервере ничего не слушает этот порт. Проверьте ss -ltnp на сервере
channel 1: open failed: administratively prohibited на сервере запрещён проброс (AllowTcpForwarding no) или ключ ограничен permitopen
Туннель через несколько часов перестаёт работать соединение оборвалось без уведомления. Добавьте -o ServerAliveInterval=30 или используйте autossh
autossh в systemd: Host key verification failed у root нет ключа сервера в known_hosts: выполните ssh-keyscan один раз
-R порт не виден снаружи так и задумано: по умолчанию он слушает 127.0.0.1 сервера. Используйте Nginx