> ## 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.

# Установка Telepúrte

> Самостоятельная установка и мастер Axottle: требования, HTTPS, первый владелец, проверка и восстановление после ошибки.

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](https://github.com/Axottle/telepurte-releases/releases). Используйте доверенный установщик: проверка архива не защищает от подмены самого скрипта вместе с ключом проверки.

В примере замените `vX.Y.Z` на выбранную опубликованную версию; каталог комплекта должен содержать её архив и подписанный манифест.

```bash theme={null}
telepurte_version='vX.Y.Z'
bash install.sh --version "$telepurte_version" --bundle "./$telepurte_version" --dry-run
sudo bash install.sh --version "$telepurte_version" --bundle "./$telepurte_version"
```

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

```bash theme={null}
sudo -u telepurte telepurte owner create --login owner \
  --config /etc/telepurte/config.json < /secure/owner-password.txt
```

Команду выполняйте из административной оболочки, которая может прочитать защищённый файл. Не передавайте пароль аргументом командной строки. После создания владельца удалите временный файл пароля установленным у вас способом.

Укажите в `/etc/telepurte/config.json` отдельный origin:

```json theme={null}
"public_url": "https://access.example.com"
```

Это фрагмент существующей конфигурации, а не полный файл. Настройте HTTPS через reverse proxy перед `127.0.0.1:8097` с сохранением исходного Host либо через TLS-настройки сервиса. Для внешнего listener требуются абсолютные пути `tls_cert` и `tls_key`. Без `public_url` веб-вход не открывается.

```bash theme={null}
sudo -u telepurte telepurte check --config /etc/telepurte/config.json
sudo systemctl restart telepurte
sudo systemctl status telepurte --no-pager
```

При первом входе настройте MFA и сохраните резервные коды. Затем подключите [бастион](https://docs.axottle.com/ru/telepurte/gateways.md) и [первую ноду](https://docs.axottle.com/ru/telepurte/quickstart.md).

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

| Путь | Назначение |
| - | - |
| `/etc/telepurte/config.json` | Конфигурация |
| `/etc/telepurte/master.key` | Ключ для расшифровки данных установки |
| `/var/lib/telepurte/state.enc` | Идентичность установки |
| `/var/lib/telepurte/telepurte.db` | Пользователи, права, задания и история |

Сохраняйте согласованную [резервную копию](https://docs.axottle.com/ru/telepurte/backups.md), конфигурацию и master key. Ключ не входит в обычный комплект бэкапа. Не создавайте новую идентичность поверх существующей установки ради исправления входа.

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

| Симптом | Действие |
| - | - |
| DNS указывает не туда | Исправьте A-запись и повторите проверку |
| SSH/sudo отклонён | Проверьте вход и административные права |
| Релиз не скачивается или подпись неверна | Проверьте источник и доступность загрузки; не обходите проверку |
| Конфликт прокси или порта | Разберите занятый маршрут и журнал; сохраните чужую конфигурацию |
| Панель открывается, терминал нет | Проверьте бастион, подготовку ноды и доступ пользователя |

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

## Проверка

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

## Откат

При сбое сохраните журнал, конфигурацию и существующие данные. Для обновления подписанный установщик сохраняет исходный каталог и возвращает его при ошибке. Не восстанавливайте старый бинарник поверх новой схемы БД вручную. Возврат всей установки выполняйте из [проверенного бэкапа](https://docs.axottle.com/ru/telepurte/backups.md); DNS и настройки внешнего прокси проверяются отдельно.

Старые сборки панели, бастионов и агентов могут не содержать описанных возможностей.


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