离线环境手动安装哪吒探针 Agent（使用 config.yml 配置文件篇）

在无法直连 GitHub 的服务器上，官方的一键脚本往往会失效。本文将教你如何通过手动上传二进制文件并结合 config.yml 配置文件，在 Debian/Ubuntu 等 Linux 系统上部署哪吒 Agent。

---

一、 准备工作

1. 下载程序：在本地能联网的电脑上，从 Nezha Releases 下载对应架构的包（如 nezha-agent_linux_amd64.zip）。

2. 上传文件：通过 SCP 或 FTP 将压缩包上传至服务器的 /opt/nezha/agent 目录。

3. 解压并授权：

   Bash

   mkdir -p /opt/nezha/agent
   cd /opt/nezha/agent
   unzip nezha-agent_linux_amd64.zip
   chmod +x nezha-agent
   

---

二、 创建配置文件 config.yml

在 /opt/nezha/agent 目录下手动创建一个名为 config.yml 的文件。这种方式比直接写在命令行中更安全，也方便后期管理。

Bash

vi /opt/nezha/agent/config.yml

写入以下标准配置内容（根据你的面板信息修改）：

YAML

client_secret: "你的Agent密钥"
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: 3
self_update_period: 0
server: "面板域名或者面板域名:443或IP:5555"
skip_connection_count: false
skip_procs_count: false
temperature: false
tls: true
use_gitee_to_upgrade: false
use_ipv6_country_code: false
uuid: "自行生成的uuid"

提示：如果你的面板没有开启 SSL/TLS，请将 tls: true 改为 false。

---

三、 创建 Systemd 服务脚本

现在我们需要创建一个系统服务来运行 Agent，并指定使用刚才创建的配置文件。

Bash

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

粘贴以下内容：

Ini, TOML

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

[Service]
Type=simple
User=root
# 使用 -c 参数指向配置文件路径
ExecStart=/opt/nezha/agent/nezha-agent -c /opt/nezha/agent/config.yml
Restart=always
RestartSec=5
# 限制资源占用（可选）
MemoryLimit=100M

[Install]
WantedBy=multi-user.target

---

四、 激活并设置开机启动

执行以下命令让配置生效并立即运行：

Bash

# 1. 刷新 systemd 缓存
systemctl daemon-reload

# 2. 设置开机自动启动
systemctl enable nezha-agent

# 3. 立即启动服务
systemctl start nezha-agent

# 4. 检查运行状态
systemctl status nezha-agent

---

五、 日志维护与排错

如果面板上的小鸡没有亮起（显示离线），可以通过以下命令排查：

• 查看实时运行日志：

  Bash

  journalctl -u nezha-agent -f
  

• 修改配置后生效： 如果你修改了 config.yml 里的密钥或地址，只需要重启服务即可：

  Bash

  systemctl restart nezha-agent
  

---

💡 为什么选择 config.yml 方案？

1. 安全性：密钥保存在配置文件中，不会在 ps -ef 进程查看到明文密钥。

2. 易维护：更换面板地址或密钥时，直接编辑 YAML 文件即可，无需修改并重载 Systemd 服务。

3. 一致性：这与 OpenWrt 等平台的配置逻辑保持一致，方便多平台管理。