准备工作**

搭建一个哪吒监控，你需要：

  1. 一台可以连接公网的 VPS，防火墙和安全策略需要放行 8008 和 5555 端口，否则会无法访问和无法接收数据。单核 512MB 内存的服务器配置就足以满足大多数使用场景
  2. 一个已经设置好 A 记录，指向 Dashboard 服务器 ip 的域名

TIP

如果你想使用 CDN，请准备两个域名，一个配置好 CDN 用作公开访问，CDN 需要支持WebSocket 协议；另一个域名不要使用 CDN，用作 Agent 端与 Dashboard 的通信
本文档分别以 "cdn.example.com" 和 "data.example.com" 两个域名来演示

  1. 一个 Github 账号（或：Gitlab、Jihulab、Gitee）

TIP

如果您位于中国大陆，访问 Github 有困难，我们建议您选择 Jihulab 作为 OAuth 提供商

本文档将以宝塔面板反代面板的过程作为范例，随着未来版本的变化，部分功能的入口可能会发生改变，本文档仅供参考

WARNING

本项目并不依赖宝塔，你可以选择使用你喜欢的任何服务器面板，如果你能力足够，可以手动安装 NginX 或 Caddy 来配置 SSL 和反代。
如果你认为没有必要使用 80、443 端口来访问 Dashboard，你甚至不需要安装 NginX 就可以直接使用安装脚本。

获取 Github/Jihulab 的 Client ID 和密钥**

哪吒监控接入 Github、Gitlab、Jihulab、Gitee 作为后台管理员账号

  • 首先我们需要新建一个验证应用，以 Github 为例，登录 Github 后，打开 https://github.com/settings/developers ，依次选择“OAuth Apps” - “New OAuth App”
    Application name - 随意填写
    Homepage URL - 填写面板的访问域名，如："http://cdn.example.com"
    Authorization callback URL - 填写回调地址，如："http://cdn.example.com/oauth2/callback"
  • 点击 “Register application”
  • 保存页面中的 Client ID，然后点击 “Generate a new client secret“，创建一个新的 Client Secret，新建的密钥仅会显示一次，请妥善保存
  • JihuLab 的应用创建入口为：https://jihulab.com/-/profile/applications
  • Redirect URL 中应填入回调地址
  • 在下方范围中勾选 read_user 和 read_api
  • 创建完成后，保存好应用程序 ID 和密码一键脚本

在服务器中安装 Dashboard**

  • 在面板服务器中，运行安装脚本：
curl -L https://raw.githubusercontent.com/naiba/nezha/master/script/install.sh  -o nezha.sh && chmod +x nezha.sh && sudo ./nezha.sh

如果你的面板服务器位于中国大陆，可以使用镜像：

curl -L https://cdn.jsdelivr.net/gh/naiba/nezha@master/script/install.sh -o nezha.sh && chmod +x nezha.sh && sudo CN=true ./nezha.sh
  • 等待Docker安装完毕后，分别输入以下值：
    OAuth提供商 - Github，Gitlab，Jihulab，Gitee 中选择一个
    Client ID - 之前保存的 Client ID
    Client Secret - 之前保存的密钥
    用户名 - OAuth 提供商中的用户名
    站点标题 - 自定义站点标题
    访问端口 - 公开访问端口，可自定义，默认 8008
    Agent的通信端口 - Agent与Dashboard的通信端口，默认 5555
  • 输入完成后，等待拉取镜像
    安装结束后，如果一切正常，此时你可以访问域名+端口号，如 “http://cdn.example.com:8008” 来查看面板
  • 将来如果需要再次运行脚本，可以运行：
./nezha.sh

来打开管理脚本

配置反向代理**

  • 在宝塔面板中新建一个站点，域名填写公开访问域名，如 “http://cdn.example.com“ ，然后点击“设置”进入站点设置选项，选择“反向代理” - “新建反向代理”
  • 自定义一个代理名称，在下方“目标 URL”中填入 http://127.0.0.1 然后点击“保存”
  • 打开刚刚新建的反向代理右边的“配置文件”，将配置文件替换为以下内容：
#PROXY-START/
location / {
    proxy_pass http://127.0.0.1:8008;
    proxy_set_header Host $http_host;
    proxy_set_header      Upgrade $http_upgrade;
}
location ~ ^/(ws|terminal/.+)$  {
    proxy_pass http://127.0.0.1:8008;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "Upgrade";
    proxy_set_header Host $http_host;
}
#PROXY-END/
  • 点击“保存”
    现在，你应该可以直接使用域名，如：“http://cdn.example.com“ 来访问面板了

扩展内容：**

  • CaddyServer v1（v2 无需特别配置）

    proxy /ws http://ip:8008 {
    websocket
    header_upstream -Origin
}
proxy /terminal/* http://ip:8008 {
    websocket
    header_upstream -Origin
}

如何进行数据迁移、备份恢复**

  1. 先运行一键脚本，选择 停止面板

  2. 在旧服务器中打包 /opt/nezha 文件夹，复制到新环境相同位置解压

    tar -P -cvf /root/nz.tar /opt/nezha
    tar xvf /root/nz.tar -C /
  3. 在新环境中运行一键脚本，选择 启动面板

其他

  • Telegram 通知：@haitau

    • 名称：telegram 机器人消息通知
    • URL：https://api.telegram.org/botXXXXXX/sendMessage?chat\_id=YYYYYY&text=#NEZHA#
    • 请求方式: GET
    • 请求类型: 默认
    • Body: 空
    • URL 参数获取说明：botXXXXXX 中的 XXXXXX 是在 telegram 中关注官方 @Botfather ，输入/newbot ，创建新的机器人（bot）时，会提供的 token（在提示 Use this token to access the HTTP API:后面一行）这里 'bot' 三个字母不可少。创建 bot 后，需要先在 telegram 中与 BOT 进行对话（随便发个消息），然后才可用 API 发送消息。YYYYYY 是 telegram 用户的数字 ID。与机器人@userinfobot 对话可获得。

  • 如何每月重置流量统计？**

    主页中的流量统计每次服务器重启时都会重置，如果要实现每月重置一次流量计数，可以这样实现：

    1. 进入管理面板的 报警通知 页
    2. 参考这篇文档，创建一个月流量报警

    3. 返回主页，在 服务 页中就可以看到月流量统计了，这里的统计数据不会因为服务器重启而重置

      示例：出入计量2T 6.15开始周期一个月 一号小鸡

      [{"type":"transfer_all_cycle","max":2199023255552,"cycle_start":"2023-06-15T00:00:00+08:00","cycle_interval":1,"cycle_unit":"month","cover":1,"ignore":{"1":true}}]
  • 国内机一键安装客户端失败，运行脚本，选择3，自定义源，输入坛友的反代站 github.ustc.gay，agent就能下载下来进行安装了。如果这个不能用，再找个能用的反代站。

来源官方文档https://nezha.wiki/guide/dashboard.html


◈
最后修改：2024 年 09 月 05 日
© 允许规范转载
如果觉得我的文章对你有用，请随意赞赏