Перейти к основному содержанию
Бастион — точка, через которую Telepúrte обслуживает SSH и файловые подключения. Пользователь не получает административный shell самого бастиона: после проверки прав его соединяют с выбранной нодой и записывают сессию.

Выбор роли

Бастион доступа предоставляет вход пользователям, в том числе меню разрешённых нод на базовом SSH-порту. Транзитный бастион используется для закреплённых за ним маршрутов к нодам; общего меню на базовом порту у него нет. Оба варианта требуют работающей связи с панелью и подходящей сетевой достижимости. Размещение нескольких бастионов помогает организовать разные точки входа и маршруты, но не выдаёт пользователям новые гранты.

Установка через панель

В Бастионы выберите создание, роль и ноду размещения. Укажите нужные параметры входа и пройдите проверку мастера. Для автоматической установки используется транспорт выбранной ноды: прямой SSH либо туннель агента. На подготовленной ноде установка может использовать краткоживущий сертификат root. Это не отменяет политику sshd: если root-вход запрещён, соединение будет отклонено. Если мастер предлагает разовый пароль или ключ root и вы его выбираете, используется именно этот способ. Ключ сервера проверяется в обоих случаях. После установки проверьте зарегистрированный бастион, состояние служб и доступность нужных listener. Если регистрация прошла, а запуск службы нет, откройте частично созданный бастион и устраните причину. Не создавайте повторную регистрацию вслепую.

SSH и Web — отдельные входы

Для браузерного терминала и Web SFTP требуется Web-вход по HTTPS с рабочим маршрутом WebSocket и файловых операций. Для обычного SSH-клиента нужен доступный SSH-listener и правило firewall на выбранный порт. При ручной установке SSH-служба по умолчанию слушает loopback 127.0.0.1:2222. Для внешнего входа администратор явно задаёт адрес, например через SSH_LISTEN в /etc/telepurte-gateway/ssh.env, и настраивает сеть. Номер 2222 — пример стандартной настройки, фактический адрес берите из вашей установки. У ноды также может быть выделенный SSH-порт маршрута. Он сразу выбирает сервер, но не отменяет аутентификацию, грант и запись. Открывайте во внешней сети только необходимые порты маршрутов.

Политика входа

Настройте разрешённые методы: подтверждение в браузере, пароль шлюза, ключи и требование MFA. Подробности пользовательского входа — в руководстве SSH. При браузерном подтверждении человек проверяет попытку на странице Telepúrte. Пароль шлюза локальной учётки задаётся отдельно от основного пароля панели. Импортированные пользователи Axottle входят через SSO или клиентский сертификат. Гостевой SSH-пароль связан только с временным грантом. Проверьте лимиты одновременных подключений. Достижение лимита запрещает новый вход, даже если сеть и пароль исправны.

Прямой SSH и туннель агента

В карточке ноды → Подключение выбирается транспорт: Для отдельного Telepúrte Agent туннель включается в существующей конфигурации полями ssh_tunnel_enabled и ssh_tunnel_port. Порт должен соответствовать sshd; агент подключается к локальному адресу. После изменения перезапустите агент и дождитесь обновления состояния, затем переключите транспорт ноды и проверьте соединение. При отказе агентного туннеля Telepúrte не переключается незаметно на прямой адрес. Изменение транспорта — явная операция, после неё выполняется новая проверка. Для импортированных нод используйте настройки совместимого Axottle Agent, не создавая рядом второй агент без необходимости.

Диагностика

Если SSH-клиент не соединяется совсем, сначала проверьте listener, адрес и firewall. Если соединение есть, но нет нод, проверьте права и источник пользователя. Если нода выбрана, но вход завершается ошибкой, проверьте маршрут, host key, системный логин и политику sshd. Для Web SSH отдельно проверьте HTTPS и WebSocket на reverse proxy.

Проверка

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

Откат

Отключите ненужную точку входа или верните прежний маршрут и проверьте доступность. Не удаляйте единственный рабочий бастион, пока не проверен альтернативный путь. Отключение закрывает новые входы; уже выполняемые подключения могут завершиться при очередной проверке состояния. Требуются совместимые версии панели и бастиона; агентный туннель дополнительно зависит от агента.