Проброс портов

В этой статье описана функция панели «Проброс портов» — порт приложения на туннелируемом сервере без публичного IP маппится на публичный порт сервера панели, чтобы внешние пользователи могли получить к нему доступ.

В двух словах

Ваш сервер спрятан во внутренней сети (без публичного IP), на нём работает сайт или приложение, а снаружи к нему не достучаться. Проброс портов — это «открыть на сервере панели публичный порт и перенести внешние обращения через шифрованный туннель на порт приложения этой внутренней машины». Результат: обращение внешнего пользователя к IP-сервера-панели:порт равнозначно обращению к приложению на вашем внутреннем сервере.

Что делает эта функция

У сервера без публичного IP, подключённого через «Туннельное управление», его приложения (например, музыкальный Navidrome, облако Nextcloud, заметки Memos) недоступны извне. Проброс портов маппит порты этих приложений на порты сервера панели (с публичным IP), чтобы внешние пользователи обращались по «IP сервера панели:порт».

Когда пригодится

• На туннелируемом сервере работает веб-приложение, и нужен внешний доступ
• Открыть сервис внутреннего устройства в публичную сеть
• Дать публичную точку входа сайту, API или панели на устройстве без публичного IP

Принцип работы (как движутся данные)

Внешний пользователь → публичный порт сервера панели (напр. :9117) → шифрованный туннель → порт приложения туннелируемого сервера (напр. :9117)

Внешний трафик сначала приходит на сервер панели (единственное место с публичным IP), затем по шифрованному обратному туннелю доставляется на внутреннее устройство и наконец попадает на реально работающий на устройстве порт приложения.

Единый канал (для всех устройств, выбирать вручную не нужно):

Панель для всех использует обратный туннель на 4433: при создании проброса не нужно думать о нижележащем канале и не нужно выбирать его вручную.

> Дополнение: управление системой на Android-устройствах / Termux (выполнение команд, терминал, файлы) идёт по стабильному каналу SocketIO; но проброс портов для всех использует обратный туннель на 4433 — каждый занимается своим делом, и они не мешают друг другу.

Как пользоваться

1. Убедитесь, что целевое устройство уже подключено через «Туннельное управление» (Agent онлайн)

2. Откройте «Проброс портов» и нажмите «Добавить проброс»

3. Выберите туннелируемый сервер (Agent) и заполните:

• Порт прослушивания: публичный порт сервера панели (для внешнего доступа), например 9117
• Целевой порт: порт приложения на туннелируемом сервере, например 8080

4. После создания внешние пользователи могут обращаться по http://IP-сервера-панели:порт-прослушивания

Пример

Пусть публичный IP сервера панели — 203.0.113.10, а на внутреннем Raspberry Pi работает Navidrome (слушает 4533):

• Порт прослушивания: 4533
• Целевой порт: 4533
• После создания внешний пользователь открывает http://203.0.113.10:4533 и видит Navidrome на Raspberry Pi

Лимиты ресурсов

При превышении новые подключения автоматически отклоняются, работающие пробросы это не затрагивает.

Важные замечания

1. Облачный брандмауэр: облачный брандмауэр / группа безопасности сервера панели должны разрешить соответствующий порт прослушивания, иначе извне доступа не будет.

2. Версия Agent: для перенаправления не-SSH портов (не 22) на туннелируемом сервере должен быть установлен новый Agent (старая версия поддерживает перенаправление только порта 22). Чтобы перенаправлять другие порты, переустановите Agent.

3. Agent онлайн: проброс зависит от того, что Agent остаётся онлайн. Когда Agent офлайн, проброс прерывается и автоматически восстанавливается после переподключения.

4. Автовосстановление при перезапуске панели: после перезапуска сервиса панели проброс восстанавливается автоматически (срабатывает при переподключении Agent).

5. Целевой сервис на Android должен поддерживать параллелизм: если туннелируемый целевой сервис на Android (например, python3 -m http.server) однопоточный и использует keep-alive, незакрытое соединение будет блокировать последующие запросы. Рекомендуется использовать многопоточный целевой сервис или следить за своевременным закрытием соединений.

Связанные документы

• Туннельное управление — сначала подключите устройство без публичного IP к панели
• Перенаправление портов — классическое перенаправление портов на сервере с публичным IP (разница между ними — ниже)

Проброс портов vs перенаправление портов (что выбрать)

Одной строкой: нет публичного IP — используйте проброс, есть публичный IP — используйте перенаправление.