ArtiRoute

Развёртывание on-prem ​

← Администрирование

ArtiRoute — self-hosted продукт. Это не облачный сервис: приложение, база данных, файлы артефактов и подключённые сервисы (OnlyOffice, модели ИИ) работают на инфраструктуре вашей организации. Данные не уходят на чужие серверы, если вы сами не настроите внешние интеграции.

Установка и обновление версии выполняются через пакет @artiroute/cli — единый инструмент для администратора сервера.

Что делает CLI ​

КомандаНазначение
artiroute installАктивация лицензии, проверка PostgreSQL, загрузка runtime-пакетов, запись конфигурации
artiroute startЗапуск backend и AI-сервиса
artiroute stopОстановка сервисов
artiroute statusВерсия, порты, состояние процессов
artiroute update-checkПроверить, есть ли обновление
artiroute updateУстановить новую версию из реестра лицензии
artiroute homeПоказать каталог установки (по умолчанию ~/.artiroute)

После artiroute update перезапустите сервисы: artiroute stop, затем artiroute start.

Требования к серверу ​

Обязательно ​

КомпонентВерсия / примечание
Node.js20.x или новее (на сервере, где запускается CLI)
PostgreSQL14+, рекомендуется 16
Место на дискеСистемный том + отдельный запас под файлы артефактов (см. ниже)
Лицензионный ключВыдаётся поставщиком; без него установка runtime не завершится

По возможностям организации ​

КомпонентКогда нужен
OnlyOffice Document ServerРедактирование Word/Excel в браузере (интеграция)
ffmpegТранскрибация видео в текст (расширение транскрипции) — должен быть в PATH на сервере AI
Доступ к API моделейИИ-чат и генерация (настройка ИИ) — ваш шлюз или облачный API по политике безопасности

ArtiRoute не включает PostgreSQL и OnlyOffice «внутри себя» — их поднимает ваша IT-служба (часто через Docker на том же хосте или на соседней машине).

Ориентиры по железу ​

Оценки для одного сервера, где крутятся ArtiRoute (backend + AI), PostgreSQL и OnlyOffice. Реальная нагрузка зависит от числа пользователей, объёма файлов и активности ИИ/транскрипции.

Малая команда (до ~20 активных пользователей) ​

РесурсМинимумКомфортно
CPU4 ядра6–8 ядер
RAM8 ГБ16 ГБ
Диск (ОС + БД)50 ГБ SSD100 ГБ SSD
Файлы артефактов100 ГБ250 ГБ и выше по политике хранения

OnlyOffice Document Server один потребляет порядка 2–4 ГБ RAM; при нехватке памяти редакторы будут тормозить или падать.

Средняя нагрузка (20–100 пользователей) ​

РесурсРекомендация
CPU8+ ядер
RAM16–32 ГБ
Диск БД100–200 ГБ SSD, мониторинг роста
Файлы500 ГБ+, желательно отдельный том или NAS

На этом масштабе имеет смысл разнести PostgreSQL и OnlyOffice на отдельные VM или вынести файловое хранилище на сетевой диск.

Что куда растёт ​

ЧтоГде хранится
Метаданные, пользователи, версииPostgreSQL
Загруженные файлы, вложения, экспортыКаталог данных ArtiRoute (ARTIROUTE_HOME, по умолчанию ~/.artiroute/data) — закладывайте рост и бэкапы
Индекс для поиска (RAG)БД + рабочие файлы на диске сервера
OnlyOfficeСвои тома контейнера / кэш документов

Планируйте резервное копирование: снимок PostgreSQL + копия каталога данных ArtiRoute.

Порядок установки ​

1. Подготовить зависимости ​

PostgreSQL и при необходимости OnlyOffice можно поднять из готового compose-файла в документации:

bash
mkdir -p ~/artiroute-deps && cd ~/artiroute-deps
# скачайте три файла из ссылок выше в эту папку
cp dependencies.env.example .env
# задайте POSTGRES_PASSWORD в .env
docker compose -f docker-compose.dependencies.yml up -d

Проверка: docker compose -f docker-compose.dependencies.yml ps — сервисы healthy / running.

Если PostgreSQL уже есть в организации — создайте пустую базу и пользователя с правами на неё; compose не обязателен.

2. Установить CLI ​

На сервере приложения (Linux или Windows Server с Node 20+):

bash
npm install -g @artiroute/cli

Проверка: artiroute --version.

3. Установить ArtiRoute ​

Интерактивно (CLI спросит PostgreSQL, порты и ключ лицензии):

bash
artiroute install

Или с параметрами для скрипта/automation:

bash
artiroute install --yes \
  --key "ВАШ-ЛИЦЕНЗИОННЫЙ-КЛЮЧ" \
  --pg-host 127.0.0.1 \
  --pg-port 5432 \
  --pg-db artiroute \
  --pg-user postgres \
  --pg-password "ваш-пароль" \
  --backend-port 8080 \
  --ai-port 9090

По умолчанию backend слушает 8080, AI-сервис — 9090 (если не меняли при установке).

4. Запустить сервисы ​

bash
artiroute start

Процесс остаётся на переднем плане; логи также пишутся в каталог run внутри ARTIROUTE_HOME. Для продакшена обычно настраивают systemd, Windows Service или process manager — по политике вашей IT.

5. Первый вход в интерфейс ​

Откройте в браузере адрес backend (например http://сервер:8080) и пройдите мастер первичной настройки: лицензия (если ещё не привязана в UI), компания, первый администратор.

6. OnlyOffice (если нужен) ​

  1. Убедитесь, что Document Server доступен (при compose из примера — http://127.0.0.1:8000 с сервера ArtiRoute).
  2. Включите расширение OnlyOffice и укажите URL сервера в Настройки — см. Интеграции.

Сервер OnlyOffice должен «видеть» ArtiRoute по сети и наоборот — часто требуется настройка reverse proxy и externalHost; согласуйте с IT.

7. ffmpeg (если нужна транскрипция) ​

Установите ffmpeg на том же хосте, где работает AI-сервис, и убедитесь, что команда ffmpeg доступна в PATH. После установки перезапустите artiroute start.

Обновление версии ​

bash
artiroute update-check    # что доступно
artiroute update          # скачать и установить
artiroute stop
artiroute start

Миграции схемы БД применяются при старте backend автоматически.

Переменные окружения (кратко) ​

ПеременнаяЗачем
ARTIROUTE_HOMEКаталог установки (конфиг, пакеты, данные). По умолчанию ~/.artiroute
ARTIROUTE_LICENSE_SERVER_URLАдрес сервера лицензий (если не зашит в сборку CLI)
SESSION_SECRETСекрет сессий (можно задать до install)
BACKEND_SERVICE_TOKEN / GRAPHQL_API_KEYСлужебный ключ между сервисами

Основные параметры после установки лежат в config.env внутри ARTIROUTE_HOME.

Что дальше ​

  1. Первичная настройка в веб-интерфейсе.
  2. Пользователи.
  3. Настройка ИИ.
  4. Интеграции — OnlyOffice, корпоративный вход.

Связанные материалы ​

AI workspace для командных материалов и знаний

© 2025 Zebrains