Когда ваша команда разрастается до 5–10 и более человек, Telegram неизбежно превращается в хаотичный поток: задачи по бэкенду перемешаны с вопросами дизайна, обсуждение багов теряется под шутками, а критически важное сообщение легко пропустить за ночь. Корпоративные решения Slack и Microsoft Teams решают эту проблему, но требуют оплаты в валюте, давно недоступной для российского рынка. Discord лишен внятной организации по задачам. Mattermost перегружен для небольших команд.
Zulip — корпоративный мессенджер с открытым исходным кодом (более 26 000 звёзд на GitHub, актуальный стабильный релиз v12.4) и уникальной концепцией организации коммуникаций: каждое сообщение принадлежит конкретной теме (Topic) внутри потока (Stream). Это кардинально отличает его от остальных инструментов и делает незаменимым для распределённых технических команд.
1. Концепция тредовой модели и архитектура Zulip v12.4
Принципиальное отличие Zulip от Telegram, Slack и Mattermost — иерархическая трёхуровневая организация переписки:
- Серверы и Streams (Потоки): аналог каналов Slack или топиков Telegram. Поток объединяет связанные темы — например,
#backend,#devops,#general. - Topics (Темы): обязательная метка для каждого сообщения внутри потока. Благодаря ей разговор «Настройка Redis», «Баг в API v2.3» и «Релиз 1.5.0» живут в одном потоке
#backend, но никогда не смешиваются и сохраняют полный контекст в любой момент времени. - Сообщения: обычный текст с поддержкой Markdown, кода, формул LaTeX, встроенных плееров и упоминаний.
Вы можете открыть Zulip через неделю отпуска и за 10 минут просмотреть только нужные темы — без пролистывания сотен несвязанных сообщений.
| Критерий | Zulip v12.4 | Mattermost | Slack | Telegram |
|---|---|---|---|---|
| Организация переписки | Потоки + обязательные темы (Topics) | Каналы (плоский список) | Каналы + треды | Чаты/группы (плоский список) |
| Self-hosted | ✅ Docker Compose, Helm | ✅ Docker Compose | ❌ SaaS-only | ✅ MTProto сервер |
| Поиск по истории | Полнотекстовый, мгновенный, с фильтром по теме | Полнотекстовый | Ограничен (90 дней в бесплатном) | Ограниченный |
| Оплата в РФ | ✅ Бесплатно, открытый код | ✅ Бесплатно / от $3.25 | ❌ Только зарубежные карты | ✅ Бесплатно |
| Мобильные клиенты | Android, iOS, F-Droid | Android, iOS | Android, iOS | Android, iOS, все платформы |
| Видеозвонки | Встроенные (Jitsi) или внешние | Встроенные звонки | Встроенные Huddle | Звонки и видео |
| Данные на территории РФ | ✅ Полный контроль | ✅ Полный контроль | ❌ Данные в USA | ⚠️ Серверы за рубежом |
2. Системные требования и выбор тарифа VDS
Zulip — полноценный производственный стек из нескольких сервисов. По официальным рекомендациям мейнтейнеров и проверенной практике инженеров SysKit, минимальные и рекомендуемые требования выглядят так:
| Ресурс VDS | Минимум (до 25 пользователей) | Рекомендуемые (до 100 пользователей) | Инженерный комментарий |
|---|---|---|---|
| Процессор (vCPU) | 2 ядра | 2–4 ядра | RabbitMQ и PostgreSQL требуют параллельных процессов. Одного ядра недостаточно для первоначальной инициализации схемы БД. |
| Оперативная память (RAM) | 2 ГБ | 4 ГБ | Zulip (~512 МБ) + PostgreSQL 14 (~256 МБ) + RabbitMQ (~128 МБ) + Memcached (~64 МБ) + Redis (~32 МБ) + запас ядра Linux и Docker daemon. |
| Диск (NVMe / SSD) | 20 ГБ | 40–60 ГБ | История сообщений, загруженные пользователями файлы, аватары, образы Docker и база PostgreSQL растут со временем. SSD обязателен для быстрого поиска по сообщениям. |
| Сетевой канал | 100 Мбит/с | 200–1000 Мбит/с | Zulip удерживает долгоживущие EventSource-соединения (аналог WebSocket) для мгновенной доставки сообщений. Требуется стабильный IPv4. |
⚠️ Важно: Zulip требует минимум 2 ГБ RAM
В отличие от легковесных утилит (Gotify, Beszel), Zulip — полноценный корпоративный стек из 5 контейнеров с Django-бэкендом, брокером очередей RabbitMQ и реляционной базой данных PostgreSQL 14. Запуск на VDS с 1 ГБ RAM приведёт к OOM Killer и нестабильной работе сервиса. Оптимальный тариф — от 2–4 ГБ RAM.
3. Подготовка сервера и структура проекта
Создадим изолированную рабочую директорию для Zulip и подготовим файлы конфигурации:
sudo mkdir -p /opt/zulip
cd /opt/zulip
Zulip использует Docker Secrets для безопасного управления паролями сервисов — секреты никогда не попадают в переменные окружения в открытом виде. Все секреты передаются через файл .env. Сгенерируем надёжные случайные пароли:
# Генерация криптографически стойких случайных значений
openssl rand -hex 32 # используйте вывод как ZULIP__POSTGRES_PASSWORD
openssl rand -hex 32 # как ZULIP__MEMCACHED_PASSWORD
openssl rand -hex 32 # как ZULIP__RABBITMQ_PASSWORD
openssl rand -hex 32 # как ZULIP__REDIS_PASSWORD
openssl rand -hex 64 # как ZULIP__SECRET_KEY (512-битный ключ Django)
Создадим файл /opt/zulip/.env с переменными окружения. Используйте генератор надёжных паролей SysKit для создания секретов:
# /opt/zulip/.env
# --- Секреты сервисов (Docker Secrets) ---
ZULIP__POSTGRES_PASSWORD=ваш_надежный_пароль_postgres
ZULIP__MEMCACHED_PASSWORD=ваш_надежный_пароль_memcached
ZULIP__RABBITMQ_PASSWORD=ваш_надежный_пароль_rabbitmq
ZULIP__REDIS_PASSWORD=ваш_надежный_пароль_redis
# Ключ Django (64+ символов hex)
ZULIP__SECRET_KEY=ваш_512_битный_секретный_ключ_django
# Пароль SMTP для отправки почты (Yandex360, Mail.ru или любой SMTP)
ZULIP__EMAIL_PASSWORD=ваш_пароль_от_smtp
⚠️ Права доступа к файлу .env
Файл .env содержит все секреты вашего стека. Немедленно ограничьте права: sudo chmod 600 /opt/zulip/.env && sudo chown root:root /opt/zulip/.env. Никогда не коммитьте этот файл в Git-репозиторий.
4. Развертывание Zulip в Docker Compose
Создадим файл /opt/zulip/compose.yaml на базе официального манифеста с добавлением ограничений ресурсов и привязки портов к loopback-интерфейсу для безопасности:
# /opt/zulip/compose.yaml
---
secrets:
zulip__postgres_password:
environment: "ZULIP__POSTGRES_PASSWORD"
zulip__memcached_password:
environment: "ZULIP__MEMCACHED_PASSWORD"
zulip__rabbitmq_password:
environment: "ZULIP__RABBITMQ_PASSWORD"
zulip__redis_password:
environment: "ZULIP__REDIS_PASSWORD"
zulip__secret_key:
environment: "ZULIP__SECRET_KEY"
zulip__email_password:
environment: "ZULIP__EMAIL_PASSWORD"
services:
database:
image: "zulip/zulip-postgresql:14"
restart: unless-stopped
secrets:
- zulip__postgres_password
environment:
POSTGRES_DB: "zulip"
POSTGRES_USER: "zulip"
POSTGRES_PASSWORD_FILE: /run/secrets/zulip__postgres_password
volumes:
- "postgresql-14:/var/lib/postgresql/data:rw"
mem_limit: 512m
cpus: 1.0
memcached:
image: "memcached:alpine"
restart: unless-stopped
command:
- "sh"
- "-euc"
- |
echo 'mech_list: plain' > "$$SASL_CONF_PATH"
echo "zulip@$$HOSTNAME:$$(cat $$MEMCACHED_PASSWORD_FILE)" > "$$MEMCACHED_SASL_PWDB"
echo "zulip@localhost:$$(cat $$MEMCACHED_PASSWORD_FILE)" >> "$$MEMCACHED_SASL_PWDB"
exec memcached -S
secrets:
- zulip__memcached_password
environment:
SASL_CONF_PATH: "/home/memcache/memcached.conf"
MEMCACHED_SASL_PWDB: "/home/memcache/memcached-sasl-db"
MEMCACHED_PASSWORD_FILE: /run/secrets/zulip__memcached_password
mem_limit: 128m
cpus: 0.5
rabbitmq:
image: "rabbitmq:4.2"
restart: unless-stopped
command:
- "sh"
- "-euc"
- |
export RABBITMQ_DEFAULT_PASS="$$(cat $$RABBITMQ_PASSWORD_FILE)"
echo 'default_user = $$(RABBITMQ_DEFAULT_USER)' >> /etc/rabbitmq/rabbitmq.conf
echo 'default_pass = $$(RABBITMQ_DEFAULT_PASS)' >> /etc/rabbitmq/rabbitmq.conf
exec docker-entrypoint.sh rabbitmq-server
secrets:
- zulip__rabbitmq_password
environment:
RABBITMQ_DEFAULT_USER: "zulip"
RABBITMQ_PASSWORD_FILE: /run/secrets/zulip__rabbitmq_password
volumes:
- "rabbitmq:/var/lib/rabbitmq:rw"
mem_limit: 256m
cpus: 0.5
redis:
image: "redis:alpine"
restart: unless-stopped
command:
- "sh"
- "-euc"
- '/usr/local/bin/docker-entrypoint.sh --requirepass "$$(cat $$REDIS_PASSWORD_FILE)"'
secrets:
- zulip__redis_password
environment:
REDIS_PASSWORD_FILE: /run/secrets/zulip__redis_password
volumes:
- "redis:/data:rw"
mem_limit: 128m
cpus: 0.5
zulip:
image: "ghcr.io/zulip/zulip-server:12.4-0"
restart: unless-stopped
ports:
# Привязываем только к loopback — Nginx выступает как Reverse Proxy
# Это защищает порты от обхода UFW через Docker iptables
- "127.0.0.1:8000:80"
secrets:
- zulip__postgres_password
- zulip__memcached_password
- zulip__rabbitmq_password
- zulip__redis_password
- zulip__secret_key
- zulip__email_password
environment:
SETTING_EXTERNAL_HOST: "zulip.yourdomain.ru"
SETTING_ZULIP_ADMINISTRATOR: "admin@yourdomain.ru"
SETTING_REMOTE_POSTGRES_HOST: "database"
SETTING_MEMCACHED_LOCATION: "memcached:11211"
SETTING_RABBITMQ_HOST: "rabbitmq"
SETTING_REDIS_HOST: "redis"
# Zulip работает за Nginx Reverse Proxy — доверяем IP шлюза Docker
TRUST_GATEWAY_IP: "True"
# SMTP для системных писем (регистрация, сброс пароля)
SETTING_EMAIL_HOST: "smtp.yandex.ru"
SETTING_EMAIL_HOST_USER: "noreply@yourdomain.ru"
SETTING_EMAIL_PORT: "587"
SETTING_EMAIL_USE_SSL: "False"
SETTING_EMAIL_USE_TLS: "True"
volumes:
- "zulip:/data:rw"
ulimits:
nofile:
soft: 1000000
hard: 1048576
mem_limit: 1024m
cpus: 2.0
depends_on:
- database
- memcached
- rabbitmq
- redis
volumes:
zulip:
postgresql-14:
rabbitmq:
redis:
💡 Почему порт привязан к 127.0.0.1?
Docker по умолчанию добавляет правила iptables, которые обходят UFW при публикации портов на 0.0.0.0. Привязка к 127.0.0.1:8000 гарантирует, что контейнер Zulip доступен только через Nginx и недостижим напрямую из интернета. Это фундаментальный принцип безопасности всех наших production-конфигураций.
Запустим стек в фоновом режиме и дождёмся завершения первоначальной инициализации базы данных (~2–3 минуты при первом старте):
cd /opt/zulip
sudo docker compose up -d
# Наблюдаем за инициализацией (первый запуск занимает до 3 минут)
sudo docker compose logs -f zulip
Дождитесь появления строки Zulip server is running в логах. После этого проверьте статус всех контейнеров:
sudo docker compose ps
# Все сервисы должны иметь статус "running" или "healthy"
Рекомендуемые VDS-провайдеры
Отказоустойчивые сервера с быстрыми NVMe и каналом до 1 Гбит/с
Timeweb Cloud — Быстрые NVMe VDS
Оптимальный тариф для Zulip: 2 vCPU и 4 ГБ RAM для комфортной работы всего стека из 5 контейнеров. Почасовая оплата, защита от DDoS.
Selectel — Облачная инфраструктура
Дата-центры в Москве и Санкт-Петербурге, аттестованные по 152-ФЗ. Данные вашей команды остаются в России. SLA 99.98%.
Beget — Простота для сисадминов
Удобная панель управления, автоматические ежедневные бэкапы хоста и мгновенный деплой Docker. Доступные тарифы от 300 ₽/мес.
5. Настройка Nginx Reverse Proxy с EventSource и SSL
Zulip доставляет сообщения в реальном времени через технологию Server-Sent Events (SSE) — долгоживущие HTTP-соединения к эндпоинту /api/v1/events. Если Nginx не настроить специально, стандартные 60-секундные таймауты будут разрывать эти соединения, заставляя клиентов переподключаться каждую минуту и замедляя работу интерфейса.
Установим Nginx и Certbot, выпустим SSL-сертификат Let's Encrypt:
sudo apt update && sudo apt install -y nginx certbot python3-certbot-nginx
# Выпуск сертификата Let's Encrypt
sudo certbot certonly --nginx -d zulip.yourdomain.ru \
--agree-tos --email admin@yourdomain.ru --no-eff-email
Создадим файл конфигурации виртуального хоста /etc/nginx/sites-available/zulip.conf:
# /etc/nginx/sites-available/zulip.conf
upstream zulip_backend {
server 127.0.0.1:8000;
keepalive 32;
}
# HTTP -> HTTPS redirect
server {
listen 80;
listen [::]:80;
server_name zulip.yourdomain.ru;
return 301 https://$host$request_uri;
}
server {
listen 443 ssl;
listen [::]:443 ssl;
http2 on;
server_name zulip.yourdomain.ru;
ssl_certificate /etc/letsencrypt/live/zulip.yourdomain.ru/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/zulip.yourdomain.ru/privkey.pem;
ssl_protocols TLSv1.2 TLSv1.3;
ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384;
ssl_prefer_server_ciphers off;
ssl_session_cache shared:SSL:10m;
ssl_session_timeout 1d;
# Максимальный размер файлов (аватары, вложения, голосовые сообщения)
client_max_body_size 25m;
location / {
proxy_pass http://zulip_backend;
proxy_http_version 1.1;
# Заголовки для корректной работы за прокси
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto https;
# Критически важно: долгие таймауты для SSE и загрузки файлов
# Zulip держит постоянные /api/v1/events соединения (Server-Sent Events)
proxy_connect_timeout 60s;
proxy_read_timeout 3600s;
proxy_send_timeout 3600s;
# Отключение буферизации для мгновенной доставки событий
proxy_buffering off;
# Поддержка переключения протокола (WebSocket для звонков через Jitsi)
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection $connection_upgrade;
}
}
# Нужна переменная для connection upgrade
map $http_upgrade $connection_upgrade {
default upgrade;
'' close;
}
⚠️ Почему нужен proxy_read_timeout 3600s?
Zulip использует долгоживущие HTTP-соединения (Server-Sent Events) для мгновенной доставки новых сообщений. С дефолтным таймаутом Nginx в 60 секунд браузер клиента будет переподключаться каждую минуту — интерфейс «мигает», сообщения кажутся медленными. Значение 3600s удерживает соединение активным в течение часа без разрывов.
Активируем конфигурацию и настроим UFW:
sudo ln -s /etc/nginx/sites-available/zulip.conf /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx
# Открываем порты 80 и 443, закрываем прямой доступ к порту 8000
sudo ufw allow 'Nginx Full'
sudo ufw deny 8000
Проверьте корректность SSL через SSL-чекер SysKit.
6. Первоначальная настройка и создание организации
Откройте браузер и перейдите по адресу https://zulip.yourdomain.ru. Zulip попросит создать первую организацию:
- Укажите имя организации (например, «Команда DevShop»), выберите тип (Business для компаний, Community для сообществ).
- Введите email и пароль для учётной записи главного администратора — на этот адрес придёт письмо для подтверждения (убедитесь, что SMTP настроен корректно).
- После входа вас встретит обязательный мастер настройки: выберите часовой пояс (Europe/Moscow), язык интерфейса (Zulip полностью переведён на русский), загрузите логотип организации.
📱 Мобильные клиенты Zulip
Установите официальные клиенты из Google Play, F-Droid или App Store. При первом входе укажите адрес вашего сервера (https://zulip.yourdomain.ru). Zulip поддерживает push-уведомления через собственный Zulip Mobile Push Notification Service (опциональная регистрация сервера через ./manage.py register_server).
7. Организация потоков и базовые настройки команды
После входа создайте базовую структуру потоков для вашей команды. Перейдите в раздел Manage organization → Streams и создайте:
| Поток (Stream) | Назначение | Рекомендуемый тип |
|---|---|---|
#general |
Общие объявления, новости компании | Public (все участники) |
#dev |
Код, PR, баги, технические обсуждения | Public или Private |
#devops |
Деплой, мониторинг, инциденты серверов | Private (только инженеры) |
#alerts |
Автоматические алерты от Zabbix/Beszel/Gotify | Private (только боты + ответственные) |
#random |
Неформальное общение, мемы | Public |
Пригласите участников через Manage organization → Users → Invite users. Zulip поддерживает массовое приглашение по CSV-файлу со списком email-адресов.
8. Интеграции: вебхуки от Gitea, GitHub и мониторинга
Zulip поддерживает более 90 встроенных интеграций через вебхуки. Каждая интеграция получает собственный URL вида https://zulip.yourdomain.ru/api/v1/external/СЕРВИС?api_key=TOKEN&stream=devops&topic=Алерты. Настройте получение событий в боте:
- Перейдите в Settings → Your bots → Add a new bot, выберите тип Incoming webhook.
- Укажите имя бота (например,
Gitea Bot) и стрим по умолчанию (dev). - Скопируйте API-ключ и URL вебхука.
Пример настройки вебхука Gitea (в настройках репозитория Gitea → Webhooks → Add Webhook → Zulip):
# Целевой URL для Gitea-вебхука:
https://zulip.yourdomain.ru/api/v1/external/gitea?api_key=ВАШ_API_КЛЮЧ_БОТА&stream=dev&topic=Gitea
Теперь каждый коммит, открытие PR или комментарий в Gitea будут мгновенно появляться в потоке #dev с темой Gitea.
Универсальный вебхук от bash-скрипта мониторинга (отправка алерта из cron или Fail2ban):
#!/usr/bin/env bash
# /opt/zulip/scripts/alert_zulip.sh
# Использование: ./alert_zulip.sh "Тема" "Текст сообщения"
set -euo pipefail
ZULIP_URL="https://zulip.yourdomain.ru/api/v1/messages"
ZULIP_BOT_EMAIL="alerts-bot@yourdomain.ru"
ZULIP_API_KEY="ВАШ_API_КЛЮЧ"
STREAM="alerts"
TOPIC="${1:-Системный алерт}"
MESSAGE="${2:-Нет данных}"
curl -s -X POST "${ZULIP_URL}" \
-u "${ZULIP_BOT_EMAIL}:${ZULIP_API_KEY}" \
--data-urlencode "type=stream" \
--data-urlencode "to=${STREAM}" \
--data-urlencode "topic=${TOPIC}" \
--data-urlencode "content=${MESSAGE}"
sudo chmod +x /opt/zulip/scripts/alert_zulip.sh
# Пример использования в скрипте мониторинга диска:
DISK_USE=$(df -h / | awk 'NR==2 {print $5}' | tr -d '%')
if [ "$DISK_USE" -gt 85 ]; then
/opt/zulip/scripts/alert_zulip.sh "🔴 Диск заполнен" \
"Занято **${DISK_USE}%** дискового пространства на $(hostname). Требуется чистка."
fi
9. Резервное копирование и регламент обслуживания
Zulip хранит все данные в двух местах: PostgreSQL 14 (сообщения, пользователи, организация) и томе Docker zulip (загруженные файлы, аватары, логи). Создадим скрипт консистентного горячего бэкапа:
#!/usr/bin/env bash
# /usr/local/bin/backup-zulip.sh
set -euo pipefail
BACKUP_DIR="/opt/backups/zulip"
DATE=$(date +%Y-%m-%d_%H-%M)
RETENTION_DAYS=7
mkdir -p "${BACKUP_DIR}"
echo "[$(date)] Начало бэкапа Zulip..."
# 1. Дамп PostgreSQL из живого контейнера
docker exec zulip-database-1 pg_dump \
-U zulip \
-F c \
-f /tmp/zulip_db_${DATE}.dump \
zulip
docker cp zulip-database-1:/tmp/zulip_db_${DATE}.dump \
"${BACKUP_DIR}/zulip_db_${DATE}.dump"
docker exec zulip-database-1 rm -f /tmp/zulip_db_${DATE}.dump
# 2. Архив тома с файлами (аватары, вложения)
docker run --rm \
-v zulip_zulip:/data:ro \
-v "${BACKUP_DIR}":/backup \
alpine \
tar -czf /backup/zulip_files_${DATE}.tar.gz -C / data
# 3. Удаление устаревших бэкапов
find "${BACKUP_DIR}" -mtime +${RETENTION_DAYS} -delete
echo "[$(date)] Бэкап завершён: ${BACKUP_DIR}"
sudo chmod 700 /usr/local/bin/backup-zulip.sh
sudo chmod 600 /usr/local/bin/backup-zulip.sh # только root
# Добавить в cron: ежедневно в 03:00
echo "0 3 * * * root /usr/local/bin/backup-zulip.sh >> /var/log/zulip-backup.log 2>&1" \
| sudo tee /etc/cron.d/zulip-backup
10. Чек-лист готовности к production
| Пункт | Команда / Действие | Статус |
|---|---|---|
| Все 5 контейнеров запущены | sudo docker compose ps |
Статус: running |
| SSL-сертификат выпущен | sudo certbot certificates |
Статус: VALID |
| Порт 8000 недоступен извне | Port Checker SysKit | Порт закрыт |
| Автопродление SSL настроено | sudo systemctl status certbot.timer |
Таймер активен |
| SMTP: письма доходят | Пройти регистрацию нового пользователя | Email получен |
| Бэкап работает | sudo /usr/local/bin/backup-zulip.sh |
Файлы в /opt/backups/zulip/ |
| Мобильный клиент подключается | Вход через Android/iOS-приложение | Сообщения доставляются |
| Вебхук работает | ./alert_zulip.sh "Тест" "Всё работает!" |
Сообщение в #alerts |
| Русский интерфейс | Settings → Language → Русский | Локализация применена |
| UFW настроен | sudo ufw status |
80, 443 — ALLOW; 8000 — DENY |
🚀 Обновление Zulip
Для обновления до новой версии достаточно изменить тег образа в compose.yaml (например, с 12.4-0 на следующий релиз) и выполнить sudo docker compose pull && sudo docker compose up -d. Zulip автоматически применит миграции базы данных при перезапуске контейнера.