哪吒监控完整部署教程：从零搭建服务器监控系统
概述
哪吒监控是一款开源的服务器监控工具，由Dashboard（主控端）和Agent（被控端）组成。本文将详细介绍如何从零开始部署完整的哪吒监控系统。
系统架构
Dashboard: 主控端，用于集中显示和管理所有被监控服务器
Agent: 被控端，安装在被监控服务器上，负责收集数据并上报
第一部分：Dashboard部署
准备工作
服务器要求
公网可访问的服务器
单核CPU、512MB内存即可满足基本需求
防火墙放行8008端口
域名准备
主域名：用于面板访问（如
dashboard.example.com）通信域名：用于Agent连接（如
data.example.com），不建议接入CDN
安装步骤
# 下载安装脚本
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，可自定义
后台语言：选择界面语言
安装完成后，通过http://dashboard.example.com:8008访问面板。
安全设置
首次登录使用默认账号密码（admin/admin），务必立即修改：
点击右上角头像 → "个人信息" → "更新个人资料"
设置强密码（建议18位以上，包含大小写字母、数字和符号）
反向代理配置（可选）
如需通过域名直接访问，可配置Nginx反向代理：
server {
listen 80;
server_name dashboard.example.com;
location / {
proxy_pass http://127.0.0.1:8008;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
}第二部分：Agent部署
通用准备工作
在Dashboard中配置Agent通信地址：
进入"系统设置"
在"Agent对接地址"中填入：
data.example.com:8008保存设置
Linux系统安装
方法一：一键安装（推荐）
在Dashboard的"服务器"页面：
点击"安装命令"
选择Linux操作系统
复制命令到目标服务器执行
方法二：手动安装
# 1. 下载对应架构的Agent
wget -O nezha-agent.zip https://github.com/nezhahq/agent/releases/latest/download/nezha-agent_linux_amd64.zip
# 2. 解压文件
mkdir -p /opt/nezha
unzip nezha-agent.zip -d /opt/nezha
chmod +x /opt/nezha/nezha-agent
# 3. 创建配置文件
cat > /opt/nezha/config.yml << EOF
client_secret: your_agent_secret
server: data.example.com:8008
uuid: $(uuidgen)
EOF
# 4. 创建systemd服务
cat > /etc/systemd/system/nezha-agent.service << EOF
[Unit]
Description=Nezha Agent
After=network.target
[Service]
Type=simple
User=root
ExecStart=/opt/nezha/nezha-agent -c /opt/nezha/config.yml
Restart=always
RestartSec=5
[Install]
WantedBy=multi-user.target
EOF
# 5. 启动服务
systemctl daemon-reload
systemctl enable nezha-agent
systemctl start nezha-agentWindows系统安装
方法一：PowerShell一键安装
以管理员身份运行PowerShell，执行Dashboard生成的安装命令。
方法二：手动安装
下载Windows版Agent：
nezha-agent_windows_amd64.zip解压到
C:\nezha目录创建
config.yml配置文件安装为服务：
cd C:\nezha
.\nezha-agent.exe service install群晖NAS安装
# 1. 确定架构
uname -m
# 2. 下载对应版本
wget -O nezha-agent.zip https://github.com/nezhahq/agent/releases/latest/download/nezha-agent_linux_amd64.zip
# 3. 解压并配置（步骤同Linux）OpenWrt路由器安装
# 1. 安装依赖
opkg update
opkg install wget unzip
# 2. 下载安装（步骤同Linux）
# 3. 创建开机自启动脚本第三部分：配置说明
配置文件详解
client_secret: "Dashboard中的agentsecretkey"
server: "data.example.com:8008" # Dashboard地址
uuid: "唯一标识符" # 可使用uuidgen生成
disable_auto_update: false # 是否禁用自动更新
disable_command_execute: false # 是否禁用命令执行
tls: false # 是否启用TLS加密重要参数说明
client_secret: 在Dashboard的
/opt/nezha/dashboard/data/config.yaml中查找uuid: 每个Agent必须唯一，重复会导致数据混乱
server: 支持IPv4、IPv6格式
第四部分：验证与排查
检查Agent状态
# Linux系统
systemctl status nezha-agent
# 查看日志
journalctl -u nezha-agent -fDashboard验证
登录Dashboard查看是否有新服务器上线
检查服务器状态是否正常
验证各项监控指标是否正常显示
常见问题排查
Agent无法连接
检查防火墙是否放行8008端口
验证client_secret是否正确
确认server地址可访问
监控数据异常
检查Agent版本是否最新
查看系统资源使用情况
验证配置文件参数
第五部分：维护与更新
Dashboard更新
./nezha.sh
# 选择重启面板并更新Agent更新
Agent支持自动更新，也可手动下载新版本替换。
卸载Agent
# 停止服务
systemctl stop nezha-agent
# 卸载服务
systemctl disable nezha-agent
# 删除文件
rm -rf /opt/nezha进阶功能
报警通知
配置Telegram机器人实现异常报警：
在Dashboard中配置机器人Token
设置报警规则和接收群组
多节点监控
部署多个Dashboard实现分布式监控，提高系统可靠性。
总结
哪吒监控是一款功能强大、部署简单的服务器监控解决方案。通过本教程，您可以快速搭建完整的监控系统，实时掌握服务器运行状态。建议定期检查更新，确保系统安全稳定运行。
本文根据哪吒监控官方文档整理，具体部署时请以实际环境为准。