Документация

Главная страница

База знаний по самостоятельному развёртыванию dzyam.chat — планирование, системные требования, Docker Compose и высокая доступность.

Самостоятельное развёртывание, планирование архитектуры и эксплуатация рабочего пространства.

Этот вики-раздел собирает руководства по self-managed установке dzyam.chat. Материалы опираются на официальную документацию и описывают путь от выбора железа до рабочего кластера с HTTPS, мониторингом и несколькими экземплярами.

Ориентир версии.

Актуальные требования в этих статьях приведены для линейки dzyam.chat 8.8 (сентябрь 2026). Перед обновлением сверяйте Node.js и MongoDB с конкретным релизом.

С чего начать

Идите по шагам сверху вниз. Так меньше шансов выбрать слишком слабое железо или несовместимую MongoDB.

Шаг Что сделать Статья
1 Оценить размер рабочего пространства и выбрать архитектуру Референсная архитектура
2 Подобрать CPU, память, диски, порты и хранилище файлов Системные требования
3 Проверить Node.js, Deno и MongoDB для целевого релиза Проверка поддерживаемых версий Node.js и MongoDB
4 Поднять рабочее пространство в Docker Compose Развёртывание с Docker и Docker Compose
5 При нагрузке от 500 пользователей — вынести экземпляры за балансировщик Запуск dzyam.chat в нескольких экземплярах
flowchart LR
  A[Планирование] --> B[Системные требования]
  B --> C[Версии Node.js и MongoDB]
  C --> D[Docker Compose]
  D --> E{Одновременных<br/>пользователей?}
  E -->|до 500| F[Один экземпляр]
  E -->|500+| G[Несколько экземпляров<br/>+ Traefik]
  E -->|5000+| H[Микросервисы<br/>в Kubernetes]

Планирование

Прежде чем ставить контейнеры, зафиксируйте модель нагрузки и совместимые версии.

Планирование развёртывания

Оглавление раздела: требования, архитектуры и проверка зависимостей в одном месте.

Системные требования

Минимальное железо и ПО для сценариев Starter и премиальных планов, рекомендации по MongoDB replica set, объектному хранилищу и внешним портам 80 / 443.

Кратко по оборудованию:

Сценарий dzyam.chat MongoDB
До 500 пользователей, без HA 2 vCPU / 4 ГиБ / 20 ГиБ диск 2 vCPU / 4 ГиБ / 10 ГиБ, 3 реплики
500+ пользователей, HA 4 vCPU / 8–12 ГиБ / 20 ГиБ диск 2 vCPU / 8–16 ГиБ / 20–80 ГиБ, 3 реплики
Свыше 5000, микросервисы 16 vCPU / 12 ГиБ / 40 ГБ диск 4 vCPU / 16 ГиБ / 80 ГБ на реплику

Референсная архитектура

Три уровня: один экземпляр на Docker Compose или Podman, несколько экземпляров за Traefik, микросервисы в Kubernetes. Есть схемы и правило, когда пора масштабироваться (процесс Node.js упирается в 100% CPU при низкой загрузке хоста).

Проверка поддерживаемых версий Node.js и MongoDB

Для линейки 8.x нужна MongoDB 8.0+.

Установка и масштабирование

Предупреждение

Перед развёртыванием dzyam.chat через Docker необходимо выполнить вход в реестр образов. Без авторизации Docker не сможет скачать образ приложения, и контейнеры не запустятся.

Команду для входа в реестр и логин / пароль можно получить на клиентском портале в разделе Документация после создания клиентского аккаунта.

Когда требования согласованы, переходите к стенду и, при необходимости, к кластеру.

Развёртывание с Docker и Docker Compose

Рекомендуемый способ для большинства инсталляций. На выходе:

Репозиторий конфигурации: dzyam.chat.

Запуск dzyam.chat в нескольких экземплярах

Схема высокой доступности: общая MongoDB и NATS, два и более экземпляра dzyam.chat, Traefik как балансировщик, обновление без простоя.

Правило вертикального масштаба.

На одном многоядерном хосте обычно запускают N−1 экземпляров, где N — число ядер CPU.

Что важно не забыть

Карта раздела

Страница Зачем открывать
Главная Эта страница
Планирование развёртывания Навигация по блоку планирования
Системные требования Железо, ПО, порты, хранилище
Референсная архитектура Выбор топологии по числу пользователей
Проверка поддерживаемых версий Node.js и MongoDB Совместимость релиза
Развёртывание с Docker и Docker Compose Установка, HTTPS, обновления, бэкап
Запуск dzyam.chat в нескольких экземплярах Кластер и высокая доступность