Agent 配置
Agent 配置文件格式为 YAML。
在管理后台中,可以对 Agent 的配置进行修改并直接应用;也可以通过 API 批量下发配置项,详见 API 文档。
选项
client_secret
- 用于与 Dashboard 进行安全通信的客户端密钥。
- 此参数必须与 Dashboard 中的配置相同,否则 Agent 无法正常与服务器通信。
debug
- 当为
true
时启用日志。
- 当为
disable_auto_update
- 当为
true
时禁用 Agent 的自动更新功能,增强系统稳定性和安全性。
- 当为
disable_command_execute
- 当为
true
时 Agent 不再接受面板下达的 命令执行、在线终端 和 文件列表 任务。
- 当为
disable_force_update
- 当为
true
时禁用强制更新功能,仅允许手动更新。
- 当为
disable_nat
- 当为
true
时 Agent 不再接受面板下达的 内网穿透 任务。
- 当为
disable_send_query
- 当为
true
时 Agent 不再接受面板下达的TCP Ping
、ICMP Ping
和HTTP GET
任务。
- 当为
gpu
- 当为
true
时启用 GPU 监控。 - 注意:启用 GPU 监控可能需要安装额外依赖,详细信息参考:启用 GPU 监控。
- 当为
insecure_tls
- 当为
true
时禁用证书检查,适用于使用自签名证书的场景。
- 当为
ip_report_period
- 设置本地 IP 更新间隔时间(秒)。默认值为
1800
秒(30 分钟)。 - 最低有效值为 30 秒。
- 设置本地 IP 更新间隔时间(秒)。默认值为
report_delay
- 设置系统信息上报的时间间隔(秒)。默认值为
3
秒(有效范围:1-4 秒)。
- 设置系统信息上报的时间间隔(秒)。默认值为
server
- 与 Dashboard 通信的域名或 IP 地址,需包括端口号。
skip_connection_count
- 当为
true
时禁用网络连接数的监控,适用于高连接数或资源受限的环境。
- 当为
skip_procs_count
- 当为
true
时禁用进程数的监控,以降低资源占用。
- 当为
temperature
- 当为
true
时启用硬件温度监控(仅支持部分硬件,部分 VPS 可能无法获取温度信息)。
- 当为
tls
- 当为
true
时启用 Agent 与 Dashboard 间的通信 SSL/TLS 加密。 - 如果 Agent 使用 Nginx 反向代理且启用了 SSL/TLS 配置,请开启此选项。
- 当为
hard_drive_partition_allowlist
- 一个字符串数组,用于指定需要监控的硬盘分区列表。
- 若指定此参数,将仅对列出的分区进行监控。
nic_allowlist
- 一个
map[string]bool
类型的允许列表,用于指定需要监控的网卡。 - 键为网卡名称,值为
true
表示允许监控,false
表示不监控。 - 若不指定或为空,则默认监控所有可用网卡。
- 一个
use_gitee_to_upgrade
- 当为
true
时使用 Gitee 仓库作为自动更新源,对中国大陆服务器更为友好。
- 当为
use_ipv6_country_code
- 当为
true
时强制使用 IPv6 地址查询国家代码(默认使用 IPv4)。
- 当为
uuid
- 当前 Agent 的唯一标识参数,用于 Dashboard 识别数据来源。
- 若需替换 Dashboard 中已存在的 Agent,可以手动设置此参数。
dns
- 一个字符串数组,用于设置自定义 DNS 服务器列表。
- 指定后,Agent 将优先使用此列表中的 DNS 服务器解析域名。
custom_ip_api
- 一个字符串数组,用于指定自定义 IP 查询 API 列表。
- Agent 将通过这些 API 获取服务器的公网 IP 信息。
self_update_period
- 手动设置更新间隔(分钟)。
- 默认为 30 到 90 之间的随机值。
应用
在修改配置文件中的参数后,需要重新启动 Agent 服务以使更改生效。可以使用 Agent 的内置服务管理功能或者手动重启。
使用内置服务管理
可以直接输入以下命令重启默认 Agent 服务:
shell
./agent service restart
对于多个 Agent 服务的情况,可以指定对应的配置文件:
shell
./agent service -c ./config-6sc1f.yml restart
手动管理
重新启动服务
运行以下命令重新启动默认的第一个 Agent 服务:shellsudo systemctl restart nezha-agent.service
多 Agent 服务的情况
如果同一服务器上运行了多个 Agent 服务,请先列出所有 Agent 服务的名称:shellsudo systemctl list-units --type=service | grep nezha-agent
然后分别使用以下命令重新启动对应的 Agent 服务:
shellsudo systemctl restart <service-name>
将
<service-name>
替换为实际的服务名称,例如nezha-agent@2.service
。