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