准备工作

1. 你的机器能够与面板正常通信

2. 你能够访问Github

安装Agent

下载哪吒agent

确定cpu架构

使用以下命令获取设备的架构信息：

uname -m

常见架构对应关系：

x86_64 对应 amd64

armv7l 或 aarch64 对应 arm

下载适配的二进制文件

访问 Github

根据设备架构选择正确的下载链接。例如，对于 amd64 架构，下载nezha-agent_linux_amd64.zip

上传并解压文件

将下载的文件上传至/tmp

执行下面的命令

cd /tmp 
mkdir -p /opt/nezha/agent
unzip nezha-agent_linux_amd64.zip -d /opt/nezha/agent # 这行命令根据自己上传的文件修改
chmod +x /opt/nezha/agent/nezha-agent

创建配置文件

创建并编辑配置文件

在 /opt/nezha/agent 目录下创建 config.yml 文件，并添加以下内容：

client_secret: your_agent_secret
debug: false
disable_auto_update: false
disable_command_execute: false
disable_force_update: false
disable_nat: false
disable_send_query: false
gpu: false
insecure_tls: false
ip_report_period: 1800
report_delay: 1
server: data.example.com:8008
skip_connection_count: false
skip_procs_count: false
temperature: false
tls: false
use_gitee_to_upgrade: false
use_ipv6_country_code: false
uuid: your_uuid

字段说明：

• server：替换为 Dashboard 地址和端口，如 data.example.com:8008。

• client_secret：替换为 Dashboard 配置文件中的 agentsecretkey，路径通常为 /opt/nezha/dashboard/data/config.yaml。

• uuid：为该 Agent 生成一个唯一标识符，不要与同一个 Dashboard 中其他的 Agent 重复，可使用 uuidgen 命令生成：

保存文件

将文件保存至 /opt/nezha/config.yml。

创建 systemctl 服务文件

执行下面命令

nano /etc/systemd/system/nezha-agent.service

添加以下内容

[Unit]
Description=Nezha Agent
After=network.target

[Service]
Type=simple
User=root
Group=root
ExecStart=/opt/nezha/agent/nezha-agent -c /opt/nezha/agent/config.yml
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target

保存文件并重新加载服务配置

systemctl daemon-reload

清理安装文件

rm -rf /tmp/*

启动 Agent​

启动服务
使用以下命令启动 Agent：

systemctl start nezha-agent

设置开机自启动

systemctl enable nezha-agent

查看服务状态

systemctl status nezha-agent

验证 Agent 连接​

1. 登录 Dashboard，检查是否有新设备上线。

2. 如果服务运行正常且日志中无报错，则安装完成。

卸载 Agent

卸载 Agent 包括停止服务、卸载服务，以及删除相关文件。以下是 Debian/Ubuntu 系统的卸载步骤：

停止并卸载服务

cd /opt/nezha/agent/
./nezha-agent service uninstall

删除 Agent 文件夹

rm -rf /opt/nezha/agent/

文章部分内容来自哪吒探针官方文档