193  /  265

Конфигурация Push-server

Просмотров: 12100
Дата последнего изменения: 30.05.2024

Схема работы

 -----------------------                                   ---------------------------------------------------
| 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.


1
Курсы разработаны в компании «1С-Битрикс»

Если вы нашли неточность в тексте, непонятное объяснение, пожалуйста, сообщите нам об этом в комментариях.
Развернуть комментарии