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