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

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

После регистрации 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, чтобы выйти. Подходит для использования в средах с ограниченными возможностями эксплуатации.