全平台制霸！哪吒监控 (Nezha) 深度部署教程：让你的 VPS 集体“露脸”

如果你手头有几台甚至几十台来自不同服务商（如搬瓦工、腾讯云、甲骨文）的服务器，盯着每一个后台看状态简直是噩梦。哪吒监控 能帮你把所有服务器的 CPU、内存、带宽、丢包率等实时数据，汇聚在一个精美的仪表盘中。

---

🌟 核心亮点：为什么它是“探针”界的顶流？

• 📊 实时监控：毫秒级的状态更新，CPU、内存、硬盘、流量一目了然。
• 🔔 强大的告警系统：支持 Telegram、微信、邮件等多种方式，服务器一断线或者 CPU 暴涨，立刻通知你。
• 🛠️ 远程计划任务：通过面板一键给所有（或部分）服务器下达指令，比如集体重启、集体备份。
• 🌐 跨平台支持：无论是 Linux、Windows、macOS 甚至是 OpenWrt 路由器，都能轻松接入。
• 🛡️ 隐私与安全：完全自托管，数据不经过第三方，支持自定义主题和精美的 CSS 样式。

---

🏗️ 架构原理解析：面板 vs. 探针

哪吒监控采用 Dashboard（管理面板） 和 Agent（监控探针） 的经典架构：

1. 面板端 (Dashboard)：通常部署在你自己最稳定的一台 VPS 上，负责收集数据、展示界面和发送告警。
2. 探针端 (Agent)：部署在所有被监控的机器上，它就像一个“侦察兵”，不断向面板汇报实时军情。

🛠️ 第一阶段：Dashboard（管理面板）安装

1. 准备工作

在执行脚本前，请确保满足以下三个“硬指标”：

• 服务器配置：单核 512MB 内存即可。
• 端口开放：防火墙必须放行 8008 端口（用于面板访问和数据接收）。
• 域名准备：
  • 普通模式：一个 A 记录指向服务器 IP 的域名（如 dashboard.example.com）。
  • CDN 模式（推荐）：准备两个域名。一个走 CDN 用于公开访问（需支持 WebSocket）；另一个不走 CDN，仅用于 Agent 与 Dashboard 通信（如 data.example.com）。

2. 执行安装脚本

在服务器中运行以下官方脚本：

# 通用安装命令
curl -L https://raw.githubusercontent.com/nezhahq/scripts/refs/heads/main/install.sh -o nezha.sh && chmod +x nezha.sh && sudo ./nezha.sh

# 中国大陆服务器镜像命令
curl -L https://gitee.com/naibahq/scripts/raw/main/install.sh -o nezha.sh && chmod +x nezha.sh && sudo CN=true ./nezha.sh

安装过程中，按提示设置站点标题、暴露端口（默认 8008）和后台语言。

3. 首次登录与安全加固

• 访问路径：http://域名:8008/dashboard
• 默认凭据：用户名 admin / 密码 admin
• 🔥 必做操作：登录后立即点击头像 -> “个人信息”，修改密码（官方建议 18 位以上混合字符）。

---

🛰️ 第二阶段：Agent（监控探针）安装

1. 关键：先配置“对接地址”

在安装 Agent 之前，必须在面板中设置好通信地址，否则 Agent 无法上线：

1. 进入面板后台 -> “系统设置”。
2. 在 “Agent 对接地址” 填入你的域名和端口（如 data.example.com:8008）。
3. 点击确认保存。

2. 一键安装（Linux / Windows / macOS）

在面板的 “服务器” 页面，点击 “安装命令”。

• Linux：直接在被控端粘贴运行。
• Windows：在 PowerShell 中以管理员权限运行。
• 继承记录：如果需要重装并保留历史数据，在安装脚本前添加 env NZ_UUID=旧的UUID。

---

🏗️ 第三阶段：特殊平台手动安装 (群晖/OpenWrt/Windows)

对于不支持一键脚本或有特殊需求的平台，官方给出了手动配置方案：

1. 核心逻辑：config.yml 配置文件

无论在哪个平台手动安装，核心都是创建一个 config.yml 文件，关键字段如下：

server: data.example.com:8008  # 面板通信地址
client_secret: your_agent_secret  # 对应的 Agent 密钥
uuid: your_uuid  # 唯一标识符

2. 不同平台的进阶部署

• 群晖 (DSM 7)：下载对应架构（amd64/arm）的二进制文件，创建 systemctl 服务文件实现自启动。
• OpenWrt：通过 opkg 安装必要工具，创建 /etc/init.d/nezha-service 脚本实现开机自启。
• Windows 手动：下载二进制文件，配置 config.yml，使用 nezha-agent.exe service install 将其注册为系统服务。

---

🔄 维护与卸载

• 更新面板/Agent：再次运行 ./nezha.sh（面板）或 ./agent.sh（Agent），选择更新即可。
• 完全卸载 Agent (Linux)：cd /opt/nezha/agent/ ./nezha-agent service uninstall rm -rf /opt/nezha/agent/

🎨 进阶技巧：如何让你的探针更漂亮？

哪吒监控支持自定义代码，你可以前往官方论坛或 GitHub 寻找 “哪吒监控美化主题”：

• CSS 修改：可以实现毛玻璃效果、动态背景或者是二次元背景。
• 服务监控：不仅能看机器性能，还能监控特定的 HTTP 接口是否正常。

---

📝 总结评价

✅ 优点：

• 资源占用极低：Agent 客户端几乎不吃 CPU 和内存。
• 部署极简：官方脚本自动化程度极高。
• 社区活跃：有问题在 GitHub 或 TG 群里反馈，响应非常快。

---

🔗 资源导航

资源类别	链接地址
官方文档	nezha.wiki
GitHub 仓库	naiba/nezha