Схема работы

 -----------------------                                   ---------------------------------------------------
| nginx: 0.0.0.0:80     | -> /bitrix/sub|/bitrix/subws -> | node server.js --config push-server-sub-80XX.json |
 -----------------------                                   ---------------------------------------------------

 -----------------------                     ---------------------------------------------------
| nginx: 127.0.0.1:8895 | -> /bitrix/pub -> | node server.js --config push-server-pub-90XX.json |
 -----------------------                     ---------------------------------------------------

Nginx проксирует запрос на push-сервис выбранного типа. Запросы получения сообщений (например, sub) — публичные, проксируются со стандартных портов 80/443. Запросы публикации (pub) — доступны только с внутреннего адреса сервера.

Nodejs-процессы делятся на два типа:

1. Процессы, отвечающие за подключение пользователя к выбранному каналу и получение им сообщений. Слушают порты 8010-8015.
2. Процессы, отвечающие за отправку сообщения в канал. Слушают порты 9010-9011.

Для запуска Push-сервера необходимы:

• nodejs & npm;
• архив сервиса и его модулей.

Выполните следующие действия:

1. Скачайте и установите архив push-server-0.3.0.tgz:

   su -
   cd /opt
   wget https://repo.bitrix.info/vm/push-server-0.3.0.tgz
   npm install --omit=dev ./push-server-0.3.0.tgz
   

   Примечание. Если репозиторий repo.bitrix.info недоступен, скачайте архив push-server-0.3.0.tgz и разместите его в директории /opt. Далее выполните установку:

   su -
   cd /opt
   npm install --production ./push-server-0.3.0.tgz
   

   Установка закончится строкой:

   added 1 package in 2m
   
   16 packages are looking for funding
     run `npm fund` for details
   

2. Для удобства дальнейшей работы выполните команды:

   su -
   ln -sf /opt/node_modules/push-server/etc/push-server /etc/push-server

3. Скопируйте файлы сервиса и основную конфигурацию:

   su - 
   cd /opt/node_modules/push-server
   cp etc/init.d/push-server-multi /usr/local/bin/push-server-multi
   cp etc/sysconfig/push-server-multi  /etc/sysconfig/push-server-multi
   cp etc/push-server/push-server.service  /etc/systemd/system/
   ln -sf /opt/node_modules/push-server /opt/push-server

4. В конфигурационном файле /etc/sysconfig/push-server-multi исправьте (или добавьте, если их нет) следующие параметры:
   • SECURITY_KEY — секретный ключ для подписи соединения между клиентом и пуш-сервером;
     Примечание. Длина ключа не имеет значения. В ключе можно использовать только буквы латинского алфавита и цифры (спецсимволы запрещены). Но имейте в виду, что простой короткий ключ небезопасен. Можно генерировать его, например, таким образом:

     cat /dev/urandom |tr -dc A-Za-z0-9 | head -c 128

   • RUN_DIR — директория для хранения PID файлов процесса;
   • USER/GROUP — пользователь, под которым будет запущен сервис.

   Пример настроек параметров:

   USER=bitrix
   GROUP=apache
   SECURITY_KEY="PUTTHEPRIVATEKEYHERE"
   RUN_DIR=/tmp/push-server

5. Создайте пользователя:

   su -
   useradd -g apache bitrix
   

6. Каждый nodejs-процесс будет запущен как отдельный процесс. Сгенерируйте конфигурации:

   /usr/local/bin/push-server-multi configs pub
   /usr/local/bin/push-server-multi configs sub
   

   Сгенерированные конфигурации в формате json push-server-sub-80XX.json
   push-server-pub-90XX.json будут размещены в каталоге: /etc/push-server/.

7. Создайте каталог через tmpfiles.d:

   echo 'd /tmp/push-server 0770 bitrix apache -' > /etc/tmpfiles.d/push-server.conf
   systemd-tmpfiles --remove --create

8. Создайте каталог логов:

   [[ ! -d /var/log/push-server ]] && mkdir /var/log/push-server
   chown bitrix:apache /var/log/push-server

9. Измените пользователя и путь к скрипту запуска в конфигурационном файле сервиса /etc/systemd/system/push-server.service:

   [Service]
   User=bitrix
   Group=apache
   ExecStart=/usr/local/bin/push-server-multi systemd_start
   ExecStop=/usr/local/bin/push-server-multi stop
   ...
   

10. Переконфигурируйте:

    systemctl daemon-reload
    

11. Запустите сервис:

    systemctl --now enable push-server
    

12. Перейдите в конфигурацию Push-модуля (настройки сайта) и включите использование локального Push-сервера (последняя версия). Укажите секретный ключ, который настраивали ранее в файле /etc/sysconfig/push-server-multi.