共计 1958 个字符,预计需要花费 5 分钟才能阅读完成。
一键安装
支持一键安装面板和监控服务,操作便捷。兼容主流系统,包括 Linux、Windows、macOS、OpenWRT 以及群晖。
实时监控
支持同时监控多个服务器的状态,提供历史网络状态和延迟图表,监控网页、端口可用性和 SSL 证书状态。支持故障和流量等状态告警,可通过 Telegram、邮件、微信等多种方式提醒。
轻松运维
提供 API 获取服务器状态,支持 WebSSH、DDNS 和流量监控。可设置定时和触发任务,并批量执行服务器任务。
安装 Dashboard
准备工作
搭建哪吒监控的 Dashboard,你需要:
- 一台可以连接公网的服务器。防火墙和安全策略需放行 8008 端口,否则无法访问或接收数据。单核 512MB 内存的服务器即可满足大多数使用场景。
- 一个已设置好 A 记录,指向 Dashboard 服务器 IP 的域名。
如果你想使用 CDN,请准备两个域名:
- 一个配置好 CDN,用作公开访问,CDN 需支持 WebSocket 协议;
- 另一个域名不使用 CDN,用作 Agent 与 Dashboard 的通信。
尽管 V1 版本不再区分访问端口和通信端口,但由于不同厂商的 CDN 配置可能导致通信异常,仅建议按上述方式准备域名(非强制要求)。
本文档以 “dashboard.example.com” 和 “data.example.com” 为例。
在服务器中安装 Dashboard
在面板服务器中,运行以下安装脚本:
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
以 Docker 安装为例,安装完成后按提示输入以下信息:
请输入站点标题:
– 自定义站点标题。
请输入暴露端口:
– 公开访问端口(默认 8008,可自定义)。
请指定后台语言:
– 选择语言偏好。
输入完成后,等待拉取 Docker 镜像。安装结束后,如果一切正常,你可以通过域名和端口号访问 Dashboard,例如:
http://dashboard.example.com:8008
如果需要再次运行安装脚本,可输入以下命令:
打开管理脚本。
登录到 Dashboard 配置界面
后台管理界面的路径为 /dashboard
,你只需访问:
http://dashboard.example.com:8008/dashboard

首次登录的默认用户名和密码均为 admin
。
默认密码为弱密码,对于高权限的面板来说,使用弱密码非常危险!
建议安装后立即进入管理页面:点击头像 →“个人信息”→“更新个人资料”修改密码。
建议密码长度至少 18 位,并混合大小写字母、数字及符号。
更新 Dashboard
运行脚本:
选择重启面板并更新。
安装 Agent
哪吒监控的被控端服务被称为 Agent,本文档将介绍如何在被控端服务器上安装 Agent,并与 Dashboard 连接。
一键安装 Agent
哪吒监控支持在 Windows、macOS 和 Linux 上一键安装 Agent。遵循本文档的步骤,你可以轻松地在服务器上部署它。
准备工作
在安装前,需要提前在管理面板中设置通信域名,该域名不建议接入 CDN。本文档以示例通信域名“data.example.com”为例。
- 在后台管理面板点击头像,进入“系统设置”页。
- 在“Agent 对接地址【域名 /IP: 端口】”项中填入通信域名和端口“data.example.com:8008”。
- 点击“确认”保存设置。
一键安装步骤
- 在
服务器
页面中,点击 安装命令
并选择对应操作系统,安装命令将自动复制到你的剪贴板。
- 在被控端服务器中运行安装命令,等待安装完成后返回到
服务器
页面查看是否上线。
- 如果安装成功,页面中将自动弹出新的服务器,你可以点击编辑按钮为其设置名称。

卸载 Agent
卸载 Agent 包括停止服务、卸载服务,以及删除相关文件。以下是 Ubuntu 系统的卸载步骤:
- 停止并卸载服务:
cd /opt/nezha/agent/
./nezha-agent service uninstall
- 删除 Agent 文件夹:
如果安装了多个服务并想要全部卸载,可以使用 Agent 安装脚本的卸载功能:
开源官方地址 https://github.com/nezhahq/nezha