Налаштування Push & Pull сервера для real-time сповіщень у Бітрікс24

Коли в Бітрікс24 не приходять сповіщення про нові завдання, повідомлення або зміни статусів замовлень — майже завжди винний неправильно налаштований Push & Pull сервер. Без нього система використовує Long Polling, що дає затримки в 30+ секунд і створює зайве навантаження на сервер. Ми беремо на себе повне налаштування цього компонента: від установки Node.js до інтеграції з модулем pull та перевірки WebSocket-з'єднань. Зв'яжіться з нами для безкоштовної оцінки проекту.

Проблеми, які ми вирішуємо

1. Великі затримки сповіщень

При використанні Long Polling затримка доставки сповіщення може сягати 30 секунд і більше. Для інтернет-магазинів це означає, що клієнт не бачить оновлення статусу замовлення в реальному часі, а співробітники — нові повідомлення в чаті.

2. Надмірне навантаження на сервер

Кожен клієнт при Long Polling постійно тримає HTTP-з'єднання, що призводить до зростання споживання CPU та пам’яті. При 5000 одночасних підключень різниця в пам’яті між Long Polling та WebSocket досягає 60%.

3. Некоректна робота модуля pull

Без правильно налаштованого Push-сервера модуль pull у Бітрікс не може отримувати сповіщення в реальному часі, що призводить до збоїв у роботі додатків.

Як ми це робимо (доказ експертності)

Архітектура Push & Pull сервера

Push-сервер — окремий процес на Node.js, який тримає постійні WebSocket-з'єднання з браузерами користувачів. PHP-бекенд відправляє повідомлення на Push-сервер через HTTP, а той транслює їх усім підключеним клієнтам. Компоненти:

Чому WebSocket кращий за Long Polling?

WebSocket забезпечує двосторонній зв’язок у реальному часі без постійних HTTP-запитів. У тестах він у 2–3 рази швидший за Long Polling за швидкістю доставки та знижує навантаження на CPU до 60%. Для інтернет-магазинів це критично: сповіщення про зміну статусу замовлення приходить миттєво, а не через 30 секунд. При 5000 одночасних підключень WebSocket використовує на 60% менше пам’яті, ніж Long Polling, що суттєво економить ресурси сервера. Згідно з документацією Bitrix, впровадження WebSocket (вебсокети) в Бітрікс дозволяє скоротити витрати на серверну інфраструктуру до 30%.

Як налаштувати Push-сервер за годину?

Установка Node.js LTS та пакета bitrix-push-server займає не більше 15 хвилин. Конфігурація — ще 10 хвилин, налаштування nginx — 5 хвилин. Решту часу йде на інтеграцію з Бітрікс та тестування. У складних випадках (наприклад, кластеризація) процес може зайняти до 3 днів.

Установка Node.js (LTS)

Використовуйте офіційний NodeSource-репозиторій для LTS-версії:

curl -fsSL https://deb.nodesource.com/setup_20.x | bash -
apt-get install -y nodejs
node --version  # v20.x.x
npm --version

Конфігурація Push-сервера

Установіть пакет Bitrix Push Server через npm або завантажте з marketplace.1c-bitrix.ru. Приклад конфігураційного файлу /etc/bitrix/push-server.json:

{
    "security": {
        "key": "SECRET_KEY_HERE"
    },
    "server": {
        "port": 8893,
        "hostname": "0.0.0.0"
    },
    "serverHTTPS": {
        "port": 8894,
        "hostname": "0.0.0.0",
        "key": "/etc/ssl/private/site.key",
        "cert": "/etc/ssl/certs/site.crt"
    },
    "log": {
        "level": "info",
        "file": "/var/log/bitrix-push-server.log"
    }
}

SECRET_KEY_HERE — довгий випадковий рядок. Цей же ключ вкажіть у налаштуваннях модуля Push у Бітрікс.

Налаштування nginx для проксіювання WebSocket

Push-сервер слухає порти 8893 (HTTP) та 8894 (HTTPS). Додайте в конфігурацію nginx:

location /bitrix/subws/ {
    proxy_pass http://127.0.0.1:8893/bitrix/subws/;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "Upgrade";
    proxy_set_header Host $host;
    proxy_read_timeout 3600;
    proxy_send_timeout 3600;
}

location /bitrix/sub/ {
    proxy_pass http://127.0.0.1:8893/bitrix/sub/;
    proxy_http_version 1.1;
    proxy_set_header Host $host;
    proxy_read_timeout 3600;
}

location /bitrix/rest/ {
    proxy_pass http://127.0.0.1:8893/bitrix/rest/;
    proxy_set_header Host $host;
}

Інтеграція з модулем pull у Бітрікс

В адміністративному інтерфейсі: Налаштування → Налаштування продукту → Налаштування модулів → Push і Pull. Вкажіть:

• Публічний шлях — https://yoursite.ru/bitrix/
• Приватний шлях — http://127.0.0.1:8893/bitrix/
• Ключ підпису — той самий SECRET_KEY_HERE

Після збереження перевірте в браузері (DevTools → Network) — повинні з’явитися WebSocket-з’єднання до /bitrix/subws/.

Автозапуск через systemd

Створіть /etc/systemd/system/bitrix-push.service:

[Unit]
Description=Bitrix Push Server
After=network.target

[Service]
Type=simple
User=www-data
ExecStart=/usr/bin/bitrix-push-server --config /etc/bitrix/push-server.json
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target

Запустіть: systemctl enable bitrix-push && systemctl start bitrix-push.

Що входить у налаштування під ключ?

• Аудит поточної конфігурації сервера та Бітрікс
• Установка Node.js LTS та пакета bitrix-push-server
• Створення конфігураційного файла з унікальним ключем безпеки
• Налаштування nginx для проксіювання WebSocket (HTTP та HTTPS)
• Інтеграція модуля pull в адмінці Бітрікс
• Налаштування автозапуску через systemd
• Тестування WebSocket-з’єднань та сповіщень
• Передача документації та доступів

Процес оцінки та роботи

1. Аналіз — вивчаємо поточну архітектуру та навантаження.
2. Проектування — визначаємо оптимальну конфігурацію (порти, ключі, nginx).
3. Розгортання — встановлюємо та налаштовуємо Push-сервер.
4. Тестування — перевіряємо всі real-time сценарії (чати, сповіщення, корзина).
5. Документування — передаємо підсумкові конфіги та інструкції.

Орієнтири по термінах

Налаштування займає від 1 до 3 робочих днів залежно від складності інфраструктури. Вартість визначається після аналізу. Економія на інфраструктурі — до 30 000 ₽ на місяць при переході на WebSocket замість Long Polling. У вартість входить гарантія працездатності протягом 14 днів після здачі. Досвід нашої команди — понад 5 років налаштування Бітрікс та 30+ успішних проектів.

Типові помилки при налаштуванні Push-сервера

• Невідповідність ключа безпеки в конфігу та налаштуваннях Бітрікс
• Блокування портів 8893/8894 фаєрволом
• Відсутність модуля mod_proxy_wstunnel у nginx
• Неправильний публічний шлях (має закінчуватися на /bitrix/)
• Використання застарілої версії Node.js (нижче 18)

Порівняння WebSocket та Long Polling

Детальніше про технологію WebSocket можна прочитати на Wikipedia.

Замовте налаштування Push-сервера під ключ — отримайте консультацію та оцінку проекту безкоштовно.

rsync -avz на продакшен у п’ятницю ввечері, рестарт php-fpm — і сайт відповідає 502, бо в .settings.php залишилися локальні налаштування БД. Деплой «по-старому» — лотерея. Оновлення модуля через адмінку ламає кастомний шаблон компонента, правки не зафіксовані в Git — відновлення займає години.

Ми проєктуємо передбачуваний DevOps-цикл для проєктів на Бітрікс: від Docker-середовища до алертів у Telegram. Кожен деплой стає рутиною, а не стресом.

Проблеми, які ми вирішуємо

Бітрікс історично жив у парадигмі «правимо файли по FTP на бойовому сервері». Результат: двоє розробників одночасно правлять init.php, затираючи зміни один одного. Оновлення модуля через адмінку ламає шаблон компонента — файли не зафіксовані в /local/templates/. Про падіння сайту дізнаються від клієнта, staging-середовища немає, перевірки йдуть на проді. Вартість такого підходу — години відновлення та втрата бізнес-логіки.

Чому DevOps критичний для Бітрікс-проєктів?

Проєкти на Бітрікс мають специфіку: важкий торговий каталог, обмін з 1С через CommerceML, безліч агентів та подій. Без CI/CD та моніторингу кожна зміна — ризик. Ручний деплой може спричинити тижневий простій. Після впровадження DevOps середня економія трудовитрат — до 12 годин ручної роботи на місяць, а бюджету підтримки — 15 000–25 000 грн на місяць. Наш 5-річний досвід (понад 50 проєктів на Бітрікс) і ліцензійна чистота рішень — гарантія стабільності.

Інструменти та конфігурація

CI/CD: від коміту до продакшену без рук

Git — переводимо проєкт з FTP на Git (GitLab, GitHub, Bitbucket). Структура гілок: main, staging, develop, feature-гілки. .gitignore під Бітрікс — нетривіальне завдання:

/bitrix/cache/
/bitrix/managed_cache/
/bitrix/stack_cache/
/upload/
/bitrix/php_interface/dbconn.php
/bitrix/.settings.php
/bitrix/license_key.php

Пропустиш managed_cache/ — репозиторій розпухне на гігабайти. Забудеш виключити license_key.php — ключ витече.

CI-пайплайн перевіряє код: PHPStan level 5+ ловить звернення до неіснуючих методів CIBlockElement, PHP_CodeSniffer з Bitrix-стандартом, PHPUnit для бізнес-логіки, composer audit, збірка фронту. CD-пайплайн розгортає без участі людини. Мерж у staging — деплой на staging. Мерж у main — деплой на production (з ручним підтвердженням або без). Zero-downtime через symlink-стратегію: нова версія в окремій папці, current → symlink перемикається за мілісекунди. upload/ живе поза релізними директоріями. При помилці healthcheck після деплою symlink відкочується. Інструменти: GitLab CI/CD, GitHub Actions, Deployer (PHP). Deployer зручний для Бітрікс — є готові рецепти для symlink-деплою та shared-директорій.

Як Docker вирішує проблему «у мене працює»?

Docker-середовище фіксує версії всіх компонентів: nginx, PHP, MySQL, Redis. Docker скорочує час розгортання нового розробника в 10 разів порівняно з ручним налаштуванням. Локальна розробка — docker-compose.yml включає nginx + php-fpm 8.1/8.2 + MySQL 8.0 (або MariaDB 10.6) + Redis + Memcached. Новий розробник: git clone + docker-compose up -d — за 5 хвилин пише код. Паралельна робота над різними версіями PHP — через окремі compose-файли.

Особливості Бітрікс у Docker: /upload/ монтується як named volume (не bind mount — інакше на Windows/Mac проблеми з правами та швидкістю). Cron-завдання (/bitrix/modules/main/tools/cron_events.php) — через окремий контейнер з тим же образом або supervisord. Модуль «Проактивний захист» (security) блокує запити через reverse proxy — потрібен правильний REMOTE_ADDR через set_real_ip_from та realip_module. bitrix/php_interface/dbconn.php та .settings.php задаються через змінні оточення.

Production: мультистейдж-збірка (build-стадія для асетів, production-стадія з легким образом), Docker Registry для тегованих образів, оркестрація через Docker Swarm або Kubernetes для великих проєктів.

Як правильно налаштувати nginx та php-fpm для Бітрікс?

Різниця між «сайт гальмує» та 200 ms TTFB — у конфігурації. nginx: location-блоки під Бітрікс обробляють urlrewrite.php для ЧПУ. /bitrix/admin/ закриває доступ по IP через allow/deny. expires 30d для статики — CSS, JS, зображення кешуються браузером. Brotli (стиснення на 15-20% ефективніше gzip) вмикається brotli on; brotli_comp_level 6;. Rate limiting на /bitrix/tools/ захищає від брутфорсу. HTTP/2 push для критичних ресурсів.

php-fpm: pm = dynamic, розрахунок pm.max_children за формулою (RAM - RAM_інших_сервісів) / avg_memory_per_process. Для Бітрікс avg зазвичай 40-80 MB. OPcache: opcache.memory_consumption=256 (стандартних 128 MB недостатньо — Бітрікс тягне тисячі файлів), opcache.max_accelerated_files=20000, opcache.validate_timestamps=0 у продакшені (скидання через cachetool opcache:reset при деплої). php.ini: memory_limit=256M (для важких операцій імпорту до 512M), max_execution_time=60, upload_max_filesize=100M. Slowlog з request_slowlog_timeout=5s знаходить вузькі місця до скарг користувачів.

Інфраструктура та автоматизація

Моніторинг, логування та резервне копіювання

Як відбувається моніторинг та реагування на інциденти? Prometheus + Grafana: метрики CPU, RAM, диска, мережі, стану сервісів. Алерти: CPU > 80% за 5 хвилин, вільна RAM < 500 MB, диск > 85%, php-fpm queue > 0. Node Exporter, MySQL Exporter, PHP-FPM Exporter збирають дані з кожного компонента. Uptime check кожні 60 секунд — алерт у Telegram за хвилину при падінні сайту. Sentry для PHP-помилок — структуровані помилки з контекстом. Моніторинг агентів Бітрікс (b_agent): завислий агент може тихо ламати обмін з 1С годинами — перевіряємо NEXT_EXEC < NOW() - INTERVAL 1 HOUR. Логування: ELK Stack або Loki + Grafana — nginx access/error, php-fpm slow log, MySQL slow query log, помилки Бітрікс. Ротація через logrotate — без неї через півроку access.log займе 50 ГБ.

Staging-середовище ідентичне production: ті ж версії nginx, PHP, MySQL, модулі, налаштування php.ini. Автоматичне оновлення при мержі у staging-гілку. Періодичний клон БД з production з знеособленням персональних даних — UPDATE b_user SET EMAIL = CONCAT('user', ID, '@test.local'), PHONE = ''. HTTP Basic Auth або IP-фільтрація. Robots.txt з Disallow: /. Sandbox-режим платіжних шлюзів для тестування оплати.

Ansible як інфраструктура як код: ansible-playbook site.yml -l production — через 15 хвилин сервер налаштований ідентично. Ролі: common (users, SSH, NTP), web (nginx + php-fpm), db (MySQL + backup), monitoring (Prometheus + exporters). Ansible забезпечує налаштування сервера за 15 хвилин замість 3 годин вручну.

Географічна розподіленість — S3-сумісне сховище + окремий сервер в іншому ЦОД. Тестове відновлення щомісяця — бекап без перевірки лише ілюзія безпеки. Cron з повідомленнями: якщо беказ не пройшов — алерт одразу.

Що входить в роботу

• Документація DevOps-процесу (схема деплою, політика гілок, опис інфраструктури)
• Налаштовані CI/CD пайплайни (GitLab CI / GitHub Actions) з робочими тригерами
• Docker-середовище (docker-compose.yml, Dockerfile, конфіги)
• Ansible-плейбуки для відтворення серверів
• Моніторинг (Grafana дашборди, алерти в Telegram/Slack)
• Захищені доступи з ролевою моделлю
• Навчання команди: два заняття з роботи з CI/CD, Docker та деплоєм
• Підтримка на етапі впровадження (два тижні після запуску)

Приклад GitLab CI для Бітрікс (фрагмент):

stages:
  - test
  - build
  - deploy

cache:
  paths:
    - vendor/

unit_tests:
  stage: test
  script:
    - composer install --no-progress
    - php vendor/bin/phpunit

deploy_staging:
  stage: deploy
  script:
    - ansible-playbook deploy.yml -l staging
  only:
    - staging

Як проходить впровадження?

1. Аудит поточного стану — оцінка інфраструктури, софту, процесів. Займає 2-3 дні.
2. Проектування архітектури — вибір стеку (Docker/K8s/Ansible), узгодження політик CI/CD, налаштування репозиторію.
3. Налаштування середовищ — Docker-середовище для локальної розробки, staging-середовище, production-сервери.
4. Реалізація CI/CD — написання пайплайнів, тестування деплою, інтеграція з моніторингом.
5. Моніторинг та алертинг — встановлення Prometheus + Grafana, налаштування дашбордів та оповіщень.
6. Навчання команди — два заняття з роботи з інструментами.

Типові терміни впровадження

DevOps — не проєкт з фінальною датою, а перехід від «закинув по FTP і молюся» до передбачуваних процесів. Кожен деплой — рутина, кожен інцидент — алерт з контекстом, кожен новий розробник — docker-compose up замість триденного налаштування середовища. Отримайте консультацію — зв'яжіться з нами, і за 2-3 дні підготуємо план впровадження. Замовте DevOps-впровадження під ключ — отримайте стабільність і контроль над інфраструктурою.