whoer/nezha-agent

Nezha Agent 监控代理镜像

镜像概述

whoer/nezha-agent是Nezha Agent的Docker镜像，用于连接Nezha监控面板，实现对服务器CPU、内存、磁盘、网络等状态信息的实时监控。该镜像支持通过命令参数配置连接方式，提供TLS加密保障，并具备灵活的日志管理和自动恢复能力，适用于需要远程监控服务器资源的场景。

核心功能和特性

• 连接监控面板：通过GRPC协议与Nezha监控服务器通信，实时上报服务器状态数据
• TLS加密支持：默认启用TLS加密连接，保障数据传输安全；若监控服务器未配置证书，可移除--tls参数
• 灵活配置：支持通过命令参数和环境变量自定义服务器地址、客户端密钥等关键配置
• 日志管理：采用json-file日志驱动，限制单日志文件大小（10M）和文件数量（3个），并支持日志压缩
• 自动恢复：配置unless-stopped重启策略，确保服务异常退出后自动恢复运行

使用场景和适用范围

适用于需要远程监控服务器资源状态的场景，包括但不限于：

• 个人服务器/云主机的远程状态监控
• 多服务器集群的集中化监控管理
• 运维团队对服务器资源的实时监控与告警
• 需轻量化部署监控代理的边缘计算节点

使用方法和配置说明

docker-compose配置示例

yaml
version: '3'
services:
  nezha-agent:
    image: whoer/nezha-agent
    container_name: nezha-agent
    restart: unless-stopped
    network_mode: host
    command: --tls -s ${NZ_GRPC_URL} -p ${NZ_CLENT_SECRET}
    logging:
      driver: "json-file"
      options:
        max-size: "10m"
        max-file: "3"
        compress: "true"

环境变量说明

命令参数说明

部署示例

docker-compose部署

1. 创建.env文件配置环境变量：

   env
   NZ_GRPC_URL=grpc://monitor.example.com:5555
   NZ_CLENT_SECRET=your_client_secret_here
   

2. 使用上述docker-compose配置文件启动服务：

   bash
   docker-compose up -d
   

docker run部署

bash
docker run -d \
  --name nezha-agent \
  --restart unless-stopped \
  --net=host \
  whoer/nezha-agent \
  --tls -s grpc://monitor.example.com:5555 -p your_client_secret_here

注意事项

• 证书配置：若Nezha监控服务器未配置TLS证书，启动命令中必须移除--tls参数，否则会导致连接失败
• 网络模式：默认使用host网络模式以确保正确获取服务器网络信息，自定义网络时需确保GRPC端口映射正确
• 环境变量替换：docker-compose配置中的${NZ_GRPC_URL}和${NZ_CLENT_SECRET}需替换为实际值，可通过.env文件或系统环境变量传入
• 默认参数：镜像默认命令包含--skip-procs（跳过进程监控）和--disable-command-execute（禁用命令执行），如需启用相关功能需在启动命令中显式修改参数