一、准备工作：服务器与域名
1.1 服务器选购建议
哪吒监控分为面板端（Dashboard）和被控端（Agent）。面板端需要部署在一台稳定的服务器上，用于收集和展示所有数据；被控端则安装在你想监控的 VPS 上。
面板端配置要求极低：
- CPU：1 核即可
- 内存：512MB 够用，1G 更从容
- 硬盘：10GB 剩余空间
- 网络：需要开放 8008（Web 访问）和 5555（Agent 通信）端口
选购建议：面板端建议选海外 VPS（如香港、美国），避免国内备案繁琐；被控端无所谓，哪里便宜买哪里。
1.2 域名准备
为了安全和方便，强烈建议准备两个子域名解析到面板服务器 IP：
- status.yourdomain.com：用于 Web 访问面板（可开启 CDN）
- agent.yourdomain.com：用于 Agent 通信（不要开 CDN，避免 WebSocket 连接问题）
二、系统安装与环境配置
2.1 安装操作系统
连接服务器 VNC 或 SSH，推荐选择 Ubuntu 22.04 LTS 或 Debian 12，社区支持好，软件源新。
登录后先更新系统：
sudo apt update && sudo apt upgrade -y
2.2 安装 Docker 环境
哪吒官方推荐 Docker 部署，一键脚本搞定：
curl -fsSL https://get.docker.com | bash -s docker && sudo systemctl enable --now docker
验证安装：
docker --version
docker-compose --version
三、部署哪吒监控面板
3.1 一键安装脚本
哪吒官方提供了极其友好的安装脚本，国内服务器可使用 Gitee 镜像加速：
海外服务器：
curl -L https://raw.githubusercontent.com/nezhahq/scripts/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 && sudoCN=true ./nezha.sh
运行后选择：
- 选择 1. 安装面板端
- 选择 1. Docker 安装方式
3.2 配置初始化
脚本会交互式询问以下信息：
| 配置项 | 说明 | 建议填写 |
|---|---|---|
| 站点标题 | 面板显示名称 | 我的监控面板 |
| 暴露端口 | Web 访问端口 | 8008（默认） |
| Agent 通信端口 | 探针连接端口 | 5555（默认） |
| 语言 | 界面语言 | zh-CN |
| OAuth 提供商 | 登录方式 | 可选 GitHub/Gitee/GitLab |
关于 OAuth 登录：哪吒不采用传统账号密码，而是通过第三方 OAuth 验证管理员身份。以 Gitee 为例：
- 访问 https://gitee.com/oauth/applications 创建应用
- 应用主页填 http://你的 IP:8008
- 回调地址填 http://你的 IP:8008/oauth2/callback
- 保存生成的 Client ID 和 Secret 填入安装脚本
3.3 访问面板
安装完成后，访问 http://服务器 IP:8008 即可看到登录界面。首次登录后务必进入右上角头像 → 个人信息 → 修改默认密码。
四、反向代理与 SSL（推荐）
裸 IP 访问不够优雅，建议使用 Nginx 或 Caddy 做反向代理并开启 HTTPS。
4.1 使用 Nginx Proxy Manager（可视化）
如果你用宝塔面板，可以直接在【网站】→【反向代理】中添加：
- 目标 URL：http://127.0.0.1:8008
- 开启 SSL，强制 HTTPS
需要额外添加 WebSocket 支持，在配置文件中插入：
location /ws {
proxy_pass http://127.0.0.1:8008;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
}
4.2 纯 Nginx 配置
server {
listen 443 ssl http2;
server_name status.yourdomain.com;
ssl_certificate /path/to/cert.pem;
ssl_certificate_key /path/to/key.pem;
location / {
proxy_pass http://127.0.0.1:8008;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
}
五、接入被监控服务器
5.1 设置 Agent 对接地址
进入面板后台 → 系统设置：
- Agent 对接地址：填写 agent.yourdomain.com:8008（或 IP:端口）
- Agent TLS：未配置证书则取消勾选
- 前端请求头：如果用 Cloudflare CDN，填 CF-Connecting-IP
5.2 安装 Agent 探针
在后台【服务器】页面点击【新增服务器】，然后点击新服务器右侧的绿色 Linux 图标复制安装命令。
在被监控服务器上执行类似如下的命令：
curl -L https://gitee.com/naibahq/scripts/raw/main/install.sh -o nezha.sh && chmod +x nezha.sh && sudoCN=true ./nezha.sh install_agent agent.yourdomain.com 8008 你的密钥 --disable-auto-update
等待安装完成，返回面板即可看到服务器上线，实时显示 CPU、内存、负载、网络流量等信息。
5.3 美化服务器信息
默认显示的服务器名是随机字符，编辑服务器在公开备注中添加 JSON 可以显示价格、到期时间、配置等信息：
{
"billingDataMod": {
"startDate": "2025-01-01 00:00:00+08:00",
"endDate": "2026-01-01 00:00:00+08:00",
"autoRenewal": "0",
"cycle": "年",
"amount": "￥120"
},
"planDataMod": {
"bandwidth": "100Mbps",
"IPv4": "1"
}
}
可以使用在线工具生成：https://nezhainfojson.pages.dev
六、进阶玩法
6.1 告警通知
在【告警】页面配置 CPU、内存、磁盘阈值，支持 Telegram、Discord、邮件、Webhook 等多种通知方式。
6.2 服务监控
除了服务器硬件，还能监控网站可用性（HTTP/TCP/Ping）、SSL 证书过期时间，适合管理多个站点。
6.3 批量命令执行
选中多台服务器，可以批量执行 Shell 命令，批量更新系统或重启服务很方便。
6.4 内网穿透
对于没有公网 IP 的 NAS 或家庭服务器，哪吒内置了基于 Cloudflare Tunnel 的内网穿透方案。
七、常见问题排查
Q: Agent 显示离线？
- 检查防火墙是否放行 5555/8008 端口
- 确认 Agent 对接地址填写正确（不要用 CDN 域名）
- 查看 Agent 日志：/opt/nezha/agent/nezha-agent.log
Q: 面板无法访问？
- 确认 Docker 容器运行中：docker ps | grep nezha
- 检查端口占用：netstat -tlnp | grep 8008
Q: WebSocket 连接失败？
- 反向代理必须开启 WebSocket 支持
- Cloudflare 需开启'WebSockets'功能
结语
哪吒监控最大的魅力在于'刚刚好'——它不像 Zabbix 那样笨重，也不像自建 Prometheus 那样复杂，一个 Docker 容器 + 一条命令就能监控全家桶。对于个人开发者和小团队，这种'开箱即用'的体验非常难得。
