准备工作

一台vps或者nat，一个github账户

获取Client ID 和密钥

哪吒面板可以使用Github、Gitlab、Jihulab、Gitee 作为后台管理员账号，这里演示github

打开github，并完成登录，点击右上角个人头像，选择菜单里的setting

随后在左边的菜单里选择developer settings

然后在左侧的Oauth APPs中注册new application

Application name – name自己定义

Homepage URL – 1填写面板的访问域名，如：http://example.com或者IP+端口

Authorization callback URL – 2填写回调地址，如：http://example.com/oauth2/callback，域名可以替换为IP+端口

注意：homepage URL和 callback URL必须填写http或者https，后续可以update修改。

然后点击register即可得到client ID，密钥需要点击generate生成

到这里，准备工作就完成了。

安装哪吒面板服务器

国内镜像地址

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://gitee.com/naibahq/nezha/raw/master/script/install.sh -o nezha.sh && chmod +x nezha.sh && sudo CN=true ./nezha.sh

可以独立安装，也可以用docker安装（需先安装docker），这里演示独立安装，选2，再选1即可

默认调用github，回车即可

输入github里的client ID、密钥、用户名（github用户名）、站点标题，其他默认即可

注意：哪吒面板服务器网页默认访问端口是8008，agent接入端口是5555，需要防火墙放行相应端口，如果是nat，可以在面板配置中更改以上两个端口

至此，哪吒面板服务器安装成功。

哪吒面板服务器维护

如果需要再次运行脚本，或者修改面板设置，可以运行：

./nezha.sh

哪吒面板网页设置

使用域名（或IP+端口）访问哪吒面板服务器网页

如图进行授权登录即可。

在管理后台→设置中，填入你的未接入CDN的域名或IP，保存。

注意：如果是IP，不要加端口

安装哪吒agent服务

在后台中选择 新增服务器

填写相关信息后点击 新增

小企鹅：linux安装agent命令

方块：windows安装agent命令

点击相应的色块，复制命令到被监控端vps或者nat安装即可。

哪吒服务效果

配置反向代理

可参考哪吒官方文档

传送门：使用宝塔配置反向代理

报警规则分享

名称：离线报警

规则：[{"Type":"offline","Duration":10}] 解释：每10s坚持一次，如果离线会发通知。（10s感觉太短，一般10分钟感觉比较合适）

---

名称：CPU过高警告

规则：[{"type":"cpu","max":90,"duration":300}] 解释：CPU超过90%发通知警告。300s一周期。（90和300自行修改为自己合适）

---

名称：内存过高警告

规则：[{"type":"memory","max":90,"duration":300}] 解释：内存占用超过90%发通知警告，300s一周期。（90和300自行修改为自己合适）

---

名称：硬盘即将爆满

规则：[{"type":"disk","max":80,"duration":43200}] 解释：硬盘占用超过80%发通知警告，12小时一周期。（80和43200自行修改为自己合适）

---

名称：TCP链接过多异常

规则：[{"type":"tcp_conn_count","max":20,"duration":300}] 解释：TCP链接数超过20个发通知报警，300s为周期。

---

名称：出站网速过快警告

规则：[{"type":"net_out_speed","max":524288000,"duration":300}] 解释：出站网速超过500M警告发通知，周期为300s。（524288000和300自行修改为自己合适）

---

名称：周期内流量警告

规则：

[{"type":"transfer_out_cycle","max":1099511627776,"cycle_start":"2022-01-01T00:00:00+08:00","cycle_interval":1,"cycle_unit":"month","cover":1,"ignore":{"3":true,"4":true}}]

解释：ID 为 3 和 4 的服务器（ignore 里面定义），以每月 1 号为统计周期，周期内统计的出站月流量达到 1TB 时报警

1. type之中 transfer_out_cycle表示周期内的入站流量。大家可以修改为 transfer_out_cycle 周期内的出站流量、 transfer_all_cycle 周期内双向流量和
2. max之后的 1099511627776为1TB流量，这里使用的单位应该是B，大家可以自行修改。如：200GB为 214748364800
3. cycle_start: 是统计周期开始日期（可以是你机器计费周期的开始日期），时间格式为RFC3339，例如北京时间为 2022-01-11T08:00:00.00+08:00
4. cycle_interval：每隔多少个周期单位（例如，周期单位为天，该值为 7，则代表每隔 7 天统计一次）
5. cycle_unit 统计周期单位，默认hour,可选(hour, day, week, month, year)
6. cover参考基本规则 【0 监控所有，通过 ignore 忽略特定服务器 、1 忽略所有，通过 ignore 监控特定服务器】
7. ignore内定义要监控的VPS 的ID。

套餐显示

版本: v0.20.7开始支持

配置位置：后台-> 服务器 -> 编辑服务器 -> 公开备注

完整配置，包含过期时间、价格展示、套餐展示

{
   "billingDataMod": {
       "startDate": "2024-10-01T00:00:00+08:00",
       "endDate": "2024-11-01T00:00:00+08:00",
       "autoRenewal": "1",
       "cycle": "月",
       "amount": "$3.99"
   },
   "planDataMod": {
       "bandwidth": "30Mbps",
       "trafficVol": "1TB/月",
       "trafficType": "1",
       "IPv4": "1",
       "IPv6": "1",
       "networkRoute": "CN2,GIA",
       "extra": "传家宝,AS9929"
   }
}

单独配置过期时间

{
   "billingDataMod": {
       "startDate": "2024-10-01T00:00:00+08:00",
       "endDate": "2024-11-01T00:00:00+08:00",
       "autoRenewal": "1",
       "cycle": "月"
   }
}

单独配置价格展示

{
   "billingDataMod": {
       "cycle": "月",
       "amount": "$3.99"
   }
}

单独配置套餐信息

{
   "planDataMod": {
       "bandwidth": "30Mbps",
       "trafficVol": "1TB/月",
       "trafficType": "1",
       "IPv4": "1",
       "IPv6": "1",
       "networkRoute": "CN2,GIA",
       "extra": "传家宝,9929"
   }
}

数据迁移

迁移旧服务器上的 /opt/nezha/dashboard/data 覆盖到新服务器同目录，重启服务即可。