> ## Documentation Index
> Fetch the complete documentation index at: https://docs.axottle.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Бастионы и маршруты SSH

> Бастион доступа и транзитный бастион, установка, Web/SSH-вход, прямой маршрут и туннель через агент.

Бастион — точка, через которую 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](https://docs.axottle.com/ru/telepurte/terminal.md).

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

Проверьте лимиты одновременных подключений. Достижение лимита запрещает новый вход, даже если сеть и пароль исправны.

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

В карточке ноды → **Подключение** выбирается транспорт:

| Транспорт | Требование | Когда подходит |
| - | - | - |
| Прямой SSH | Достижимый адрес и порт sshd ноды | Есть маршрут из инфраструктуры Telepúrte к серверу |
| Туннель через агент | Online-агент, разрешённый туннель и доступный ему локальный sshd | Нода не принимает входящие 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-клиентом, если он включён. После смены маршрута повторите соединение и убедитесь, что оно использует ожидаемую ноду и системного пользователя.

## Откат

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

Требуются совместимые версии панели и бастиона; агентный туннель дополнительно зависит от агента.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.