Перейти к основному содержимому

Развертывание и обновление в виде службы

Зарегистрировав clmBot как системную службу, вы обеспечите постоянную работу серверной части clmBot и её автоматический запуск при старте системы. Это подходит для серверов, использующих облачную доставку. На этой странице также рассмотрены горячая перезагрузка конфигурации, журналы выполнения и обновление клиента.

Регистрация в качестве системной службы​

Предварительное условие: подключение с помощью login должно быть завершено по краткому руководству.

Выполните следующую команду, чтобы зарегистрировать серверную часть clmBot как системную службу:

./clm-bot-linux-amd64 server --service install -a="0.0.0.0:8862"

Инструкции по регистрации:

  • На Linux регистрируется как служба systemd, на Windows — как одноимённая служба Windows; в обоих случаях поддерживается автозапуск при загрузке системы.
  • Имя службы — ssltrus-clm-bot-<节点ID>-<端口>, идентификатор узла — это clmBot ID, назначенный при подключении.
  • Служба работает в соответствии с файлом конфигурации и адресом прослушивания, указанными при установке; рабочим каталогом является каталог, в котором находится файл конфигурации.

Если необходимо установить службу от имени текущего вошедшего пользователя, а не на уровне системы, можно добавить параметр --user.

Управление службой​

Управление службой осуществляется через server --service <动作>:

./clm-bot-linux-amd64 server --service status    # 查看服务状态
./clm-bot-linux-amd64 server --service start # 启动服务
./clm-bot-linux-amd64 server --service stop # 停止服务
./clm-bot-linux-amd64 server --service restart # 重启服务
./clm-bot-linux-amd64 server --service uninstall # 卸载服务(卸载前自动停止)

Горячая перезагрузка конфигурации​

На стороне сервера clmBot горячая перезагрузка конфигурации включена по умолчанию (--watch, включено по умолчанию): после изменения config.yaml конфигурация будет автоматически перезагружена, перезапуск службы не требуется.

Если необходимо отключить горячую перезагрузку, можно явно указать --watch=false при запуске.

Просмотр журналов работы​

Журнал работы clmBot находится в logs/clm-bot.log в каталоге, где расположен файл конфигурации. Содержимое, выводимое в консоль, также записывается в этот файл.

Автоматическая ротация файлов журнала:

  • Максимальный размер одного файла журнала — 30 МБ.
  • Хранение за последние 90 дней.
  • Не более 10 резервных файлов.

Обновление clmBot​

Выполните следующую команду для проверки и обновления до последней версии:

./clm-bot-linux-amd64 update

После выполнения clmBot проверит последнюю версию текущей платформы из официального источника выпуска:

  • Если уже установлена последняя версия, выводится текущий номер версии, и процесс пропускается.
  • Если доступна новая версия, она автоматически загружается, проверяется целостность файла (SHA-256), и текущий исполняемый файл заменяется.

Просмотр текущей версии клиента:

./clm-bot-linux-amd64 --version
Примечание

После завершения обновления, если clmBot работает как системная служба, выполните server --service restart, чтобы новая версия вступила в силу.

Встроенный командный терминал Windows​

На сервере Windows запуск исполняемого файла clmBot без параметров открывает встроенный командный терминал. Этот терминал поддерживает только подкоманды clmBot. Введите help, чтобы просмотреть команды, и введите exit, чтобы выйти. Подходит для использования в ограниченных средах эксплуатации.