Как устроен туннель
компьютер сервер web1
браузер sshd
│ http://127.0.0.1:8080 │
└─→ ssh слушает 127.0.0.1:8080 │
└──── соединение SSH, :22 ──┴─→ 127.0.0.1:8080 → панель
ssh -L 8080:127.0.0.1:8080 web1 читается так: «слушай порт 8080 у меня, а всё, что туда придёт, отправь
через сервер на 127.0.0.1:8080 — как его видит сервер». Адрес справа разрешается на сервере: 127.0.0.1
там — сам сервер, а не компьютер.
Снаружи у панели порта нет вовсе. Сканер видит один открытый порт — SSH, а туда без ключа не войти.
Какой туннель когда
| Флаг | Что делает | Когда берём |
|---|---|---|
-L 8080:127.0.0.1:8080 |
порт на компьютере ведёт к адресу, видимому с сервера | админка, база, дашборд, закрытые наружу |
-R 9000:127.0.0.1:3000 |
порт на сервере ведёт к адресу, видимому с компьютера | показать с сервера то, что запущено на ноутбуке; принять вебхук на время отладки |
-D 1080 |
SOCKS-прокси на компьютере, запросы выходят с сервера | несколько внутренних адресов сервера сразу, без отдельного -L на каждый |
-J web1 |
вход на следующий сервер через этот | сервер без внешнего адреса («~/.ssh/config») |
-N — не открывать консоль, только туннель. -f — уйти в фон после входа.
Открываем закрытую админку
Проверяем, что сервис слушает только localhost
На сервере:
ss -tlnp | grep 8080 # LISTEN 0 4096 127.0.0.1:8080 0.0.0.0:* users:(("docker-proxy",pid=1734,fd=7))127.0.0.1:8080— порт виден только самому серверу.0.0.0.0:8080или*:8080— открыт наружу, туннель не нужен, а нужно закрыть порт («Порт только для хоста — на 127.0.0.1», «Порты Docker идут мимо цепочки input»).Открываем туннель
ssh -N -L 8080:127.0.0.1:8080 web1Окно ничего не пишет и не возвращает приглашение — так и должно быть, туннель живёт, пока работает команда. Открываем в браузере
http://127.0.0.1:8080. Закрыть —Ctrl+C.Записываем туннель в ~/.ssh/config
Чтобы не помнить порты, заводим отдельное имя:
Host web1-admin HostName 203.0.113.10 User example-user IdentityFile ~/.ssh/id_ed25519 IdentitiesOnly yes LocalForward 8080 127.0.0.1:8080 LocalForward 8081 127.0.0.1:8081 ExitOnForwardFailure yes SessionType noneТеперь
ssh web1-adminоткрывает оба порта сразу.ExitOnForwardFailure yes— если порт на компьютере занят,sshвыходит с ошибкой, а не висит без туннеля.SessionType none— то же, что-N, есть с OpenSSH 8.7.Если туннель нужен постоянно
Туннель с компьютера достаточно открывать на время работы. Постоянный туннель между серверами держим юнитом systemd, а не
ssh -fв cron: юнит перезапускает упавшее соединение.# /etc/systemd/system/tunnel-db.service [Unit] Description=SSH-туннель к базе на db-internal After=network-online.target Wants=network-online.target [Service] User=tunnel ExecStart=/usr/bin/ssh -N -o ServerAliveInterval=30 -o ExitOnForwardFailure=yes -L 3306:127.0.0.1:3306 db-internal Restart=always RestartSec=10 [Install] WantedBy=multi-user.targetПользователь
tunnel— отдельный, имяdb-internal— из его~/.ssh/config. Ключ у него один, и на той стороне вauthorized_keysперед ключом стоитrestrict,port-forwarding,permitopen="127.0.0.1:3306"(«Ключи SSH»): консоль этим ключом не открыть.
Обратный туннель и SOCKS
-R открывает порт на сервере. По умолчанию — только на его 127.0.0.1 (GatewayPorts no в sshd):
с сервера curl http://127.0.0.1:9000 дойдёт до ноутбука, а из интернета — нет. Сделать порт доступным
снаружи можно, но тогда ноутбук отвечает всему интернету — такое делаем только через прокси с паролем.
-D 1080 поднимает на компьютере SOCKS-прокси. В браузере или в curl --socks5-hostname 127.0.0.1:1080
запросы выходят с сервера: так открываются сразу все внутренние адреса, например http://172.18.0.5:3000
в сети Docker. --socks5-hostname отдаёт серверу и разрешение имён — имена контейнеров при этом всё равно
не разрешатся, это DNS Docker, а не сервера.
Если не работает
bind [127.0.0.1]:8080: Address already in use, туннель не открылся
- Причина
- Порт 8080 на своём компьютере уже занят — часто другим туннелем или локальным сервером разработки.
- Делаем
- Берём другой локальный порт:
-L 18080:127.0.0.1:8080, и открываемhttp://127.0.0.1:18080.
Страница не открывается, в окне ssh — channel 2: open failed: connect failed: Connection refused
- Причина
- Туннель до сервера есть, но с точки зрения сервера по этому адресу никто не слушает: не тот порт, сервис лёг, или он слушает только IPv4, а
localhostна сервере превратился в::1. - Делаем
- На сервере
ss -tlnp | grep 8080— какой адрес и порт слушает сервис. В туннеле пишем адрес цифрами:127.0.0.1, а неlocalhost.
channel 2: open failed: administratively prohibited: open failed
- Причина
- На сервере
AllowTcpForwarding no. - Делаем
- Возвращаем
AllowTcpForwarding yesвsshd_config.d(«sshd_config») или открываем туннели только своему пользователю черезMatch User example-user.
Туннель в фоне через час перестал отвечать
- Причина
- Соединение умерло, а процесс
sshоб этом не узнал. - Делаем
ServerAliveInterval 30иExitOnForwardFailure yes; для постоянного туннеля — юнит systemd сRestart=alwaysилиautossh.
Контейнер без опубликованного порта, туннель на 127.0.0.1:8080 не доходит
- Причина
- Порт контейнера не опубликован на хосте, и
127.0.0.1сервера до него не ведёт. - Делаем
- Публикуем на localhost:
ports: - "127.0.0.1:8080:8080"(«Порт только для хоста — на 127.0.0.1»). Или ведём туннель на адрес контейнера в сети Docker — он меняется при пересоздании.
Как проверить
Туннель слушает только свой компьютер, а не всю домашнюю сеть:
netstat -an | grep 8080
# TCP 127.0.0.1:8080 0.0.0.0:0 LISTENING
Панель отвечает через туннель:
curl -sI http://127.0.0.1:8080 | head -1
# HTTP/1.1 200 OK
И не отвечает снаружи — с телефона по мобильному интернету или с компьютера без туннеля:
curl -m 5 -s http://203.0.113.10:8080 || echo "закрыт"
# закрыт