basforge

Ищем по названиям, тексту и разборам «Если не работает».

    EN
    МануалLinuxSSH

    Туннели SSH: закрытая админка через localhost

    Панель, база или дашборд слушают только 127.0.0.1 сервера и наружу не опубликованы. ssh -L открывает их на своём компьютере как http://127.0.0.1:8080 — по уже открытому порту SSH, без пароля на панели снаружи и без новых правил фаервола.

    Как устроен туннель

    компьютер                         сервер 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 — уйти в фон после входа.

    Открываем закрытую админку

    1. Проверяем, что сервис слушает только 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»).

    2. Открываем туннель

      ssh -N -L 8080:127.0.0.1:8080 web1

      Окно ничего не пишет и не возвращает приглашение — так и должно быть, туннель живёт, пока работает команда. Открываем в браузере http://127.0.0.1:8080. Закрыть — Ctrl+C.

    3. Записываем туннель в ~/.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.

    4. Если туннель нужен постоянно

      Туннель с компьютера достаточно открывать на время работы. Постоянный туннель между серверами держим юнитом 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 "закрыт"
    # закрыт