Статья 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).
Локальный проброс: ssh -L
Заголовок раздела «Локальный проброс: ssh -L»Допустим, на сервере работает панель на 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_СЕРВЕРА # PostgreSQLssh -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.
SOCKS-прокси: ssh -D
Заголовок раздела «SOCKS-прокси: ssh -D»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-запросов через прокси.
Обратный проброс: ssh -R
Заголовок раздела «Обратный проброс: ssh -R»Обратный туннель открывает порт на сервере и ведёт его к вашему компьютеру. Например, у вас локально работает сайт на 127.0.0.1:3000:
ssh -N -R 9000:127.0.0.1:3000 user@IP_СЕРВЕРАНа сервере появится порт 127.0.0.1:9000, который ведёт к вам. Проверено:
$ ss -ltn | grep 9000LISTEN 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 и защиты.
Постоянный туннель: autossh и systemd
Заголовок раздела «Постоянный туннель: autossh и systemd»Обычный ssh не переподключается после обрыва связи. autossh следит за ssh и запускает его заново. Установка на компьютере или сервере, откуда идёт туннель:
apt install -y autosshКлюч для туннеля должен быть без пароля, а ключ сервера заранее добавлен в known_hosts. Иначе туннель не поднимется с ошибкой Host key verification failed:
ssh-keygen -t ed25519 -N "" -f /root/.ssh/tunnel_keyssh-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.targetWants=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=alwaysRestartSec=10
[Install]WantedBy=multi-user.targetsystemctl daemon-reloadsystemctl 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 sshautossh[19327]: starting ssh (count 2)autossh[19327]: ssh child pid is 19395Windows: PowerShell и PuTTY
Заголовок раздела «Windows: PowerShell и PuTTY»В 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:
- В Session укажите адрес сервера.
- Откройте Connection → SSH → Tunnels.
- Для
-L: в Source port введите8080, в Destination127.0.0.1:8080, выберите Local и нажмите Add. - Для
-D: Source port1080, поле Destination оставьте пустым, выберите Dynamic, Add. - Для
-R: выберите Remote. - Вернитесь в 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 |