Saltar al contenido principal

Implementación y actualización como servicio

Registrar clmBot como servicio del sistema permite que el servidor de clmBot se ejecute de forma persistente y se inicie automáticamente con el sistema, lo cual es adecuado para servidores que utilizan el método de envío en la nube. Esta página también presenta la recarga en caliente de la configuración, los registros de ejecución y la actualización del cliente.

Registrar como servicio del sistema​

Requisito previo: haber completado la integración de login según la Guía de inicio rápido.

Ejecute el siguiente comando para registrar el servidor de clmBot como un servicio del sistema:

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

Notas de registro:

  • En Linux, se registra como un servicio systemd; en Windows, se registra como un servicio de Windows con el mismo nombre. Ambos admiten inicio automático al arrancar.
  • El nombre del servicio es ssltrus-clm-bot-<节点ID>-<端口>, y el ID del nodo es el clmBot ID asignado durante la conexión.
  • El servicio se ejecuta según el archivo de configuración y la dirección de escucha especificados durante la instalación, y el directorio de trabajo es aquel donde se encuentra el archivo de configuración.

Si desea instalar el servicio con el usuario actualmente conectado (en lugar de a nivel de sistema), puede añadir el parámetro --user.

Administrar el servicio​

Administre el servicio mediante 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 # 卸载服务（卸载前自动停止）

Configuración de recarga en caliente​

El servidor de clmBot tiene habilitada por defecto la recarga de configuración en caliente (--watch, activada de forma predeterminada): tras modificar config.yaml, la configuración se recargará automáticamente sin necesidad de reiniciar el servicio.

Si desea desactivar la recarga en caliente, puede especificar explícitamente --watch=false al iniciar.

Consultar los registros de ejecución​

Los registros de ejecución de clmBot se encuentran en el directorio donde está el archivo de configuración, en logs/clm-bot.log; el contenido mostrado en la consola también se registrará en ese archivo.

Rotación automática de los archivos de registro:

  • Tamaño máximo de un archivo de registro individual: 30 MB.
  • Conservación de los últimos 90 días.
  • Máximo de 10 archivos de respaldo conservados.

Actualizar clmBot​

Ejecute el siguiente comando para comprobar y actualizar a la última versión:

./clm-bot-linux-amd64 update

Después de la ejecución, clmBot verificará la versión más reciente de la plataforma desde la fuente de lanzamiento oficial:

  • Si ya está en la versión más reciente, mostrará el número de versión actual y omitirá la actualización.
  • Si hay una nueva versión, descargará automáticamente y verificará la integridad del archivo (SHA-256), reemplazando el archivo ejecutable actual.

Ver la versión actual del cliente:

./clm-bot-linux-amd64 --version
Nota

Una vez completada la actualización, si clmBot se está ejecutando como servicio del sistema, ejecute server --service restart para que la nueva versión surta efecto.

Terminal de comandos integrada de Windows​

En servidores Windows, ejecutar directamente el archivo ejecutable de clmBot sin parámetros abre la terminal de comandos integrada. Esta terminal solo puede ejecutar subcomandos de clmBot; introduzca help para ver los comandos e introduzca exit para salir. Resulta adecuada para entornos de operación y mantenimiento con restricciones.

Última actualización en