哪吒监控的使用 - 晚安的静谧小屋

1. 相关地址#

项目地址：https://github.com/nezhahq/nezha
文档地址：https://nezha.wiki/
json生成器地址：哪吒监控 JSON 工具合集

2. 准备工作#

购买服务器（不是强制要求，机器少的话可以直接在现有机器上部署，机器多的话建议购买一台新的机器专门用于监控的搭建）
安装docker

3. 搭建#

面板端（dashboard）#

compose文件#

1
services:
2
  dashboard:
3
    image: registry.cn-shanghai.aliyuncs.com/naibahq/nezha-dashboard
4
    container_name: nezha-dashboard
5
    restart: always
6
    volumes:
7
      - ./data:/dashboard/data
8
    ports:
9
      - 8264:8264

一键脚本#

国际：

1
curl -L https://raw.githubusercontent.com/nezhahq/scripts/refs/heads/main/install.sh -o nezha.sh && chmod +x nezha.sh && sudo ./nezha.sh

大陆优化：

1
curl -L https://gitee.com/naibahq/scripts/raw/main/install.sh -o nezha.sh && chmod +x nezha.sh && sudo CN=true ./nezha.sh

面板配置#

使用 compose文件 部署的需要在面板后台系统设置 里面填写 gaent对接地址

使用 ip+端口 的不要开启 Agent使用TLS连接

监控端（agent）#

在面板后台选择类型，复制命令到被监控机器直接安装即可

4. 美化#

1. 前台美化#

示例：https://node.goodnightan.com/

1
<!-- 自定义设置 -->
2
<script>
3
  window.CustomBackgroundImage = "https://cf-api.goodnightan.com/p/wolp";
4
  window.DisableAnimatedMan = "true";
5
  window.CustomIllustration = 'https://img.028029.xyz/1734592545615.png';
6
  window.ShowNetTransfer = "true";
7
  window.CustomDesc = "欢迎查看晚安的服务器监控.";
8
</script>
9

10
<!-- 状态和进度条逻辑 -->
11
<script>
12
  function applyCardStyles() {
13
    const cards = document.querySelectorAll('div.rounded-lg.border.text-card-foreground');
14

15
    cards.forEach(card => {
16
      // 跳过无 section.grid 的卡片（例如统计卡片）
17
      if (!card.querySelector('section.grid')) return;
18

19
      // 1️⃣ 获取剩余天数
20
      const remarkEls = card.querySelectorAll('[class*="text-muted-foreground"]');
21
      let daysLeft = null;
22
      remarkEls.forEach(el => {
23
        const m = el.innerText.match(/剩余天数[:：]?\s*(\d+)\s*天/);
24
        if (m) daysLeft = parseInt(m[1]);
25
      });
26

27
      // 2️⃣ 设置进度条颜色
28
      const bar = card.querySelector('[aria-label="Server Usage Bar"] > div');
29
      if (bar) {
30
        if (daysLeft !== null) {
31
          if (daysLeft <= 10) {
32
            bar.style.backgroundColor = "#ef4444"; // 红色
33
          } else if (daysLeft > 30) {
34
            bar.style.backgroundColor = "#22c55e"; // 绿色
35
          } else {
36
            bar.style.backgroundColor = "#ffffff"; // 白色
37
          }
38
        } else {
39
          bar.style.backgroundColor = "#ffffff"; // 默认白色
40
        }
41
      }
42

43
      // 3️⃣ 判断状态（是否在线/过期）
44
      const statusDot = card.querySelector('section.grid span.h-2.w-2');
45
      card.classList.remove('expired-offline', 'expired-online');
46
      if (!statusDot) return;
47

48
      const isOnline = statusDot.classList.contains('bg-green-500');
49
      const expiredEl = [...card.querySelectorAll('*')].find(el =>
50
        el.textContent.includes('已过期')
51
      );
52
      const isExpired = !!expiredEl;
53

54
      if (isExpired && isOnline) {
55
        card.classList.add('expired-online');
56
      } else if (!isOnline) {
57
        card.classList.add('expired-offline');
58
      }
59
    });
60
  }
61

62
  // 启动时监听 DOM
63
  const observer = new MutationObserver(() => applyCardStyles());
64

65
  window.addEventListener("load", () => {
66
    const target = document.querySelector("main") || document.body;
67
    if (target) {
68
      observer.observe(target, { childList: true, subtree: true });
69
      applyCardStyles();
70
    }
71
  });
72
</script>
73

74
<!-- 样式控制 -->
75
<style>
76
  /* 上传字体颜色：红 */
77
  [class*="上传"] > .text-xs.font-semibold,
78
  [class*="上传"] + div > .text-xs.font-semibold {
79
    color: #ef4444 !important;
80
  }
81

82
  /* 下载字体颜色：绿 */
83
  [class*="下载"] > .text-xs.font-semibold,
84
  [class*="下载"] + div > .text-xs.font-semibold {
85
    color: #22c55e !important;
86
  }
87

88
  /* 左边上传统计条颜色 */
89
  section.flex.items-center.w-full.justify-between.gap-1 > div:first-child {
90
    color: #ef4444 !important;
91
    border-color: #ef444433 !important;
92
  }
93

94
  /* 右边下载统计条颜色 */
95
  section.flex.items-center.w-full.justify-between.gap-1 > div:last-child {
96
    color: #22c55e !important;
97
    border-color: #22c55e33 !important;
98
  }
99

100
  /* 🚫 删除进度条默认强制样式，改为 JS 控制 */
101
  /* [aria-label="Server Usage Bar"] > div {
102
    background-color: hsl(var(--primary)) !important;
103
    background-image: none !important;
104
  } */
105

106
  /* 过期但离线或离线未过期：红色背景 + 红边 */
107
  .expired-offline {
108
    background-color: rgba(255, 86, 86, 0.15) !important;
109
    border-color: #ef4444 !important;
110
    color: inherit !important;
111
  }
112

113
  /* 过期但在线：黄色背景 + 黄边 */
114
  .expired-online {
115
    background-color: rgba(255, 221, 86, 0.15) !important;
116
    border-color: rgb(228, 239, 68) !important;
117
    color: inherit !important;
118
  }
119
</style>

TIP
以上代码填写在面板后台 系统设置-自定义代码 里面，主题选择为 Office

2. 机器显示美化（公开代码）#

使用json格式的代码并填写到每个机器的 公开备注 中示例：

1
{
2
    "billingDataMod": {
3
        "startDate": "2025-03-30 11:38:52+08:00",
4
        "endDate": "2025-11-16 11:38:52+08:00",
5
        "autorenewal": "0",
6
        "cycle": "年",
7
        "amount": "200USD"
8
    },
9
    "planDataMod": {
10
        "bandwidth": "1Gbps",
11
        "trafficVol": "3TB/月",
12
        "trafficType": "2",
13
        "IPv4": "1",
14
        "IPv6": "0",
15
        "networkRoute": "4837,163,CMI",
16
        "extra": "搬瓦工"
17
    }
18
}

解释：

startDate	计费开始时间
endDate	计费结束时间
autoRenewal	是否自动续费；是为1,否为0
cycle	计费周期
amount	金额
bandwidth	机器带宽大小
trafficVol	机器流量大小
trafficType	流量计费类型；单出流量（上行）为1,双向为2，双向最值为3
IPv4	IPv4地址数量
IPv6	IPv6地址数量
networkRoute	网络路由类型；例：CN2
extra	额外信息，支持中文

5. 高级配置#

机器单月内流量监控#

1. 配置通知#

具体配置方法参考官方wiki:通知设置 | 哪吒服务器监控

Matrix#

搭建查看：https://blog.goodnightan.com/posts/nezha-status/ 接入方法

获取Token，将获取token命令中的变量替换为已知内容，在机器上执行，复制输出的token值
配置通知，遵循下面的来写

名称：Matrix
URL：https://$YOUR_HOME_SERVER/_matrix/client/r0/rooms/$ROOM_ID/send/m.room.message
请求方式：POST
请求类型：JSON
Header：

1
{
2
  "Authorization": "Bearer $YOUR_MATRIX_TOKEN"
3
}

Body：

1
{
2
  "msgtype": "m.text",
3
  "format": "org.matrix.custom.html",
4
  "formatted_body": "<h1><a href=\"$YOUR_NEZHA_URL\" target=\"_blank\">Nezha Dashboard</a></h1><ul><li>时间：#DATETIME#</li><li>消息：#NEZHA#</li></ul>",
5
  "body": "#NEZHA#"
6
}

变量替换：将以下变量替换为实际值
- $YOUR_HOME_SERVER：Matrix 服务器地址
- $YOUR_NEZHA_URL：你的哪吒面板 URL
- $YOUR_MATRIX_USERNAME：Matrix 用户名
- $YOUR_MATRIX_PASSWD：Matrix 用户密码
- $YOUR_MATRIX_TOKEN：Matrix 访问令牌
- $ROOM_ID：Matrix 房间 ID

房间ID可以通过复制房间链接来获取，链接中 #/后面到?前面的就是房间ID

2. 报警设置#

具体配置方法参考官方wiki:通知设置 | 哪吒服务器监控

报警规则#

具体配置方法参考官方wiki:通知设置 | 哪吒服务器监控

NOTE
警报格式不会写的可以使用生成器进行生成