哪吒探针（Nezha Monitor）部署完全指南

type

status

date

slug

summary

功能特性

✅ 支持多服务器监控

✅ 实时监控 CPU、内存、硬盘、网络等

✅ 网络延迟和丢包率监控

✅ SSL 证书到期监控

✅ HTTP(S)/TCP/Ping 监控

✅ 多种告警方式（Telegram、邮件、Webhook 等）

✅ WebSSH 终端

✅ 定时任务和批量执行命令

✅ DDNS 支持

✅ 流量统计

系统要求

Dashboard（面板端）

操作系统：Linux（推荐 Ubuntu 20.04+）

内存：至少 200MB RAM

存储：至少 1GB 可用空间

Docker：Docker Engine 26+（推荐使用 Docker 部署）

域名：用于访问面板（建议准备两个域名，一个用于 CDN 访问，一个用于 Agent 通信）

Agent（客户端）

操作系统：Linux、Windows、macOS、OpenWRT、群晖等

内存：占用极少（约 10-20MB）

准备工作

1. 域名配置

准备两个域名（或子域名）：

访问域名：dashboard.example.com（可配置 CDN）

通信域名：data.example.com（不要使用 CDN）

将两个域名的 A 记录都指向 Dashboard 服务器 IP。

2. OAuth 应用配置

哪吒监控使用 GitHub、GitLab 或 Gitee 作为管理员登录方式。

GitHub OAuth 配置

点击「OAuth Apps」→「New OAuth App」

填写配置：

Application name：Nezha Monitor

Homepage URL：https://dashboard.example.com

Authorization callback URL：https://dashboard.example.com/oauth2/callback

点击「Register application」

记录 Client ID 和生成 Client Secret（只显示一次）

Docker 部署 Dashboard

方法一：使用一键脚本（推荐）

安装过程中需要配置：

选择安装方式：选择 Docker

输入面板标题：例如「我的监控面板」

输入暴露端口：默认 8008（用于 Agent 通信）

输入访问端口：默认 80（面板访问端口）

OAuth 配置：

OAuth 提供商：选择 github

Client ID：输入刚才获取的 Client ID

Client Secret：输入 Client Secret

管理员列表：输入 GitHub 用户名

方法二：Docker Compose 部署

创建工作目录：

创建 docker-compose.yml：

启动服务：

配置反向代理（可选）

使用 Nginx

创建 Nginx 配置文件 /etc/nginx/sites-available/nezha：

启用配置并申请 SSL 证书：

初始配置

1. 访问面板

通过浏览器访问：https://dashboard.example.com

点击右上角「登录」，使用 GitHub 账号授权登录。

2. 配置通信域名

登录后，点击头像 → 「系统设置」：

Agent 连接地址：填写 data.example.com:8008

点击「保存」

安装 Agent（客户端）

Linux 一键安装

在面板「服务器」页面，点击「安装命令」

选择操作系统（Linux）

安装命令会自动复制到剪贴板

在客户端服务器执行命令

命令示例：

Windows 安装

下载 Agent：GitHub Releases

解压到目录（如 C:\nezha-agent）

以管理员身份运行 PowerShell：

设置为服务自启动：

功能配置

1. 服务监控

在「服务」页面添加监控项：

HTTP(S) 监控：

名称：网站名称

监控地址：https://example.com

监控类型：HTTP-GET

检查频率：60 秒

通知组：选择或创建

TCP 端口监控：

名称：SSH 端口

监控地址：服务器IP:22

监控类型：TCP-PING

2. 告警配置

在「告警」→「通知方式」添加：

Telegram 通知

在 Telegram 搜索 @BotFather 创建 Bot

获取 Bot Token

向 @userinfobot 发送消息获取 Chat ID

在面板添加 Telegram 通知方式

邮件通知

SMTP 服务器：smtp.gmail.com

端口：587

用户名：邮箱地址

密码：应用专用密码

3. 定时任务

在「任务」页面创建定时任务：

任务名称：数据库备份

Cron 表达式：0 2 * * *（每天凌晨 2 点）

命令：/backup/script.sh

执行服务器：选择目标服务器

面板美化（可选）

自定义 CSS

在「设置」→「自定义代码」中添加：

自定义 JavaScript

升级

Dashboard 升级

Agent 升级

常见问题

1. Agent 无法连接

问题：Agent 显示离线

解决：

2. WebSocket 连接失败

问题：面板实时数据不更新

解决：

检查 CDN 是否支持 WebSocket

确认 Nginx 配置了 WebSocket 支持

尝试关闭 CDN 测试

3. OAuth 登录失败

问题：GitHub 授权后无法登录

解决：

检查回调 URL 是否正确

确认 Client ID 和 Secret 正确

查看 Dashboard 日志：docker logs nezha-dashboard

总结

通过本教程，您已经学会了：

✅ 部署哪吒监控 Dashboard 和 Agent ✅ 配置 OAuth 登录和通信域名 ✅ 设置服务监控和告警通知 ✅ 配置定时任务和批量命令 ✅ 自定义面板样式 ✅ 处理常见问题

哪吒监控提供了强大而轻量的服务器监控方案，让您轻松掌握所有服务器的运行状态。祝您使用愉快！📊