Главная страница
База знаний по самостоятельному развёртыванию 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;
- обратный прокси Traefik или Nginx с HTTPS;
- стек мониторинга Prometheus + Loki + Grafana;
- процедуры обновления dzyam.chat и MongoDB, бэкап и переменные окружения.
Репозиторий конфигурации: dzyam.chat.
Запуск dzyam.chat в нескольких экземплярах
Схема высокой доступности: общая MongoDB и NATS, два и более экземпляра dzyam.chat, Traefik как балансировщик, обновление без простоя.
Правило вертикального масштаба.
На одном многоядерном хосте обычно запускают N−1 экземпляров, где N — число ядер CPU.
Что важно не забыть
- MongoDB всегда как набор реплик из трёх узлов. Эквивалент Atlas на стартовых уровнях — M30.
- Файлы в продакшене держите в объектном хранилище: S3, GCS или MinIO. GridFS для рабочей нагрузки не подходит.
- Версию в
.envфиксируйте явно (RELEASE=8.8.0), не используйтеlatest. - Сеть снаружи:
443/tcp(HTTPS) и80/tcp(редирект на 443). До базы на отдельном хосте нужен27017. - Мониторинг. Пароль Grafana из
.envприменяется только при первом создании контейнера.
Карта раздела
| Страница | Зачем открывать |
|---|---|
| Главная | Эта страница |
| Планирование развёртывания | Навигация по блоку планирования |
| Системные требования | Железо, ПО, порты, хранилище |
| Референсная архитектура | Выбор топологии по числу пользователей |
| Проверка поддерживаемых версий Node.js и MongoDB | Совместимость релиза |
| Развёртывание с Docker и Docker Compose | Установка, HTTPS, обновления, бэкап |
| Запуск dzyam.chat в нескольких экземплярах | Кластер и высокая доступность |