Для любого коммерческого проекта — будь то SaaS-сервис, интернет-магазин, инди-разработка или профессиональное IT-сообщество — организация клиентской поддержки исключительно в мессенджерах (Telegram, WhatsApp) со временем становится узким горлышком. Одни и те же вопросы задаются сотни раз, ответы тонут в ленте переписки, а поисковые системы (Яндекс, Google) не могут проиндексировать закрытые чаты. В результате бизнес теряет гигантский массив бесплатного органического трафика по низкочастотным поисковым запросам («как настроить X», «ошибка Y при оплате»).
Классические форумы вроде phpBB, vBulletin или XenForo морально устарели: они медленно перезагружают страницу при каждом клике, сложны в адаптации под смартфоны и требуют тяжелого администрирования. С другой стороны, Discourse написан на Ruby on Rails и требует от 4 до 8 ГБ оперативной памяти, что неоправданно дорого для небольших и средних проектов.
Flarum — передовая платформа комьюнити с открытым исходным кодом (более 16 000 звёзд на GitHub у главного дистрибутива flarum/flarum и свыше 6 700 звёзд у пакета ядра flarum/framework, актуальный релиз v2.0.2). Построенный на связке современного PHP и реактивного фронтенда на Mithril.js, Flarum работает как сверхбыстрое Single Page Application (SPA): бесконечная прокрутка тем, мгновенный поиск без перезагрузки страниц, плавная анимация и скромное потребление ресурсов.
1. Концепция современного форума и архитектура Flarum v2.0
Архитектура Flarum кардинально отличается от форумных движков прошлого поколения. Она спроектирована по модульному API-first принципу:
- Реактивный SPA-фронтенд (Mithril.js): интерфейс полностью отвязан от бэкенда. При навигации по категориям, открытии дискуссий или фильтрации по тегам страница не перезагружается — браузер за миллисекунды подтягивает JSON через REST API, сохраняя позицию скролла и открытые черновики ответов.
- Ядро бэкенда на PHP 8.2/8.3: легковесный сервис, обрабатывающий REST API, сессии, авторизацию и систему событий. Благодаря архитектуре middleware и встроенному OPcache время ответа API на сервере составляет менее 30–50 мс.
- База данных MariaDB 11.4 LTS: хранилище с кодировкой
utf8mb4_unicode_ciдля корректной поддержки любых символов и эмодзи. Оптимизированные индексы обеспечивают мгновенный полнотекстовый поиск по миллионам постов. - Фоновый планировщик (Cron Sidecar): выделенный легковесный процесс, запускающий регламентные задачи Flarum раз в минуту (отправка отложенных email-уведомлений, очистка черновиков, генерация карты сайта sitemap).
| Критерий | Flarum v2.0 | phpBB 3.3 | Discourse | Telegram-группа |
|---|---|---|---|---|
| Тип интерфейса | Мгновенный SPA (без перезагрузки) | Классический Multi-Page (перезагрузка) | SPA (Ember.js) | Мессенджер (лента сообщений) |
| Потребление RAM | ~60 МБ (Flarum) + ~200 МБ (DB) | ~40 МБ + ~150 МБ (DB) | ~2.5 – 4 ГБ (Ruby + Sidekiq + PG) | 0 (SaaS) |
| Индексация в Яндекс / Google | ✅ Базовые мета-теги + XML Sitemap | ✅ Нативная Multi-Page | ✅ Полноценный SSR (Ember) | ❌ Нет (закрытый протокол) |
| Структура обсуждений | Теги, дискуссии, подписки | Жесткие разделы и подразделы | Категории и теги | Хаотичный чат / темы |
| Стоимость хостинга | От 250–350 ₽/мес (1 vCPU / 1 ГБ) | От 250 ₽/мес | От 1 200–2 000 ₽/мес (2–4 vCPU) | Бесплатно |
| Контроль данных (152-ФЗ) | ✅ 100% на вашем сервере в РФ | ✅ На вашем сервере | ✅ На вашем сервере | ⚠️ Серверы за рубежом |
2. Системные требования и выбор тарифа VDS
Благодаря высокой оптимизации Flarum не требует дорогих вычислительных ресурсов. Ниже приведены проверенные параметры серверной конфигурации для стабильной работы:
| Ресурс VDS | Минимум (до 5 000 просмотров/день) | Рекомендуемые (до 50 000 просмотров/день) | Инженерный комментарий |
|---|---|---|---|
| Процессор (vCPU) | 1 ядро (от 2.5 ГГц) | 2 ядра (от 3.0 ГГц) | Mithril.js рендерит интерфейс в браузере клиента, поэтому нагрузка на процессор сервера минимальна даже при десятках одновременных пользователей. |
| Оперативная память (RAM) | 1 ГБ | 2 ГБ | По замерам через docker stats в режиме покоя базовый стек занимает ~220–280 МБ RAM (из которых ~180 МБ берет пул MariaDB, ~50 МБ PHP-FPM и ~15 МБ cron). Под нагрузкой с заполнением буфера OPcache потребление вырастает до 350–450 МБ. Тариф с 1 ГБ RAM с небольшим swap достаточен на старте, а 2 ГБ рекомендуется для стабильной работы под нагрузкой. |
| Диск (NVMe / SSD) | 15 ГБ | 25–40 ГБ | База данных текстовых сообщений компактна (10 000 постов занимают менее 50 МБ). Основное место расходуется на загруженные пользователями вложения и аватары. |
| Сетевой канал | 100 Мбит/с | 100–1000 Мбит/с | Стабильный выделенный IPv4-адрес необходим для привязки домена и корректной работы Let's Encrypt SSL. |
3. Подготовка сервера и структура проекта
Для изолированного развертывания Flarum подготовим рабочую директорию /opt/flarum/. В ней разместим манифест Docker Compose, файл переменных окружения, постоянное хранилище базы MariaDB, файлы самого форума и сервисные скрипты:
sudo mkdir -p /opt/flarum/{data,db,scripts}
cd /opt/flarum
Узнаем UID и GID текущего системного пользователя, чтобы контейнер Flarum корректно работал с файловой системой без конфликта прав:
id -u
# Обычно: 1000
id -g
# Обычно: 1000
Сформируем файл переменных окружения /opt/flarum/.env. Для генерации криптографически стойких паролей базы данных воспользуйтесь генератором паролей SysKit:
# /opt/flarum/.env
# Основные системные параметры
TZ=Europe/Moscow
PUID=1000
PGID=1000
# База данных MariaDB
MYSQL_DATABASE=flarum
MYSQL_USER=flarum
MYSQL_PASSWORD=your_secure_db_password_here
# Настройки веб-домена Flarum
FLARUM_BASE_URL=https://community.yourdomain.ru
FLARUM_DEBUG=false
MEMORY_LIMIT=256M
UPLOAD_MAX_SIZE=25M
OPCACHE_MEM_SIZE=128
⚠️ Защита секретов в файле .env
Обязательно ограничьте права на файл с паролями базы данных: sudo chmod 600 /opt/flarum/.env. Это исключит возможность несанкционированного чтения конфигурации другими пользователями сервера.
4. Развертывание Flarum, MariaDB и Cron в Docker Compose
Создадим конфигурационный файл /opt/flarum/docker-compose.yml. В манифесте строго зафиксируем стабильные версии образов (crazymax/flarum:2.0.2 и MariaDB 11.4 LTS), привяжем порт к локальному loopback-интерфейсу 127.0.0.1:8088 для исключения обхода системного фаервола UFW и настроим фоновый планировщик Cron:
# /opt/flarum/docker-compose.yml
services:
db:
image: mariadb:11.4
container_name: flarum_db
restart: unless-stopped
command:
- "mariadbd"
- "--character-set-server=utf8mb4"
- "--collation-server=utf8mb4_unicode_ci"
- "--innodb-buffer-pool-size=128M"
volumes:
- "./db:/var/lib/mysql"
environment:
- TZ=${TZ}
- MARIADB_RANDOM_ROOT_PASSWORD=yes
- MYSQL_DATABASE=${MYSQL_DATABASE}
- MYSQL_USER=${MYSQL_USER}
- MYSQL_PASSWORD=${MYSQL_PASSWORD}
mem_limit: 512m
cpus: 1.0
networks:
- flarum-net
healthcheck:
test: ["CMD-SHELL", "mariadb-admin ping -h localhost -u $${MYSQL_USER} --password=$${MYSQL_PASSWORD} || exit 1"]
interval: 10s
timeout: 5s
retries: 5
start_period: 20s
flarum:
image: crazymax/flarum:2.0.2
container_name: flarum_app
restart: unless-stopped
ports:
# Проброс строго на локальный 127.0.0.1 (защита от сканирования извне)
- "127.0.0.1:8088:8000"
depends_on:
db:
condition: service_healthy
volumes:
- "./data:/data"
environment:
- TZ=${TZ}
- PUID=${PUID}
- PGID=${PGID}
- DB_HOST=db
- DB_NAME=${MYSQL_DATABASE}
- DB_USER=${MYSQL_USER}
- DB_PASSWORD=${MYSQL_PASSWORD}
# Отключение префикса flarum_ для чистых таблиц в выделенной БД
- DB_NOPREFIX=true
- FLARUM_BASE_URL=${FLARUM_BASE_URL}
- FLARUM_DEBUG=${FLARUM_DEBUG}
- MEMORY_LIMIT=${MEMORY_LIMIT}
- UPLOAD_MAX_SIZE=${UPLOAD_MAX_SIZE}
- OPCACHE_MEM_SIZE=${OPCACHE_MEM_SIZE}
# Заголовки реального IP клиента от хостового Nginx
- REAL_IP_FROM=127.0.0.1,172.16.0.0/12
- REAL_IP_HEADER=X-Forwarded-For
mem_limit: 512m
cpus: 1.0
networks:
- flarum-net
cron:
image: crazymax/flarum:2.0.2
container_name: flarum_cron
restart: unless-stopped
depends_on:
- flarum
volumes:
- "./data:/data"
environment:
- TZ=${TZ}
- PUID=${PUID}
- PGID=${PGID}
- DB_HOST=db
- DB_NAME=${MYSQL_DATABASE}
- DB_USER=${MYSQL_USER}
- DB_PASSWORD=${MYSQL_PASSWORD}
- SIDECAR_CRON=1
- CRON_SCHEDULE=* * * * *
mem_limit: 128m
cpus: 0.5
networks:
- flarum-net
networks:
flarum-net:
driver: bridge
💡 Зачем нужен отдельный контейнер Cron Sidecar?
В веб-приложениях фоновые задачи (очистка временных токенов, отправка digest-рассылок, построение карты сайта) не должны выполняться внутри входящих HTTP-запросов пользователей, иначе это замедляет загрузку страниц. Контейнер flarum_cron монтирует ту же директорию данных ./data и каждую минуту вызывает команду php /data/flarum schedule:run, освобождая веб-сервер от фоновой нагрузки.
Запустим контейнеры стека в фоновом режиме:
sudo docker compose up -d
Удостоверимся, что база данных прошла healthcheck, а веб-сервер Flarum успешно принимает локальные запросы:
sudo docker compose ps
curl -s -I http://127.0.0.1:8088
# Ожидается HTTP/1.1 200 OK или редирект на установщик
Рекомендуемые VDS-провайдеры
Отказоустойчивые сервера с быстрыми NVMe и каналом до 1 Гбит/с
Timeweb Cloud — Быстрые NVMe VDS
Идеальный выбор для Flarum: высокая частота процессора 3.3 ГГц для быстрой генерации PHP-ответов и скоростной NVMe-накопитель под MariaDB.
Selectel — Облачная инфраструктура
Отказоустойчивые дата-центры уровня Tier III в Москве и Санкт-Петербурге. Аттестация по 152-ФЗ для безопасного хранения данных пользователей.
Beget — Простота для сисадминов
Удобная панель администрирования, автоматическое создание бэкапов сервера и быстрый запуск Docker в изолированной среде.
5. Настройка Nginx Reverse Proxy с SSL и сжатием
Для публикации форума в интернете настроим хостовый веб-сервер Nginx в качестве безопасного обратного прокси. Nginx возьмет на себя обработку HTTPS, терминацию SSL-сертификатов Let's Encrypt и сжатие статических ассетов (JS, CSS, шрифты).
Установим Certbot и выпустим бесплатный SSL-сертификат для вашего поддомена (например, community.yourdomain.ru):
sudo apt update && sudo apt install -y nginx certbot python3-certbot-nginx
# Выпуск сертификата Let's Encrypt
sudo certbot certonly --nginx -d community.yourdomain.ru --agree-tos --email admin@yourdomain.ru --no-eff-email
Создадим конфигурационный файл виртуального хоста /etc/nginx/sites-available/flarum.conf:
# /etc/nginx/sites-available/flarum.conf
upstream flarum_backend {
server 127.0.0.1:8088;
keepalive 32;
}
# Редирект HTTP -> HTTPS
server {
listen 80;
listen [::]:80;
server_name community.yourdomain.ru;
return 301 https://$host$request_uri;
}
# Основной HTTPS сервер
server {
listen 443 ssl;
listen [::]:443 ssl;
http2 on;
server_name community.yourdomain.ru;
# SSL сертификаты Let's Encrypt
ssl_certificate /etc/letsencrypt/live/community.yourdomain.ru/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/community.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;
# Заголовки безопасности
add_header X-Content-Type-Options "nosniff" always;
add_header X-Frame-Options "SAMEORIGIN" always;
add_header Referrer-Policy "strict-origin-when-cross-origin" always;
add_header Permissions-Policy "camera=(), microphone=(), geolocation=()" always;
# Сжатие gzip для SPA-ассетов
gzip on;
gzip_vary on;
gzip_proxied any;
gzip_comp_level 6;
gzip_types text/plain text/css text/xml application/json application/javascript application/rss+xml image/svg+xml;
location / {
proxy_pass http://flarum_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;
proxy_connect_timeout 60s;
proxy_send_timeout 60s;
proxy_read_timeout 60s;
}
}
Активируем конфигурацию, проверяем синтаксис и перезагружаем Nginx:
sudo ln -s /etc/nginx/sites-available/flarum.conf /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx
Проверить корректность SSL-сертификата и шифров можно через онлайн-чекер SSL SysKit.
6. Первоначальный вход и смена дефолтного администратора
В отличие от ручной установки, контейнер crazymax/flarum выполняет автоматическую инициализацию базы данных при первом старте на основе переданных в docker-compose.yml переменных (хост базы, имя пользователя, пароль). Ручной ввод параметров MySQL в веб-мастере не требуется — форум сразу готов к работе.
🚨 КРИТИЧЕСКИЙ ШАГ БЕЗОПАСНОСТИ: Дефолтный пароль администратора
При первой автоматической инициализации образ создает встроенную учетную запись главного администратора со следующими стандартными данными:
- Логин:
flarum - Пароль:
flarum
Категорически запрещено оставлять эти учетные данные! Если не сменить пароль сразу после запуска, любой злоумышленник сможет получить полный административный контроль над вашим форумом.
Для защиты форума немедленно выполните следующие действия:
- Откройте в браузере
https://community.yourdomain.ru/login. - Авторизуйтесь под учетной записью
flarumс паролемflarum. - Нажмите на аватар в правом верхнем углу ➔ перейдите в Settings.
- В разделе безопасности немедленно измените пароль на криптостойкий из генератора паролей SysKit.
- Укажите ваш реальный административный email и подтвердите его.
- Перейдите в панель управления Administration ➔ Basics и задайте официальное название форума (Forum Title), описание и базовые теги.
7. Русификация и ключевые расширения (SEO, Telegram, антиспам)
В образе crazymax/flarum Flarum развернут в системной директории /opt/flarum, а для управления модулями предусмотрен специальный встроенный CLI-инструмент extension. Все установленные модули автоматически фиксируются в файле /data/extensions/list внутри смонтированного постоянного тома ./data.
Установим официальный языковой пакет русской локализации с помощью встроенного хелпера:
# Установка русской локализации через встроенный хелпер Flarum
sudo docker compose exec flarum extension require flarum-lang/russian
# Проверка списка установленных расширений
sudo docker compose exec flarum extension list
После этого перейдите в панель управления Administration ➔ Languages и активируйте русский язык по умолчанию.
💡 Как устроена персистентность расширений в образе crazymax
В данном образе каталоги /opt/flarum/vendor и composer.json не монтируются на диск хоста, чтобы избежать конфликтов прав доступа PHP. Вместо этого список установленных пакетов автоматически сохраняется в файл /data/extensions/list. При перезапуске контейнера или обновлении Docker-образа Flarum считывает этот список и автоматически восстанавливает все зависимости. Для принудительной синхронизации также доступна команда docker compose exec flarum extension sync.
Для продвижения в поисковых системах Яндекс и Google, приема пользовательских файлов и защиты от спама рекомендуем установить следующий проверенный стек модулей:
# Пакетная установка рекомендуемых модулей
sudo docker compose exec flarum extension require \
fof/sitemap \
fof/upload \
fof/spamblock \
fof/oauth \
nodeloc/telegram \
fof/formatting
| Расширение на Packagist | Назначение для сообщества |
|---|---|
| fof/sitemap (SEO) | Автоматическая генерация карты сайта /sitemap.xml по расписанию Cron для индексации всех дискуссий Яндексом и Googlebot. |
| fof/upload | Загрузка скриншотов, картинок и документов пользователями с хранением на локальном NVMe или в S3. |
| fof/spamblock | Мгновенная блокировка спам-ботов и удаление всех их сообщений модератором в 1 клик. |
| fof/oauth | Вход на форум в 1 клик через популярные OAuth2-провайдеры: GitHub, Google, Discord, GitLab, Facebook. |
| nodeloc/telegram | Авторизация пользователей через Telegram Login Widget и мгновенная отправка алертов о новых темах в Telegram-канал. |
| fof/formatting | Расширенная поддержка Markdown, подсветка синтаксиса кода и автоматический парсинг медиа-ссылок. |
🔍 Автоматический SEO Sitemap для поисковых систем
После включения расширения fof/sitemap перейдите в его настройки и выберите режим «Through the scheduler (recommended)». Контейнер flarum_cron будет автоматически актуализировать карту сайта раз в сутки, а ссылка https://community.yourdomain.ru/sitemap.xml будет готова для отправки в Яндекс.Вебмастер и Google Search Console.
8. Резервное копирование и регламент обслуживания
Все данные форума хранятся в двух точках: реляционной базе MariaDB (пользователи, дискуссии, посты) и каталоге /opt/flarum/data/ (конфигурационный файл config.php, расширения, аватары и пользовательские вложения).
Создадим скрипт консистентного горячего резервного копирования /usr/local/bin/backup-flarum.sh:
#!/usr/bin/env bash
# /usr/local/bin/backup-flarum.sh
set -euo pipefail
BACKUP_DIR="/opt/backups/flarum"
DATE=$(date +%Y-%m-%d_%H-%M)
RETENTION_DAYS=7
DB_CONTAINER="flarum_db"
DB_NAME="flarum"
DB_USER="flarum"
# Безопасное извлечение пароля базы из защищенного файла .env
DB_PASS=$(grep -E '^MYSQL_PASSWORD=' /opt/flarum/.env | cut -d '=' -f2- | tr -d '\r"' | tr -d "'")
mkdir -p "${BACKUP_DIR}"
echo "[$(date)] Запуск резервного копирования Flarum..."
# 1. Горячий дамп MariaDB: пароль передается через переменную MYSQL_PWD,
# чтобы он не отображался в списке процессов ps aux
docker exec -e MYSQL_PWD="${DB_PASS}" "${DB_CONTAINER}" mariadb-dump \
-u "${DB_USER}" \
--single-transaction \
--quick \
"${DB_NAME}" > "${BACKUP_DIR}/flarum_db_${DATE}.sql"
gzip "${BACKUP_DIR}/flarum_db_${DATE}.sql"
# 2. Архивация каталога данных (исключая временный кэш)
tar -czf "${BACKUP_DIR}/flarum_data_${DATE}.tar.gz" \
--exclude="storage/cache/*" \
--exclude="storage/sessions/*" \
-C /opt/flarum data
# 3. Ротация старых копий (хранение 7 дней)
find "${BACKUP_DIR}" -type f -name "flarum_*" -mtime +${RETENTION_DAYS} -delete
echo "[$(date)] Резервная копия успешно создана в ${BACKUP_DIR}"
Назначим строгие права доступа (только для суперпользователя root) и добавим запуск в системный cron:
sudo chmod 700 /usr/local/bin/backup-flarum.sh
sudo chown root:root /usr/local/bin/backup-flarum.sh
# Запуск каждую ночь в 03:30
echo "30 3 * * * root /usr/local/bin/backup-flarum.sh >> /var/log/flarum-backup.log 2>&1" \
| sudo tee /etc/cron.d/flarum-backup
9. Чек-лист готовности к Production и безопасность
| Параметр безопасности | Команда проверки | Ожидаемый эталон |
|---|---|---|
| Дефолтный пароль admin сменен | Проверка входа в профиль | Стандартный пароль flarum / flarum деактивирован, задан криптостойкий пароль и личный email. |
| Все 3 контейнера активны | sudo docker compose ps |
Статус: running / healthy (db, flarum_app, flarum_cron). |
| Порт 8088 изолирован | Онлайн-чекер портов SysKit | Порт 8088 закрыт из внешнего интернета (привязан строго к 127.0.0.1). |
| SSL-сертификат валиден | SSL-чекер SysKit | Шифрование TLS 1.3, автопродление через certbot.timer. |
| Cron Sidecar активен | sudo docker compose logs cron |
Регулярный запуск schedule:run без фатальных ошибок. |
| Карта сайта Sitemap доступна | curl -s -I https://community.yourdomain.ru/sitemap.xml |
HTTP 200 OK, валидный XML-документ. |
| Права на .env защищены | ls -l /opt/flarum/.env |
Строго -rw------- (0600), владелец root. |
| Лимиты ресурсов заданы | sudo docker stats --no-stream |
Суммарное потребление памяти стека менее 300 МБ RAM. |
| Бэкап протестирован | sudo /usr/local/bin/backup-flarum.sh |
Успешное создание архива .sql.gz и .tar.gz. |