Перейти к основному содержанию
Telepúrte устанавливается как самостоятельный сервис на Linux. Есть два пути: мастер в Axottle или подписанный установщик на сервере.

Что подготовить

Нужны Linux с systemd, архитектура amd64 или arm64, административный доступ и отдельный HTTPS-домен, например access.example.com. Домен должен отличаться от домена Axottle. Для автоматической настройки сертификата в мастере подготовьте A-запись на IPv4 сервера и доступные порты 80/443. Выделенная машина упрощает независимое обслуживание. Установка на сервер Axottle также поддерживается: мастер просит подтвердить совмещение. Панель, бастион и агенты — отдельные компоненты; установку панели завершает проверка входа, а готовность терминала проверяется после настройки бастиона и ноды.

Через Axottle

Для просмотра раздела нужны settings.view, для установки — settings.manage. Откройте Сервисы → Telepúrte (/new/telepurte).
1

Выберите машину

Выберите существующую ноду или Машина Axottle. IP ноды подставляется из карточки. Неверный адрес сначала исправьте в источнике.
2

Настройте домен и DNS

Введите домен без протокола и пути. Создайте A-запись вручную либо через подключённую зону Cloudflare. Нажмите Проверить DNS сейчас и дождитесь совпадения адреса. Для машины Axottle используйте реальный IPv4 сервера, а не адрес прокси перед панелью.
3

Подготовьте SSH

Для ноды используются сохранённые реквизиты с root или sudo без пароля. Для машины Axottle мастер отдельно запрашивает порт, пользователя, пароль или ключ и способ sudo. Разовые реквизиты этой установки не сохраняются.
4

Создайте владельца

Задайте отдельный локальный логин Telepúrte и пароль не короче 15 символов. Логин — 3–64 символа, начинается с латинской буквы; допустимы латинские буквы, цифры, точка, дефис и подчёркивание. Сохраните этот независимый от SSO вход.
5

Проверьте и установите

Сверьте машину, домен и доступный стабильный релиз, затем запустите установку. При недоступном релизе устраните показанную причину и обновите проверку.
Axottle проверяет подписанный релиз, устанавливает сервис, создаёт владельца, настраивает HTTPS и связь панелей, затем проверяет готовность и приём инвентаря. Поддерживаются системные Caddy/Nginx и управляемые контейнеры прокси Axottle. Конфликт чужого маршрута останавливает установку; применение прокси может кратко прервать соединения. Журнал установки показывает этап и причину ошибки, доступен для копирования и скачивания и сохраняется после перезапуска Axottle. Закрытие страницы не означает отмену серверной операции.

Самостоятельная установка

Возьмите install.sh и комплект одной версии из официальных релизов Telepúrte. Используйте доверенный установщик: проверка архива не защищает от подмены самого скрипта вместе с ключом проверки. В примере замените vX.Y.Z на выбранную опубликованную версию; каталог комплекта должен содержать её архив и подписанный манифест.
Установщик проверяет поставку, создаёт сервисного пользователя, конфигурацию, идентичность и базу, устанавливает systemd-службы. При самостоятельной установке владельца создают отдельно. Подготовьте файл с новым паролем, доступный только администратору, и передайте его через stdin:
Команду выполняйте из административной оболочки, которая может прочитать защищённый файл. Не передавайте пароль аргументом командной строки. После создания владельца удалите временный файл пароля установленным у вас способом. Укажите в /etc/telepurte/config.json отдельный origin:
Это фрагмент существующей конфигурации, а не полный файл. Настройте HTTPS через reverse proxy перед 127.0.0.1:8097 с сохранением исходного Host либо через TLS-настройки сервиса. Для внешнего listener требуются абсолютные пути tls_cert и tls_key. Без public_url веб-вход не открывается.
При первом входе настройте MFA и сохраните резервные коды. Затем подключите бастион и первую ноду.

Данные установки

Сохраняйте согласованную резервную копию, конфигурацию и master key. Ключ не входит в обычный комплект бэкапа. Не создавайте новую идентичность поверх существующей установки ради исправления входа.

Ошибка и повтор

Перед повтором выясните, какие этапы уже выполнены. Частично установленный сервис и существующий владелец не должны незаметно заменяться новой установкой.

Проверка

Проверьте HTTPS, локальный вход, MFA и настройки установки. Для мастера Axottle дождитесь успешного завершения и свежей синхронизации. Затем отдельно проверьте SSH и файловую операцию на тестовой ноде.

Откат

При сбое сохраните журнал, конфигурацию и существующие данные. Для обновления подписанный установщик сохраняет исходный каталог и возвращает его при ошибке. Не восстанавливайте старый бинарник поверх новой схемы БД вручную. Возврат всей установки выполняйте из проверенного бэкапа; DNS и настройки внешнего прокси проверяются отдельно. Старые сборки панели, бастионов и агентов могут не содержать описанных возможностей.