Каналы связи

Канал связи — это то, через что ваш сервер выходит в интернет. По умолчанию он выходит напрямую, со своего адреса. Если адрес должен быть другим — например, чтобы поставщик не видел ваш сервер или чтобы распределить нагрузку, — заведите канал связи: свой прокси, SOCKS5, VPN или подписку Happ. В интерфейсе это отдельный раздел «HTTP-прокси» в боковом меню — рядом с разделом «Модели».

Виды канала

  • HTTP-прокси — обычный прокси-сервер, которому программа говорит «соедини меня вот с этим адресом». Самый распространённый вариант.
  • SOCKS5 — похожий по смыслу прокси, но другого, более низкого уровня. Часто предлагается там, где HTTP-прокси нет.
  • VPN (WireGuard) — весь трафик уходит через защищённое соединение с другим сервером. Самый «полный» вариант: меняется весь путь, а не только соединение с одним адресом.
  • Подписка Happ — готовый доступ, который продают для программы Happ: вместо адреса, логина и пароля — одна ссылка. Продукт забирает по ней список серверов и поднимает соединение сам. Подробнее — в разделе «Подписка Happ» ниже.
  • Напрямую — без вышестоящего канала: трафик выходит с адреса самого сервера. Нужен, когда подрядчику требуется отдельный порт с входом по ключу, а свой прокси при этом не нужен.

Что у канала в полях

  • Имя — как вы будете называть канал. Оно попадает в журнал, поэтому лучше давать понятные имена.
  • Вид — HTTP-прокси, SOCKS5, VPN, подписка Happ или «напрямую».
  • Адрес и порт — куда подключаться. У канала «напрямую» вышестоящего прокси нет, поэтому эти поля не нужны, а у подписки Happ адрес выводится из самой ссылки.
  • Логин и пароль — если прокси требует авторизацию. Пароль показывается заглушкой.
  • Порт слушателя — если задать, канал начнёт принимать прокси-соединения на этом порту. Пусто или 0 — не предоставляется. Порт уникален среди каналов.
  • Требовать аутентификацию — пускать ли на этот порт только владельцев ключа доступа.
  • Активен — выключенный канал не слушает свой порт: выключение заглушает порт, но не удаляет настройки.

Канал как прокси-служба

Любой канал можно превратить в собственную прокси-службу: задайте ему порт слушателя — и на этом порту канал начнёт принимать обычные прокси-соединения (HTTP-прокси и SOCKS5 на одном порту), пропуская трафик только через себя. Так можно выдать разным подрядчикам разные адреса: каждому — свой порт и свой канал.

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

В списке каналов видно и состояние: у канала с портом показывается сам порт и живая отметка — «Слушает — активных: N» или «Не слушает». Если порт не задан, на месте отметки стоит прочерк с подсказкой «Не предоставляется как прокси».

Как подключиться к такому порту, как включить вход по ключу и что видно в журнале — в разделе Прокси для обычного трафика.

Подписка Happ

Подписка Happ — это готовый доступ к интернету через чужой VPN, который продают для программы Happ. Вместо адреса, логина и пароля здесь одна ссылка: продукт забирает по ней список серверов и поднимает соединение сам.

В канале всего три поля. Ссылка на подписку — это и есть доступ: она показывается заглушкой, сохранение без изменений оставляет прежнюю ссылку, а вместо самой ссылки можно записать ссылку на переменную окружения вида $ИМЯ_ПЕРЕМЕННОЙ. ID устройства отправляется панели как идентификатор устройства; если оставить поле пустым, подставляется значение Happ по умолчанию. Сервер выбирается из списка, который продукт загружает по ссылке; пусто — берётся первый доступный сервер, а если выбранное имя исчезло из подписки, при каждом запуске подставляется первый доступный.

В списке серверов видно, сколько трафика уже использовано и до какой даты действует подписка. Серверы, которые продукт запустить не может (например, Hysteria), помечены как «не поддерживается» — выбрать их нельзя.

Соединение поднимает вшитое в образ ядро Xray. Оно запускается при первом обращении и гаснет само после 60 секунд простоя. Если в момент запуска подписка недоступна, берётся последняя удачная загрузка — так канал продолжает работать, пока панель молчит. В своей сборке без ядра Xray канал просто считается недоступным: остальные каналы работают как обычно.

Ссылка — это ключ доступа к подписке: кто её знает, тот пользуется вашим доступом. Держите её так же бережно, как пароль.

Через какой канал идёт трафик

Автоматического перебора каналов нет: трафик идёт через тот канал, который указан явно. Модель, привязанная к каналу на странице «Модели», ходит только через него; канал не работает — запрос не проходит, другой канал или прямое соединение не подставляются. Так сделано намеренно: привязка означает «эта модель ходит только отсюда».

Обычный трафик через порт прокси-службы тоже выходит только через свой канал. А ключ доступа с ограниченным списком каналов пользуется только разрешёнными — и никогда не идёт мимо них.

Проверка связи

Кнопка «Проверить» идёт настоящим путём этого канала и показывает результат: работает, за сколько миллисекунд, какой ответ вернул внешний сайт. Если в ответе пришёл код ошибки, это не провал канала: главное, что соединение установилось, — значит, ваш прокси работает, а «не понравился» он уже сайту. У подписки Happ проверка сначала поднимает ядро Xray (то есть заново забирает подписку), а потом идёт настоящим путём — так видно, что канал жив целиком.

Пароль показывается заглушкой

Пароль канала, как и ключ поставщика у модели, показывается заглушкой. Сохранение без изменений оставляет прежний пароль. Одна тонкость: очистить сохранённый пароль нельзя — пустое поле тоже означает «оставьте как есть». Если пароль больше не нужен, укажите другой, а прежний останется неиспользованным.

Обновление и удаление

Когда вы меняете настройки канала — адрес, логин, пароль, — уже открытые соединения переключаются на новые значения при следующем обращении. Перезапускать контейнер не нужно. У подписки Happ правка ссылки или сервера перезапускает ядро Xray при следующем обращении — вручную ничего перезапускать не нужно.

Удалить канал нельзя, пока на него ссылается хотя бы одна модель или хотя бы один ключ доступа. Иначе связь незаметно «переехала» бы на прямое соединение, а это меняет и адрес, и безопасность. Продукт назовёт, кто именно мешает, — сначала нужно снять привязку. Вместе с удалённым каналом пропадает и его порт прокси-службы — слушать его больше некому.

VPN: что нужно

VPN-канал — самый требовательный. Чтобы он работал, контейнеру нужны расширенные права на сеть и сама программа WireGuard внутри. Обычная установка этого не даёт, поэтому VPN-канал придётся включить отдельно, изменив запуск контейнера.

Соединение поднимается только тогда, когда оно действительно нужно, и гасится само после 60–75 секунд простоя — это экономит ресурсы. Если прав или WireGuard нет, канал просто считается недоступным: остальные каналы работают как обычно, ничего не ломается.

Дальше: как подключить к серверу свои программы — в разделе Подключение программ.

← Оглавление документации