开源、轻量、易用的服务器监控与运维工 官方文档
搭建哪吒监控的 Dashboard,你需要:
准备域名与 DNS 解析
在 Cloudflare 中,为 Dashboard 选择一个子域名,比如
nezha.yourdomain.com。在 Cloudflare 中设置 A 记录指向你服务器的 IP。因为你使用小云朵(“代理”开启状态)可以隐藏真实 IP。
根据官方建议,如果你要避开 CDN 与 Agent 通信问题,可以再配置一个子域名不使用代理(云朵灰色)作为客户端 -> Dashboard 通信。例:
agent.yourdomain.com走直连。在宝塔面板确认服务器防火墙或安全组已开放端口 8008(或你选择的自定义端口)。
在宝塔面板或直接 SSH 上安装 Dashboard
你可以通过宝塔终端 SSH 功能登陆服务器。
执行官方脚本(如上所示)安装 Dashboard。
安装过程中,脚本会提问:站点标题、公开访问端口(默认 8008)、语言。你可以按需求填写。
安装完成后,可在浏览器访问
http://nezha.yourdomain.com:8008,确认是否能正常打开。
官方安装命令(脚本)示例:curl -L https://raw.githubusercontent.com/nezhahq/scripts/refs/heads/main/install.sh -o nezha.sh && chmod +x nezha.sh && sudo ./nezha.sh若在中国大陆可使用 Gitee 镜像:
curl -L https://gitee.com/naibahq/scripts/raw/main/install.sh -o nezha.sh && chmod +x nezha.sh && sudo CN=true ./nezha.sh ``` :contentReference[oaicite:7]{index=7}
使用宝塔面板反向代理(可选)
如果你希望访问不带端口(即 80/443),推荐在宝塔的 “网站” 模块中创建一个网站 nezha.yourdomain.com,配置 SSL(Let's Encrypt)与反向代理将流量转发至内网 Docker 容器端口 8008。
这样用户访问
https://nezha.yourdomain.com即可无端口访问。在 Cloudflare 中保持代理开启(黄云朵),隐藏真实 IP。
注意反向代理时,确保 WebSocket 支持(如果 Dashboard 使用 WebSocket 通信)。
安装 Agent 并连接 Dashboard
安装完成 Dashboard 后,下一步是安装 Agent 在你的服务器或其他服务器上进行监控。你之前已有服务器环境,直接安装即可。
在 Dashboard 添加你的服务器,获取 Token 或连接信息。
Agent 与 Dashboard 通信时,建议使用直连域名(例如
agent.yourdomain.com)以避免 CDN 问题。
一键安装 Agent
哪吒监控支持在 Windows、macOS 和 Linux 上一键安装 Agent。遵循本文档的步骤,你可以轻松地在服务器上部署它。
准备工作
在安装前,需要提前在管理面板中设置通信域名,该域名不建议接入 CDN。本文档以示例通信域名 “agent.yourdomain.com” 为例。
在后台管理面板点击头像,进入“系统设置”页。
在“Agent 对接地址【域名/IP:端口】”项中填入通信域名和端口 “
agent.yourdomain.com:8008”。点击“确认”保存设置。
一键安装步骤
在
服务器页面中,点击安装命令并选择对应操作系统,安装命令将自动复制到你的剪贴板。在被控端服务器中运行安装命令,等待安装完成后返回到
服务器页面查看是否上线。如果安装成功,页面中将自动弹出新的服务器,你可以点击编辑按钮为其设置名称。
平台特有说明
Windows 特殊说明
在 Windows 服务器中,运行 PowerShell。
在 PowerShell 中粘贴并运行安装命令。
如遇到「执行策略变更」确认提示,输入
Y并回车。
5.首次登录与安全强化
首次登录后台 路径为
/dashboard(例如https://nezha.yourdomain.com/dashboard)默认 admin/admin。登录后立即修改密码(建议长度 ≥18 位,混合大小写、数字、符号)以增强安全。
在 Cloudflare 启用 HTTPS 和“完全(严格)”SSL 模式,以确保客户端与服务器之间通信加密。
定期更新 Dashboard:通过再次运行脚本即可更新。
评论