Skip to content

Server ru

Alex Miarsky edited this page Nov 10, 2026 · 2 revisions

Самостоятельный серверный комплект PostgreSQL / Apache

Комплект содержит версионированные Linux-образы TACTIC Stream, Apache/Webmin и PostgreSQL 18.6, Compose, управление, лицензии и контрольные суммы SHA-256. Сервер использует установленный Python-пакет и собранный Vue. Исходники, Node.js и Python-зависимости приложения на хосте не нужны. На хосте требуются Docker Compose и Python 3.10+. Архитектура образов соответствует машине сборки.

Сборка из исходников

Из каталога tactic_stream при запущенном Docker:

.venv/Scripts/python.exe -B -m tools.server_delivery --output ../releases/server-clean

Каталог назначения не должен существовать. Все три образа входят в images.tar. Сохранённые пароли, тикеты, БД, repository и том зависимостей разработчика не копируются. manifest.json содержит версию, идентификаторы образов и контрольные суммы. Успешная сборка сама по себе не означает производственную приёмку.

Новая установка

Перенесите весь комплект на целевую машину и выполните из его каталога:

python manage.py load
python manage.py init
python manage.py check

load проверяет контрольные суммы всех файлов перед загрузкой образов. init создаёт отдельные секреты PostgreSQL и Webmin в .local, дожидается PostgreSQL, готовит новый конфиг и дважды запрашивает пароль администратора TACTIC штатной CLI-командой. Пароля по умолчанию нет. Существующие SQLite-данные и конфигурация не преобразуются. PostgreSQL-конфиг сохраняется; штатная инициализация откажется заменять уже созданную БД.

Проект Compose по умолчанию — tactic-stream-server. Для отдельного экземпляра используйте отдельный каталог комплекта со своими секретами, одинаковый --project-name ИМЯ во всех командах и свободные STREAM_HTTP_PORT / STREAM_WEBMIN_PORT. Переменные портов задаются перед запуском.

  • Приложение: http://127.0.0.1:8082/.
  • Webmin: https://127.0.0.1:10000/, пользователь root, пароль в .local/webmin-password.
  • Порты PostgreSQL и backend наружу не публикуются.
  • Данные, repository, конфиг и журналы находятся в томе stream_data; PostgreSQL, конфигурация Apache и Webmin имеют отдельные тома.

Команды status, logs, up, stop выполняются через manage.py. Остановка сохраняет тома. Храните .local в защищённых резервных копиях: секреты необходимы для доступа к существующим данным. При наличии тома утраченный секрет не генерируется заново. check проверяет сертификат Webmin, вход/выход, маршруты Apache, ресурсы интерфейса, воркеры и транзакции PostgreSQL.

Начиная с 0.112.424, журналы API не записывают токены сессий. Защищайте журналы воркеров и их выгрузки от прежних версий как данные с учётными секретами. Если такие журналы стали доступны посторонним, отзовите затронутые активные сессии.

На Linux управление закрывает доступ к .local для других пользователей (0700), а файлы секретов делает читаемыми для приложения без root внутри контейнера (0644). Защиту на хосте обеспечивает закрытый родительский каталог; сохраняйте её при копировании секретов. Файловые secrets Compose сохраняют права файла хоста; см. контракт Docker.

Обновление установленного комплекта

Сначала сохраните резервную копию БД, repository, конфигурации и секретов .local. Оставьте предыдущий комплект. Новый распакуйте отдельно, безопасно скопируйте туда существующий .local, сохраните прежнее имя проекта Compose и настройки портов. Выполните load, update, check из нового каталога. update останавливает backend, запускает штатное обновление схем и пересоздаёт сервисы из загруженных образов с прежними томами. При ошибке миграции backend остаётся остановленным. Если схема необратимо изменилась, для возврата нужна резервная копия БД; запуск прежнего образа не откатывает схему.

Предварительная сборка поддерживает новую установку PostgreSQL и штатные обновления. Перенос legacy-проекта нужно проверять на конкретном исходном проекте. См. порядок восстановления; проверки каждой сборки перечислены в её релизе. Смена значения vendor не переносит SQLite-данные в PostgreSQL. Для внешнего доступа настройте TLS и доверенные proxy headers под целевое окружение.

Демо-версия

Добавьте --demo к команде сборки или скачайте пакет Demo из Releases. Выполните те же load, init, check. Инициализация установит отдельный демо-набор с контрольными суммами в новую базу. Существующие проекты она не заполняет. Имя Compose-проекта по умолчанию — tactic-stream-demo, HTTP-порт — 8084, Webmin — 10002. У чистой версии и демо отдельные тома и пароли служб; храните пакеты в разных каталогах. Явные STREAM_HTTP_PORT / STREAM_WEBMIN_PORT имеют приоритет.

Войдите администратором и откройте Orbit Studio или Atlas Reference Library. Сгенерированные пароли демо-пользователей можно прочитать локально:

docker compose -p tactic-stream-demo exec app cat /var/lib/tactic_stream/demo-accounts.json

Не публикуйте этот вывод: в нём пароли. В знакомстве с демо описаны записи, роли, публикации и плагины. Handler подключается к тому же адресу с отдельным входом. Для Synology есть пакет DSM.

Clone this wiki locally