开源、轻量、易用的服务器监控与运维工 官方文档

搭建哪吒监控的 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” 为例。

  1. 在后台管理面板点击头像,进入“系统设置”页。

  2. 在“Agent 对接地址【域名/IP:端口】”项中填入通信域名和端口 “agent.yourdomain.com:8008”。

  3. 点击“确认”保存设置。

一键安装步骤

  1. 服务器 页面中,点击 安装命令 并选择对应操作系统,安装命令将自动复制到你的剪贴板。

  2. 在被控端服务器中运行安装命令,等待安装完成后返回到 服务器 页面查看是否上线。

  3. 如果安装成功,页面中将自动弹出新的服务器,你可以点击编辑按钮为其设置名称。

平台特有说明

Windows 特殊说明

  1. 在 Windows 服务器中,运行 PowerShell。

  2. 在 PowerShell 中粘贴并运行安装命令。

  3. 如遇到「执行策略变更」确认提示,输入 Y 并回车。

5.首次登录与安全强化

  • 首次登录后台 路径为 /dashboard(例如 https://nezha.yourdomain.com/dashboard)默认 admin/admin。

  • 登录后立即修改密码(建议长度 ≥18 位,混合大小写、数字、符号)以增强安全。

  • 在 Cloudflare 启用 HTTPS 和“完全(严格)”SSL 模式,以确保客户端与服务器之间通信加密。

  • 定期更新 Dashboard:通过再次运行脚本即可更新。