diff --git a/404.html b/404.html index b970c9b3..c0acd837 100644 --- a/404.html +++ b/404.html @@ -20,7 +20,7 @@
- + \ No newline at end of file diff --git a/assets/case_case1.md.LpPNSlns.js b/assets/case_case1.md.DUuX9xR2.js similarity index 95% rename from assets/case_case1.md.LpPNSlns.js rename to assets/case_case1.md.DUuX9xR2.js index 4adeaf2a..430daa80 100644 --- a/assets/case_case1.md.LpPNSlns.js +++ b/assets/case_case1.md.DUuX9xR2.js @@ -1 +1 @@ -import{_ as e,c as t,o as a,a4 as r}from"./chunks/framework.BmdFiWrL.js";const b=JSON.parse('{"title":"自建一个TG机器人来查询服务器信息","description":"","frontmatter":{},"headers":[],"relativePath":"case/case1.md","filePath":"case/case1.md","lastUpdated":1720881864000}'),o={name:"case/case1.md"},_=r('

自建一个TG机器人来查询服务器信息 ​

贡献者:

项目地址：nezha_api_tgbot

镜像备份（非实时更新）：nezha_api_tgbot
机器人可以通过API向面板请求服务器状态信息，得到信息后发送给用户
你可以搭建此机器人来方便地查看指定服务器的当前状态且不需要打开面板

',5),s=[_];function i(n,c,p,h,l,d){return a(),t("div",null,s)}const g=e(o,[["render",i]]);export{b as __pageData,g as default}; +import{_ as e,c as t,o as a,a4 as r}from"./chunks/framework.BmdFiWrL.js";const b=JSON.parse('{"title":"自建一个TG机器人来查询服务器信息","description":"","frontmatter":{},"headers":[],"relativePath":"case/case1.md","filePath":"case/case1.md","lastUpdated":1720901424000}'),o={name:"case/case1.md"},_=r('

自建一个TG机器人来查询服务器信息 ​

贡献者:

项目地址：nezha_api_tgbot

镜像备份（非实时更新）：nezha_api_tgbot
机器人可以通过API向面板请求服务器状态信息，得到信息后发送给用户
你可以搭建此机器人来方便地查看指定服务器的当前状态且不需要打开面板

',5),s=[_];function i(n,c,p,h,l,d){return a(),t("div",null,s)}const g=e(o,[["render",i]]);export{b as __pageData,g as default}; diff --git a/assets/case_case1.md.LpPNSlns.lean.js b/assets/case_case1.md.DUuX9xR2.lean.js similarity index 85% rename from assets/case_case1.md.LpPNSlns.lean.js rename to assets/case_case1.md.DUuX9xR2.lean.js index 71a68f56..5ddfd0b0 100644 --- a/assets/case_case1.md.LpPNSlns.lean.js +++ b/assets/case_case1.md.DUuX9xR2.lean.js @@ -1 +1 @@ -import{_ as e,c as t,o as a,a4 as r}from"./chunks/framework.BmdFiWrL.js";const b=JSON.parse('{"title":"自建一个TG机器人来查询服务器信息","description":"","frontmatter":{},"headers":[],"relativePath":"case/case1.md","filePath":"case/case1.md","lastUpdated":1720881864000}'),o={name:"case/case1.md"},_=r("",5),s=[_];function i(n,c,p,h,l,d){return a(),t("div",null,s)}const g=e(o,[["render",i]]);export{b as __pageData,g as default}; +import{_ as e,c as t,o as a,a4 as r}from"./chunks/framework.BmdFiWrL.js";const b=JSON.parse('{"title":"自建一个TG机器人来查询服务器信息","description":"","frontmatter":{},"headers":[],"relativePath":"case/case1.md","filePath":"case/case1.md","lastUpdated":1720901424000}'),o={name:"case/case1.md"},_=r("",5),s=[_];function i(n,c,p,h,l,d){return a(),t("div",null,s)}const g=e(o,[["render",i]]);export{b as __pageData,g as default}; diff --git a/assets/case_case2.md.DocdANBo.js b/assets/case_case2.md.UW1WkMIc.js similarity index 97% rename from assets/case_case2.md.DocdANBo.js rename to assets/case_case2.md.UW1WkMIc.js index 317813b0..18ba7a50 100644 --- a/assets/case_case2.md.DocdANBo.js +++ b/assets/case_case2.md.UW1WkMIc.js @@ -1 +1 @@ -import{_ as a}from"./chunks/qrcode.CZOxHFH-.js";import{_ as e,c as r,o as i,a4 as t}from"./chunks/framework.BmdFiWrL.js";const b=JSON.parse('{"title":"在iOS/MacOS中使用Siri运行快捷指令查询服务器状态","description":"","frontmatter":{},"headers":[],"relativePath":"case/case2.md","filePath":"case/case2.md","lastUpdated":1720881864000}'),o={name:"case/case2.md"},c=t('

在iOS/MacOS中使用Siri运行快捷指令查询服务器状态 ​

当前版本：V1.0
贡献者：

获取快捷指令 ​

使用iPhone或iPad扫描以下二维码，获取快捷指令

coode

MacOS用户请访问这里，获取快捷指令

使用说明 ​

WARNING

每个快捷指令只能监控一台服务器，如需要监控多个服务器，请多次复制此快捷指令并分别配置，然后分别修改快捷指令名称，如；一号服务器状态、二号服务器状态等

',8),s=[c];function l(d,n,h,_,p,m){return i(),r("div",null,s)}const S=e(o,[["render",l]]);export{b as __pageData,S as default}; +import{_ as a}from"./chunks/qrcode.CZOxHFH-.js";import{_ as e,c as r,o as i,a4 as t}from"./chunks/framework.BmdFiWrL.js";const b=JSON.parse('{"title":"在iOS/MacOS中使用Siri运行快捷指令查询服务器状态","description":"","frontmatter":{},"headers":[],"relativePath":"case/case2.md","filePath":"case/case2.md","lastUpdated":1720901424000}'),o={name:"case/case2.md"},c=t('

在iOS/MacOS中使用Siri运行快捷指令查询服务器状态 ​

当前版本：V1.0
贡献者：

获取快捷指令 ​

使用iPhone或iPad扫描以下二维码，获取快捷指令

coode

MacOS用户请访问这里，获取快捷指令

使用说明 ​

WARNING

每个快捷指令只能监控一台服务器，如需要监控多个服务器，请多次复制此快捷指令并分别配置，然后分别修改快捷指令名称，如；一号服务器状态、二号服务器状态等

',8),s=[c];function l(d,n,h,_,p,m){return i(),r("div",null,s)}const S=e(o,[["render",l]]);export{b as __pageData,S as default}; diff --git a/assets/case_case2.md.DocdANBo.lean.js b/assets/case_case2.md.UW1WkMIc.lean.js similarity index 87% rename from assets/case_case2.md.DocdANBo.lean.js rename to assets/case_case2.md.UW1WkMIc.lean.js index 55d016a2..74640c35 100644 --- a/assets/case_case2.md.DocdANBo.lean.js +++ b/assets/case_case2.md.UW1WkMIc.lean.js @@ -1 +1 @@ -import{_ as a}from"./chunks/qrcode.CZOxHFH-.js";import{_ as e,c as r,o as i,a4 as t}from"./chunks/framework.BmdFiWrL.js";const b=JSON.parse('{"title":"在iOS/MacOS中使用Siri运行快捷指令查询服务器状态","description":"","frontmatter":{},"headers":[],"relativePath":"case/case2.md","filePath":"case/case2.md","lastUpdated":1720881864000}'),o={name:"case/case2.md"},c=t("",8),s=[c];function l(d,n,h,_,p,m){return i(),r("div",null,s)}const S=e(o,[["render",l]]);export{b as __pageData,S as default}; +import{_ as a}from"./chunks/qrcode.CZOxHFH-.js";import{_ as e,c as r,o as i,a4 as t}from"./chunks/framework.BmdFiWrL.js";const b=JSON.parse('{"title":"在iOS/MacOS中使用Siri运行快捷指令查询服务器状态","description":"","frontmatter":{},"headers":[],"relativePath":"case/case2.md","filePath":"case/case2.md","lastUpdated":1720901424000}'),o={name:"case/case2.md"},c=t("",8),s=[c];function l(d,n,h,_,p,m){return i(),r("div",null,s)}const S=e(o,[["render",l]]);export{b as __pageData,S as default}; diff --git a/assets/case_case3.md.CjLXeVWH.js b/assets/case_case3.md.BBNQkwC_.js similarity index 98% rename from assets/case_case3.md.CjLXeVWH.js rename to assets/case_case3.md.BBNQkwC_.js index cd33bf0d..f49cf932 100644 --- a/assets/case_case3.md.CjLXeVWH.js +++ b/assets/case_case3.md.BBNQkwC_.js @@ -1 +1 @@ -import{_ as t,c as e,o as a,a4 as r}from"./chunks/framework.BmdFiWrL.js";const b=JSON.parse('{"title":"自建使用 API 来进行查询,且支持多语言的 Telegram 查询机器人","description":"","frontmatter":{},"headers":[],"relativePath":"case/case3.md","filePath":"case/case3.md","lastUpdated":1720881864000}'),d={name:"case/case3.md"},l=r('

自建使用 API 来进行查询,且支持多语言的 Telegram 查询机器人 ​

贡献者:

项目地址：nezha_telegram_bot

镜像备份（非实时更新）：nezha_telegram_bot

项目特色 ​

开源Telegram机器人项目，可以基于API实时查询哪吒面板的服务器信息。

命令列表 ​

命令功能仅私聊
start开始使用键盘主菜单✔️
help帮助列表❌
add添加面板链接和token✔️
url添加面板链接✔️
token添加面板token✔️
info获取保存的面板链接和token✔️
delete删除保存的面板链接和token✔️
id命令后面添加整数id，来进行单个服务器信息查询（私聊带刷新按钮，群聊不带）❌
all查询所有服务器的统计信息❌
search在服务器名字中搜索关键字（支持多个，用空格分开）❌

效果展示 ​

imageimage

',12),i=[l];function o(h,n,c,s,_,m){return a(),e("div",null,i)}const f=t(d,[["render",o]]);export{b as __pageData,f as default}; +import{_ as t,c as e,o as a,a4 as r}from"./chunks/framework.BmdFiWrL.js";const b=JSON.parse('{"title":"自建使用 API 来进行查询,且支持多语言的 Telegram 查询机器人","description":"","frontmatter":{},"headers":[],"relativePath":"case/case3.md","filePath":"case/case3.md","lastUpdated":1720901424000}'),d={name:"case/case3.md"},l=r('

自建使用 API 来进行查询,且支持多语言的 Telegram 查询机器人 ​

贡献者:

项目地址：nezha_telegram_bot

镜像备份（非实时更新）：nezha_telegram_bot

项目特色 ​

开源Telegram机器人项目，可以基于API实时查询哪吒面板的服务器信息。

命令列表 ​

命令功能仅私聊
start开始使用键盘主菜单✔️
help帮助列表❌
add添加面板链接和token✔️
url添加面板链接✔️
token添加面板token✔️
info获取保存的面板链接和token✔️
delete删除保存的面板链接和token✔️
id命令后面添加整数id，来进行单个服务器信息查询（私聊带刷新按钮，群聊不带）❌
all查询所有服务器的统计信息❌
search在服务器名字中搜索关键字（支持多个，用空格分开）❌

效果展示 ​

imageimage

',12),i=[l];function o(h,n,c,s,_,m){return a(),e("div",null,i)}const f=t(d,[["render",o]]);export{b as __pageData,f as default}; diff --git a/assets/case_case3.md.CjLXeVWH.lean.js b/assets/case_case3.md.BBNQkwC_.lean.js similarity index 86% rename from assets/case_case3.md.CjLXeVWH.lean.js rename to assets/case_case3.md.BBNQkwC_.lean.js index e7c91d83..6270555b 100644 --- a/assets/case_case3.md.CjLXeVWH.lean.js +++ b/assets/case_case3.md.BBNQkwC_.lean.js @@ -1 +1 @@ -import{_ as t,c as e,o as a,a4 as r}from"./chunks/framework.BmdFiWrL.js";const b=JSON.parse('{"title":"自建使用 API 来进行查询,且支持多语言的 Telegram 查询机器人","description":"","frontmatter":{},"headers":[],"relativePath":"case/case3.md","filePath":"case/case3.md","lastUpdated":1720881864000}'),d={name:"case/case3.md"},l=r("",12),i=[l];function o(h,n,c,s,_,m){return a(),e("div",null,i)}const f=t(d,[["render",o]]);export{b as __pageData,f as default}; +import{_ as t,c as e,o as a,a4 as r}from"./chunks/framework.BmdFiWrL.js";const b=JSON.parse('{"title":"自建使用 API 来进行查询,且支持多语言的 Telegram 查询机器人","description":"","frontmatter":{},"headers":[],"relativePath":"case/case3.md","filePath":"case/case3.md","lastUpdated":1720901424000}'),d={name:"case/case3.md"},l=r("",12),i=[l];function o(h,n,c,s,_,m){return a(),e("div",null,i)}const f=t(d,[["render",o]]);export{b as __pageData,f as default}; diff --git a/assets/case_case4.md.CM7HxnXM.js b/assets/case_case4.md.DJ1ZkmGG.js similarity index 97% rename from assets/case_case4.md.CM7HxnXM.js rename to assets/case_case4.md.DJ1ZkmGG.js index 0b6586a0..efe20fb3 100644 --- a/assets/case_case4.md.CM7HxnXM.js +++ b/assets/case_case4.md.DJ1ZkmGG.js @@ -1 +1 @@ -import{_ as s,c as t,o as e,a4 as a}from"./chunks/framework.BmdFiWrL.js";const r="/assets/2.r5IbCoDU.png",n="/assets/5.DI5HceD6.png",o="/assets/6.B0QVmape.png",p="/assets/4.DAp6JO4C.jpg",c="/assets/1.VA-CzEkF.jpeg",u=JSON.parse('{"title":"重磅推荐！一秒拥有宇宙级算力！让你在人前，不！再！自！卑","description":"","frontmatter":{},"headers":[],"relativePath":"case/case4.md","filePath":"case/case4.md","lastUpdated":1720881864000}'),_={name:"case/case4.md"},i=a('

重磅推荐！一秒拥有宇宙级算力！让你在人前，不！再！自！卑 ​


2

还在因为自己的小鸡配置太差被朋友嘲笑吗？
还在想参加以针会友活动却因为小鸡不够排面而觉得羞耻吗？
还在因为在哪吒TG群里机器人排名太低而觉得自己低人一等吗？


今天开始！找回自信！

来自南京的名老中医 dysf888 独家秘方！让你找回男人本色，激情畅享！
安装 Fake Agent，可随意修改服务器监测数据的倍数上传到 Dashboard，让你的小鸡 脱！胎！换！骨！ 让你在 MJJ 面前硬起来！

镜像备份（非实时更新）：Fake Agent

哪吒监控创始人奶爸也在用：
5


男人用了都说好：
6
4


1

',12),l=[i];function g(b,f,h,m,d,k){return e(),t("div",null,l)}const y=s(_,[["render",g]]);export{u as __pageData,y as default}; +import{_ as s,c as t,o as e,a4 as a}from"./chunks/framework.BmdFiWrL.js";const r="/assets/2.r5IbCoDU.png",n="/assets/5.DI5HceD6.png",o="/assets/6.B0QVmape.png",p="/assets/4.DAp6JO4C.jpg",c="/assets/1.VA-CzEkF.jpeg",u=JSON.parse('{"title":"重磅推荐！一秒拥有宇宙级算力！让你在人前，不！再！自！卑","description":"","frontmatter":{},"headers":[],"relativePath":"case/case4.md","filePath":"case/case4.md","lastUpdated":1720901424000}'),_={name:"case/case4.md"},i=a('

重磅推荐！一秒拥有宇宙级算力！让你在人前，不！再！自！卑 ​


2

还在因为自己的小鸡配置太差被朋友嘲笑吗？
还在想参加以针会友活动却因为小鸡不够排面而觉得羞耻吗？
还在因为在哪吒TG群里机器人排名太低而觉得自己低人一等吗？


今天开始！找回自信！

来自南京的名老中医 dysf888 独家秘方！让你找回男人本色，激情畅享！
安装 Fake Agent，可随意修改服务器监测数据的倍数上传到 Dashboard，让你的小鸡 脱！胎！换！骨！ 让你在 MJJ 面前硬起来！

镜像备份（非实时更新）：Fake Agent

哪吒监控创始人奶爸也在用：
5


男人用了都说好：
6
4


1

',12),l=[i];function g(b,f,h,m,d,k){return e(),t("div",null,l)}const y=s(_,[["render",g]]);export{u as __pageData,y as default}; diff --git a/assets/case_case4.md.CM7HxnXM.lean.js b/assets/case_case4.md.DJ1ZkmGG.lean.js similarity index 89% rename from assets/case_case4.md.CM7HxnXM.lean.js rename to assets/case_case4.md.DJ1ZkmGG.lean.js index 9bd92079..cb6935c0 100644 --- a/assets/case_case4.md.CM7HxnXM.lean.js +++ b/assets/case_case4.md.DJ1ZkmGG.lean.js @@ -1 +1 @@ -import{_ as s,c as t,o as e,a4 as a}from"./chunks/framework.BmdFiWrL.js";const r="/assets/2.r5IbCoDU.png",n="/assets/5.DI5HceD6.png",o="/assets/6.B0QVmape.png",p="/assets/4.DAp6JO4C.jpg",c="/assets/1.VA-CzEkF.jpeg",u=JSON.parse('{"title":"重磅推荐！一秒拥有宇宙级算力！让你在人前，不！再！自！卑","description":"","frontmatter":{},"headers":[],"relativePath":"case/case4.md","filePath":"case/case4.md","lastUpdated":1720881864000}'),_={name:"case/case4.md"},i=a("",12),l=[i];function g(b,f,h,m,d,k){return e(),t("div",null,l)}const y=s(_,[["render",g]]);export{u as __pageData,y as default}; +import{_ as s,c as t,o as e,a4 as a}from"./chunks/framework.BmdFiWrL.js";const r="/assets/2.r5IbCoDU.png",n="/assets/5.DI5HceD6.png",o="/assets/6.B0QVmape.png",p="/assets/4.DAp6JO4C.jpg",c="/assets/1.VA-CzEkF.jpeg",u=JSON.parse('{"title":"重磅推荐！一秒拥有宇宙级算力！让你在人前，不！再！自！卑","description":"","frontmatter":{},"headers":[],"relativePath":"case/case4.md","filePath":"case/case4.md","lastUpdated":1720901424000}'),_={name:"case/case4.md"},i=a("",12),l=[i];function g(b,f,h,m,d,k){return e(),t("div",null,l)}const y=s(_,[["render",g]]);export{u as __pageData,y as default}; diff --git a/assets/case_case5.md.osZVBcFL.js b/assets/case_case5.md.XtRUITLa.js similarity index 99% rename from assets/case_case5.md.osZVBcFL.js rename to assets/case_case5.md.XtRUITLa.js index 5cc2afb8..c8080cf1 100644 --- a/assets/case_case5.md.osZVBcFL.js +++ b/assets/case_case5.md.XtRUITLa.js @@ -1,4 +1,4 @@ -import{_ as a,c as e,o as s,a4 as t}from"./chunks/framework.BmdFiWrL.js";const u=JSON.parse('{"title":"使用 Argo 隧道的哪吒服务端","description":"","frontmatter":{},"headers":[],"relativePath":"case/case5.md","filePath":"case/case5.md","lastUpdated":1720881864000}'),n={name:"case/case5.md"},r=t(`

使用 Argo 隧道的哪吒服务端 ​

贡献者:

项目地址：Argo-Nezha-Service-Container

镜像备份（非实时更新）：Argo-Nezha-Service-Container

目录 ​

项目特点: ​

image

准备需要用的变量 ​

image

面板域名加上 https:// 开头，回调地址再加上 /oauth2/callback 结尾

imageimageimageimageimage

Argo 认证的获取方式: json 或 token ​

Argo 隧道认证方式有 json 和 token，使用两个方式其中之一。推荐前者，理由脚本会处理好所有的 Argo 隧道参数和路径，后者需要到 Cloudflare 官网手动设置，容易出错。

(方式 1 - Json): ​

通过 Cloudflare Json 生成网轻松获取 Argo 隧道 json 信息: https://fscarmen.cloudflare.now.cc ​

image

(方式 2 - Token): 通过 Cloudflare 官网，手动生成 Argo 隧道 token 信息 ​

到 cf 官网：https://dash.cloudflare.com/ ​

imageimageimageimageimageimageimage

PaaS 部署实例 ​

镜像 fscarmen/argo-nezha:latest ， 支持 amd64 和 arm64 架构

用到的变量

变量名是否必须备注
GH_USER是github 的用户名，用于面板管理授权
GH_CLIENTID是在 github 上申请
GH_CLIENTSECRET是在 github 上申请
GH_BACKUP_USER否在 github 上备份哪吒服务端数据库的 github 用户名，不填则与面板管理授权的账户 GH_USER 一致
GH_REPO否在 github 上备份哪吒服务端数据库文件的 github 库
GH_EMAIL否github 的邮箱，用于备份的 git 推送到远程库
GH_PAT否github 的 PAT
ARGO_AUTH是Json: 从 https://fscarmen.cloudflare.now.cc 获取的 Argo Json
Token: 从 Cloudflare 官网获取
ARGO_DOMAIN是Argo 域名

Koyeb

Deploy to Koyeb

imageimageimageimageimage

VPS 部署方式 1 --- docker ​

docker 部署 ​

docker run -dit \\
+import{_ as a,c as e,o as s,a4 as t}from"./chunks/framework.BmdFiWrL.js";const u=JSON.parse('{"title":"使用 Argo 隧道的哪吒服务端","description":"","frontmatter":{},"headers":[],"relativePath":"case/case5.md","filePath":"case/case5.md","lastUpdated":1720901424000}'),n={name:"case/case5.md"},r=t(`
使用 Argo 隧道的哪吒服务端 ​
贡献者:
项目地址：Argo-Nezha-Service-Container
镜像备份（非实时更新）：Argo-Nezha-Service-Container
目录 ​
项目特点: ​
  • 适用范围更广 --- 只要能连通网络，就能安装哪吒服务端，如 LXC, OpenVZ VPS，Nas 虚拟机 , Container PaaS 等
  • Argo 隧道突破需要公网入口的限制 --- 传统的哪吒需要有两个公网端口，一个用于面板的访问，另一个用于客户端上报数据，本项目借用 Cloudflare Argo 隧道，使用内网穿透的办法
  • IPv4 / v6 具备更高的灵活性 --- 传统哪吒需要处理服务端和客户端的 IPv4/v6 兼容性问题，还需要通过 warp 等工具来解决不对应的情况。然而，本项目可以完全不需要考虑这些问题，可以任意对接，更加方便和简便
  • 一条 Argo 隧道分流多个域名和协议 --- 建立一条内网穿透的 Argo 隧道，即可分流三个域名(hostname)和协议(protocal)，分别用于面板的访问(http)，客户端上报数据(tcp)和 ssh（可选）
  • GrpcWebProxy 反向代理的 gRPC 数据端口 --- 配上证书做 tls 终结，然后 Argo 的隧道配置用 https 服务指向这个反向代理，启用http2回源，grpc(nezha)->GrpcWebProxy->h2(argo)->cf cdn edge->agent
  • 每天自动备份 --- 北京时间每天 4 时 0 分自动备份整个哪吒面板文件夹到指定的 github 私库，包括面板主题，面板设置，探针数据和隧道信息，备份保留近 5 天数据；鉴于内容十分重要，必须要放在私库
  • 每天自动更新面板 -- 北京时间每天 4 时 0 分自动检测最新的官方面板版本，有升级时自动更新
  • 手/自一体还原备份 --- 每分钟检测一次在线还原文件的内容，遇到有更新立刻还原
  • 默认内置本机探针 --- 能很方便的监控自身服务器信息
  • 数据更安全 --- Argo 隧道使用TLS加密通信，可以将应用程序流量安全地传输到 Cloudflare 网络，提高了应用程序的安全性和可靠性。此外，Argo Tunnel也可以防止IP泄露和DDoS攻击等网络威胁
image
准备需要用的变量 ​
  • 到 Cloudflare 官网，选择使用的域名，打开 网络 选项将 gRPC 开关打开
image
面板域名加上 https:// 开头，回调地址再加上 /oauth2/callback 结尾
imageimageimageimageimage
Argo 认证的获取方式: json 或 token ​
Argo 隧道认证方式有 json 和 token，使用两个方式其中之一。推荐前者，理由脚本会处理好所有的 Argo 隧道参数和路径，后者需要到 Cloudflare 官网手动设置，容易出错。
(方式 1 - Json): ​
通过 Cloudflare Json 生成网轻松获取 Argo 隧道 json 信息: https://fscarmen.cloudflare.now.cc ​
image
(方式 2 - Token): 通过 Cloudflare 官网，手动生成 Argo 隧道 token 信息 ​
到 cf 官网：https://dash.cloudflare.com/ ​
  • 进入 zero trust 里生成 token 隧道和信息。
  • 其中数据路径 443/https 为 proto.NezhaService
  • ssh 路径 22/ssh 为 < client id >
imageimageimageimageimageimageimage
PaaS 部署实例 ​
镜像 fscarmen/argo-nezha:latest ， 支持 amd64 和 arm64 架构
用到的变量
变量名是否必须备注
GH_USER是github 的用户名，用于面板管理授权
GH_CLIENTID是在 github 上申请
GH_CLIENTSECRET是在 github 上申请
GH_BACKUP_USER否在 github 上备份哪吒服务端数据库的 github 用户名，不填则与面板管理授权的账户 GH_USER 一致
GH_REPO否在 github 上备份哪吒服务端数据库文件的 github 库
GH_EMAIL否github 的邮箱，用于备份的 git 推送到远程库
GH_PAT否github 的 PAT
ARGO_AUTH是Json: 从 https://fscarmen.cloudflare.now.cc 获取的 Argo Json
 Token: 从 Cloudflare 官网获取
ARGO_DOMAIN是Argo 域名
Koyeb
Deploy to Koyeb
imageimageimageimageimage
VPS 部署方式 1 --- docker ​
  • 注意: ARGO_DOMAIN= 后面需要有单引号，不能去掉
  • 如果 VPS 是 IPv6 only 的，请先安装 WARP IPv4 或者双栈: https://gitlab.com/fscarmen/warp
  • 备份目录为当前路径的 dashboard 文件夹
docker 部署 ​
docker run -dit \\
            --name nezha_dashboard \\
            --pull always \\
            --restart always \\
diff --git a/assets/case_case5.md.osZVBcFL.lean.js b/assets/case_case5.md.XtRUITLa.lean.js
similarity index 85%
rename from assets/case_case5.md.osZVBcFL.lean.js
rename to assets/case_case5.md.XtRUITLa.lean.js
index a14beef5..723f6d9d 100644
--- a/assets/case_case5.md.osZVBcFL.lean.js
+++ b/assets/case_case5.md.XtRUITLa.lean.js
@@ -1 +1 @@
-import{_ as a,c as e,o as s,a4 as t}from"./chunks/framework.BmdFiWrL.js";const u=JSON.parse('{"title":"使用 Argo 隧道的哪吒服务端","description":"","frontmatter":{},"headers":[],"relativePath":"case/case5.md","filePath":"case/case5.md","lastUpdated":1720881864000}'),n={name:"case/case5.md"},r=t("",89),l=[r];function i(o,c,h,p,d,g){return s(),e("div",null,l)}const m=a(n,[["render",i]]);export{u as __pageData,m as default};
+import{_ as a,c as e,o as s,a4 as t}from"./chunks/framework.BmdFiWrL.js";const u=JSON.parse('{"title":"使用 Argo 隧道的哪吒服务端","description":"","frontmatter":{},"headers":[],"relativePath":"case/case5.md","filePath":"case/case5.md","lastUpdated":1720901424000}'),n={name:"case/case5.md"},r=t("",89),l=[r];function i(o,c,h,p,d,g){return s(),e("div",null,l)}const m=a(n,[["render",i]]);export{u as __pageData,m as default};
diff --git a/assets/case_index.md.4DjBqaIJ.js b/assets/case_index.md.CsiPlEOO.js
similarity index 94%
rename from assets/case_index.md.4DjBqaIJ.js
rename to assets/case_index.md.CsiPlEOO.js
index f198254e..7208835d 100644
--- a/assets/case_index.md.4DjBqaIJ.js
+++ b/assets/case_index.md.CsiPlEOO.js
@@ -1 +1 @@
-import{_ as e,c as t,o as a}from"./chunks/framework.BmdFiWrL.js";const p=JSON.parse('{"title":"哪吒监控 - 服务器监控与运维工具","titleTemplate":"社区项目","description":"","frontmatter":{"layout":"home","title":"哪吒监控 - 服务器监控与运维工具","titleTemplate":"社区项目","hero":{"name":"哪吒监控社区项目","text":"社区贡献的相关项目","tagline":"为哪吒监控提供了更多扩展","image":"https://raw.githubusercontent.com/naiba/nezha/master/resource/static/brand.svg","actions":[{"theme":"brand","text":"查看项目 →","link":"/case/case1"}]},"features":[{"title":"提交项目","details":"我们欢迎您提交自己的项目，请加入TG群联系管理员了解相关事宜"},{"title":"注意事项","details":"所有项目均由社区成员贡献，请您知悉哪吒监控团队无法为社区项目承担包括且不限于：保修、可用性、安全性等责任"}]},"headers":[],"relativePath":"case/index.md","filePath":"case/index.md","lastUpdated":1720881864000}'),s={name:"case/index.md"};function n(i,r,c,o,d,l){return a(),t("div")}const _=e(s,[["render",n]]);export{p as __pageData,_ as default};
+import{_ as e,c as t,o as a}from"./chunks/framework.BmdFiWrL.js";const p=JSON.parse('{"title":"哪吒监控 - 服务器监控与运维工具","titleTemplate":"社区项目","description":"","frontmatter":{"layout":"home","title":"哪吒监控 - 服务器监控与运维工具","titleTemplate":"社区项目","hero":{"name":"哪吒监控社区项目","text":"社区贡献的相关项目","tagline":"为哪吒监控提供了更多扩展","image":"https://raw.githubusercontent.com/naiba/nezha/master/resource/static/brand.svg","actions":[{"theme":"brand","text":"查看项目 →","link":"/case/case1"}]},"features":[{"title":"提交项目","details":"我们欢迎您提交自己的项目，请加入TG群联系管理员了解相关事宜"},{"title":"注意事项","details":"所有项目均由社区成员贡献，请您知悉哪吒监控团队无法为社区项目承担包括且不限于：保修、可用性、安全性等责任"}]},"headers":[],"relativePath":"case/index.md","filePath":"case/index.md","lastUpdated":1720901424000}'),s={name:"case/index.md"};function n(i,r,c,o,d,l){return a(),t("div")}const _=e(s,[["render",n]]);export{p as __pageData,_ as default};
diff --git a/assets/case_index.md.4DjBqaIJ.lean.js b/assets/case_index.md.CsiPlEOO.lean.js
similarity index 94%
rename from assets/case_index.md.4DjBqaIJ.lean.js
rename to assets/case_index.md.CsiPlEOO.lean.js
index f198254e..7208835d 100644
--- a/assets/case_index.md.4DjBqaIJ.lean.js
+++ b/assets/case_index.md.CsiPlEOO.lean.js
@@ -1 +1 @@
-import{_ as e,c as t,o as a}from"./chunks/framework.BmdFiWrL.js";const p=JSON.parse('{"title":"哪吒监控 - 服务器监控与运维工具","titleTemplate":"社区项目","description":"","frontmatter":{"layout":"home","title":"哪吒监控 - 服务器监控与运维工具","titleTemplate":"社区项目","hero":{"name":"哪吒监控社区项目","text":"社区贡献的相关项目","tagline":"为哪吒监控提供了更多扩展","image":"https://raw.githubusercontent.com/naiba/nezha/master/resource/static/brand.svg","actions":[{"theme":"brand","text":"查看项目 →","link":"/case/case1"}]},"features":[{"title":"提交项目","details":"我们欢迎您提交自己的项目，请加入TG群联系管理员了解相关事宜"},{"title":"注意事项","details":"所有项目均由社区成员贡献，请您知悉哪吒监控团队无法为社区项目承担包括且不限于：保修、可用性、安全性等责任"}]},"headers":[],"relativePath":"case/index.md","filePath":"case/index.md","lastUpdated":1720881864000}'),s={name:"case/index.md"};function n(i,r,c,o,d,l){return a(),t("div")}const _=e(s,[["render",n]]);export{p as __pageData,_ as default};
+import{_ as e,c as t,o as a}from"./chunks/framework.BmdFiWrL.js";const p=JSON.parse('{"title":"哪吒监控 - 服务器监控与运维工具","titleTemplate":"社区项目","description":"","frontmatter":{"layout":"home","title":"哪吒监控 - 服务器监控与运维工具","titleTemplate":"社区项目","hero":{"name":"哪吒监控社区项目","text":"社区贡献的相关项目","tagline":"为哪吒监控提供了更多扩展","image":"https://raw.githubusercontent.com/naiba/nezha/master/resource/static/brand.svg","actions":[{"theme":"brand","text":"查看项目 →","link":"/case/case1"}]},"features":[{"title":"提交项目","details":"我们欢迎您提交自己的项目，请加入TG群联系管理员了解相关事宜"},{"title":"注意事项","details":"所有项目均由社区成员贡献，请您知悉哪吒监控团队无法为社区项目承担包括且不限于：保修、可用性、安全性等责任"}]},"headers":[],"relativePath":"case/index.md","filePath":"case/index.md","lastUpdated":1720901424000}'),s={name:"case/index.md"};function n(i,r,c,o,d,l){return a(),t("div")}const _=e(s,[["render",n]]);export{p as __pageData,_ as default};
diff --git a/assets/developer_index.md.DUiahKCM.js b/assets/developer_index.md.xxGfpZF3.js
similarity index 92%
rename from assets/developer_index.md.DUiahKCM.js
rename to assets/developer_index.md.xxGfpZF3.js
index 2a5a681e..b170dc4e 100644
--- a/assets/developer_index.md.DUiahKCM.js
+++ b/assets/developer_index.md.xxGfpZF3.js
@@ -1 +1 @@
-import{_ as e,c as t,o as a}from"./chunks/framework.BmdFiWrL.js";const m=JSON.parse('{"title":"哪吒监控 - 服务器监控与运维工具","titleTemplate":"开发手册","description":"","frontmatter":{"layout":"home","title":"哪吒监控 - 服务器监控与运维工具","titleTemplate":"开发手册","hero":{"name":"开发手册","text":"哪吒监控开发手册","tagline":"我们欢迎你提出高质量的Pull Request，帮助哪吒监控变得更好！","image":"https://raw.githubusercontent.com/naiba/nezha/master/resource/static/brand.svg","actions":[{"theme":"brand","text":"开始使用 →","link":"/developer/theme"}]}},"headers":[],"relativePath":"developer/index.md","filePath":"developer/index.md","lastUpdated":1720881864000}'),r={name:"developer/index.md"};function n(o,s,i,d,l,c){return a(),t("div")}const h=e(r,[["render",n]]);export{m as __pageData,h as default};
+import{_ as e,c as t,o as a}from"./chunks/framework.BmdFiWrL.js";const m=JSON.parse('{"title":"哪吒监控 - 服务器监控与运维工具","titleTemplate":"开发手册","description":"","frontmatter":{"layout":"home","title":"哪吒监控 - 服务器监控与运维工具","titleTemplate":"开发手册","hero":{"name":"开发手册","text":"哪吒监控开发手册","tagline":"我们欢迎你提出高质量的Pull Request，帮助哪吒监控变得更好！","image":"https://raw.githubusercontent.com/naiba/nezha/master/resource/static/brand.svg","actions":[{"theme":"brand","text":"开始使用 →","link":"/developer/theme"}]}},"headers":[],"relativePath":"developer/index.md","filePath":"developer/index.md","lastUpdated":1720901424000}'),r={name:"developer/index.md"};function n(o,s,i,d,l,c){return a(),t("div")}const h=e(r,[["render",n]]);export{m as __pageData,h as default};
diff --git a/assets/developer_index.md.DUiahKCM.lean.js b/assets/developer_index.md.xxGfpZF3.lean.js
similarity index 92%
rename from assets/developer_index.md.DUiahKCM.lean.js
rename to assets/developer_index.md.xxGfpZF3.lean.js
index 2a5a681e..b170dc4e 100644
--- a/assets/developer_index.md.DUiahKCM.lean.js
+++ b/assets/developer_index.md.xxGfpZF3.lean.js
@@ -1 +1 @@
-import{_ as e,c as t,o as a}from"./chunks/framework.BmdFiWrL.js";const m=JSON.parse('{"title":"哪吒监控 - 服务器监控与运维工具","titleTemplate":"开发手册","description":"","frontmatter":{"layout":"home","title":"哪吒监控 - 服务器监控与运维工具","titleTemplate":"开发手册","hero":{"name":"开发手册","text":"哪吒监控开发手册","tagline":"我们欢迎你提出高质量的Pull Request，帮助哪吒监控变得更好！","image":"https://raw.githubusercontent.com/naiba/nezha/master/resource/static/brand.svg","actions":[{"theme":"brand","text":"开始使用 →","link":"/developer/theme"}]}},"headers":[],"relativePath":"developer/index.md","filePath":"developer/index.md","lastUpdated":1720881864000}'),r={name:"developer/index.md"};function n(o,s,i,d,l,c){return a(),t("div")}const h=e(r,[["render",n]]);export{m as __pageData,h as default};
+import{_ as e,c as t,o as a}from"./chunks/framework.BmdFiWrL.js";const m=JSON.parse('{"title":"哪吒监控 - 服务器监控与运维工具","titleTemplate":"开发手册","description":"","frontmatter":{"layout":"home","title":"哪吒监控 - 服务器监控与运维工具","titleTemplate":"开发手册","hero":{"name":"开发手册","text":"哪吒监控开发手册","tagline":"我们欢迎你提出高质量的Pull Request，帮助哪吒监控变得更好！","image":"https://raw.githubusercontent.com/naiba/nezha/master/resource/static/brand.svg","actions":[{"theme":"brand","text":"开始使用 →","link":"/developer/theme"}]}},"headers":[],"relativePath":"developer/index.md","filePath":"developer/index.md","lastUpdated":1720901424000}'),r={name:"developer/index.md"};function n(o,s,i,d,l,c){return a(),t("div")}const h=e(r,[["render",n]]);export{m as __pageData,h as default};
diff --git a/assets/developer_l10n.md.CeCojXbD.js b/assets/developer_l10n.md.BAFYrTMh.js
similarity index 96%
rename from assets/developer_l10n.md.CeCojXbD.js
rename to assets/developer_l10n.md.BAFYrTMh.js
index 98773a37..296feb35 100644
--- a/assets/developer_l10n.md.CeCojXbD.js
+++ b/assets/developer_l10n.md.BAFYrTMh.js
@@ -1 +1 @@
-import{_ as e,c as a,o,a4 as l}from"./chunks/framework.BmdFiWrL.js";const u=JSON.parse('{"title":"l10n 本地化开发指南","description":"","frontmatter":{},"headers":[],"relativePath":"developer/l10n.md","filePath":"developer/l10n.md","lastUpdated":1720881864000}'),t={name:"developer/l10n.md"},r=l('
l10n 本地化开发指南 ​
哪吒监控的 Dashboard 已经添加本地化，支持多个语言，你可以在开发新功能时遵循以下步骤来支持本地化
介绍 ​
  1. 你可以直接使用 /resource/l10n/zh-CN.toml 中已有的文本配置来替换新功能中的文本
  2. 如果新功能中有新增文本，请参考 zh-CN.toml 的配置文本，将新文本拉取到 zh-CN.toml 等其他语言的配置文件中，并添加翻译
新本地化文本的添加 ​
  1. 在 /resource/l10n/ 中添加新的语言文本配置
  2. 在新的语言文本配置中拉取其他语言已有的文本配置
  3. 为新的语言文本配置添加翻译
',6),n=[r];function d(c,i,s,_,h,p){return o(),a("div",null,n)}const f=e(t,[["render",d]]);export{u as __pageData,f as default};
+import{_ as e,c as a,o,a4 as l}from"./chunks/framework.BmdFiWrL.js";const u=JSON.parse('{"title":"l10n 本地化开发指南","description":"","frontmatter":{},"headers":[],"relativePath":"developer/l10n.md","filePath":"developer/l10n.md","lastUpdated":1720901424000}'),t={name:"developer/l10n.md"},r=l('
l10n 本地化开发指南 ​
哪吒监控的 Dashboard 已经添加本地化，支持多个语言，你可以在开发新功能时遵循以下步骤来支持本地化
介绍 ​
  1. 你可以直接使用 /resource/l10n/zh-CN.toml 中已有的文本配置来替换新功能中的文本
  2. 如果新功能中有新增文本，请参考 zh-CN.toml 的配置文本，将新文本拉取到 zh-CN.toml 等其他语言的配置文件中，并添加翻译
新本地化文本的添加 ​
  1. 在 /resource/l10n/ 中添加新的语言文本配置
  2. 在新的语言文本配置中拉取其他语言已有的文本配置
  3. 为新的语言文本配置添加翻译
',6),n=[r];function d(c,i,s,_,h,p){return o(),a("div",null,n)}const f=e(t,[["render",d]]);export{u as __pageData,f as default};
diff --git a/assets/developer_l10n.md.CeCojXbD.lean.js b/assets/developer_l10n.md.BAFYrTMh.lean.js
similarity index 85%
rename from assets/developer_l10n.md.CeCojXbD.lean.js
rename to assets/developer_l10n.md.BAFYrTMh.lean.js
index bc060bf6..7cbf8cf5 100644
--- a/assets/developer_l10n.md.CeCojXbD.lean.js
+++ b/assets/developer_l10n.md.BAFYrTMh.lean.js
@@ -1 +1 @@
-import{_ as e,c as a,o,a4 as l}from"./chunks/framework.BmdFiWrL.js";const u=JSON.parse('{"title":"l10n 本地化开发指南","description":"","frontmatter":{},"headers":[],"relativePath":"developer/l10n.md","filePath":"developer/l10n.md","lastUpdated":1720881864000}'),t={name:"developer/l10n.md"},r=l("",6),n=[r];function d(c,i,s,_,h,p){return o(),a("div",null,n)}const f=e(t,[["render",d]]);export{u as __pageData,f as default};
+import{_ as e,c as a,o,a4 as l}from"./chunks/framework.BmdFiWrL.js";const u=JSON.parse('{"title":"l10n 本地化开发指南","description":"","frontmatter":{},"headers":[],"relativePath":"developer/l10n.md","filePath":"developer/l10n.md","lastUpdated":1720901424000}'),t={name:"developer/l10n.md"},r=l("",6),n=[r];function d(c,i,s,_,h,p){return o(),a("div",null,n)}const f=e(t,[["render",d]]);export{u as __pageData,f as default};
diff --git a/assets/developer_theme.md.DwRLCISJ.js b/assets/developer_theme.md.C0RMjrhD.js
similarity index 96%
rename from assets/developer_theme.md.DwRLCISJ.js
rename to assets/developer_theme.md.C0RMjrhD.js
index 90397d15..86fd35d7 100644
--- a/assets/developer_theme.md.DwRLCISJ.js
+++ b/assets/developer_theme.md.C0RMjrhD.js
@@ -1 +1 @@
-import{_ as e,c as a,o,a4 as t}from"./chunks/framework.BmdFiWrL.js";const u=JSON.parse('{"title":"哪吒主题开发环境","description":"","frontmatter":{},"headers":[],"relativePath":"developer/theme.md","filePath":"developer/theme.md","lastUpdated":1720881864000}'),c={name:"developer/theme.md"},l=t('
哪吒主题开发环境 ​
哪吒面板提供了主题开发环境，你可以使用它来创建新的哪吒监控主题
WARNING
请注意： 此开发环境仅支持 dashboard v0.13.16 及更新版本。
使用说明 ​
  1. 克隆此仓库到本地
  2. 修改 data/config.yaml 中的 Oauth2 配置（回调连接可以填 http://localhost）
  3. 运行 docker-compose up
  4. 开始开发
  5. 主题制作完成之后可以将 theme-custom 放置到服务器上的 /opt/nezha/dashboard/theme-custom 位置
FAQ ​
  • 如果不能使用 80 端口，在 docker-compose.yaml 中修改配置。
',7),d=[l];function r(s,i,h,n,m,_){return o(),a("div",null,d)}const f=e(c,[["render",r]]);export{u as __pageData,f as default};
+import{_ as e,c as a,o,a4 as t}from"./chunks/framework.BmdFiWrL.js";const u=JSON.parse('{"title":"哪吒主题开发环境","description":"","frontmatter":{},"headers":[],"relativePath":"developer/theme.md","filePath":"developer/theme.md","lastUpdated":1720901424000}'),c={name:"developer/theme.md"},l=t('
哪吒主题开发环境 ​
哪吒面板提供了主题开发环境，你可以使用它来创建新的哪吒监控主题
WARNING
请注意： 此开发环境仅支持 dashboard v0.13.16 及更新版本。
使用说明 ​
  1. 克隆此仓库到本地
  2. 修改 data/config.yaml 中的 Oauth2 配置（回调连接可以填 http://localhost）
  3. 运行 docker-compose up
  4. 开始开发
  5. 主题制作完成之后可以将 theme-custom 放置到服务器上的 /opt/nezha/dashboard/theme-custom 位置
FAQ ​
  • 如果不能使用 80 端口，在 docker-compose.yaml 中修改配置。
',7),d=[l];function r(s,i,h,n,m,_){return o(),a("div",null,d)}const f=e(c,[["render",r]]);export{u as __pageData,f as default};
diff --git a/assets/developer_theme.md.DwRLCISJ.lean.js b/assets/developer_theme.md.C0RMjrhD.lean.js
similarity index 85%
rename from assets/developer_theme.md.DwRLCISJ.lean.js
rename to assets/developer_theme.md.C0RMjrhD.lean.js
index 9b0d2a6b..1ba9af73 100644
--- a/assets/developer_theme.md.DwRLCISJ.lean.js
+++ b/assets/developer_theme.md.C0RMjrhD.lean.js
@@ -1 +1 @@
-import{_ as e,c as a,o,a4 as t}from"./chunks/framework.BmdFiWrL.js";const u=JSON.parse('{"title":"哪吒主题开发环境","description":"","frontmatter":{},"headers":[],"relativePath":"developer/theme.md","filePath":"developer/theme.md","lastUpdated":1720881864000}'),c={name:"developer/theme.md"},l=t("",7),d=[l];function r(s,i,h,n,m,_){return o(),a("div",null,d)}const f=e(c,[["render",r]]);export{u as __pageData,f as default};
+import{_ as e,c as a,o,a4 as t}from"./chunks/framework.BmdFiWrL.js";const u=JSON.parse('{"title":"哪吒主题开发环境","description":"","frontmatter":{},"headers":[],"relativePath":"developer/theme.md","filePath":"developer/theme.md","lastUpdated":1720901424000}'),c={name:"developer/theme.md"},l=t("",7),d=[l];function r(s,i,h,n,m,_){return o(),a("div",null,d)}const f=e(c,[["render",r]]);export{u as __pageData,f as default};
diff --git a/assets/en_US_case_case1.md.ByY4CFbz.js b/assets/en_US_case_case1.md.V6itg62M.js
similarity index 95%
rename from assets/en_US_case_case1.md.ByY4CFbz.js
rename to assets/en_US_case_case1.md.V6itg62M.js
index 92679796..055629b6 100644
--- a/assets/en_US_case_case1.md.ByY4CFbz.js
+++ b/assets/en_US_case_case1.md.V6itg62M.js
@@ -1 +1 @@
-import{_ as e,c as t,o as r,a4 as o}from"./chunks/framework.BmdFiWrL.js";const d=JSON.parse('{"title":"Build your own Telegram bot to query server information","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/case/case1.md","filePath":"en_US/case/case1.md","lastUpdated":1720881864000}'),a={name:"en_US/case/case1.md"},n=o('
Build your own Telegram bot to query server information ​
Contributors:
Project: nezha_api_tgbot (Chinese)
Mirror backup, non-real-time update: nezha_api_tgbot (Chinese)
The bot can request server status information from the Dashboard through the API, and then send the information to the user.
 You can build this bot to easily view the current status of a given server without opening the Dashboard.
',6),i=[n];function s(h,_,l,u,c,p){return r(),t("div",null,i)}const m=e(a,[["render",s]]);export{d as __pageData,m as default};
+import{_ as e,c as t,o as r,a4 as o}from"./chunks/framework.BmdFiWrL.js";const d=JSON.parse('{"title":"Build your own Telegram bot to query server information","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/case/case1.md","filePath":"en_US/case/case1.md","lastUpdated":1720901424000}'),a={name:"en_US/case/case1.md"},n=o('
Build your own Telegram bot to query server information ​
Contributors:
Project: nezha_api_tgbot (Chinese)
Mirror backup, non-real-time update: nezha_api_tgbot (Chinese)
The bot can request server status information from the Dashboard through the API, and then send the information to the user.
 You can build this bot to easily view the current status of a given server without opening the Dashboard.
',6),i=[n];function s(h,_,l,u,c,p){return r(),t("div",null,i)}const m=e(a,[["render",s]]);export{d as __pageData,m as default};
diff --git a/assets/en_US_case_case1.md.ByY4CFbz.lean.js b/assets/en_US_case_case1.md.V6itg62M.lean.js
similarity index 86%
rename from assets/en_US_case_case1.md.ByY4CFbz.lean.js
rename to assets/en_US_case_case1.md.V6itg62M.lean.js
index 5c98dbbd..bfdccb54 100644
--- a/assets/en_US_case_case1.md.ByY4CFbz.lean.js
+++ b/assets/en_US_case_case1.md.V6itg62M.lean.js
@@ -1 +1 @@
-import{_ as e,c as t,o as r,a4 as o}from"./chunks/framework.BmdFiWrL.js";const d=JSON.parse('{"title":"Build your own Telegram bot to query server information","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/case/case1.md","filePath":"en_US/case/case1.md","lastUpdated":1720881864000}'),a={name:"en_US/case/case1.md"},n=o("",6),i=[n];function s(h,_,l,u,c,p){return r(),t("div",null,i)}const m=e(a,[["render",s]]);export{d as __pageData,m as default};
+import{_ as e,c as t,o as r,a4 as o}from"./chunks/framework.BmdFiWrL.js";const d=JSON.parse('{"title":"Build your own Telegram bot to query server information","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/case/case1.md","filePath":"en_US/case/case1.md","lastUpdated":1720901424000}'),a={name:"en_US/case/case1.md"},n=o("",6),i=[n];function s(h,_,l,u,c,p){return r(),t("div",null,i)}const m=e(a,[["render",s]]);export{d as __pageData,m as default};
diff --git a/assets/en_US_case_case2.md.e4I5L63c.js b/assets/en_US_case_case2.md.A3YJEqVR.js
similarity index 97%
rename from assets/en_US_case_case2.md.e4I5L63c.js
rename to assets/en_US_case_case2.md.A3YJEqVR.js
index 76e43653..49fc0153 100644
--- a/assets/en_US_case_case2.md.e4I5L63c.js
+++ b/assets/en_US_case_case2.md.A3YJEqVR.js
@@ -1 +1 @@
-import{_ as e}from"./chunks/qrcode.CZOxHFH-.js";import{_ as t,c as r,o,a4 as s}from"./chunks/framework.BmdFiWrL.js";const f=JSON.parse('{"title":"Use Siri to run shortcut to check server status in iOS/MacOS","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/case/case2.md","filePath":"en_US/case/case2.md","lastUpdated":1720881864000}'),a={name:"en_US/case/case2.md"},c=s('
Use Siri to run shortcut to check server status in iOS/MacOS ​
Current Version：V1.0 (Chinese)
 Contributor:
Get shortcut command ​
Scan the following QR code with your iPhone or iPad to get the shortcut

coode


 MacOS users please visit here to get the shortcut
How to use ​
  • After getting the shortcut, open and edit the shortcut
  • Fill in Dashboard URL, API Token, Server ID in the three text boxes
  • Save the edit and test run, if you can get the result, the setting is correct.
  • Modify the name of the shortcut, such as: Server Status, then you can use Siri command: "Hey Siri, Server Status" to get the server status.
WARNING
Each shortcut can only monitor one server, if you need to monitor more than one server, please copy this shortcut several times and configure them separately, then modify the shortcut name separately, such as; Server 1 Status, Server 2 Status, etc.
',8),i=[c];function h(n,u,l,d,m,_){return o(),r("div",null,i)}const b=t(a,[["render",h]]);export{f as __pageData,b as default};
+import{_ as e}from"./chunks/qrcode.CZOxHFH-.js";import{_ as t,c as r,o,a4 as s}from"./chunks/framework.BmdFiWrL.js";const f=JSON.parse('{"title":"Use Siri to run shortcut to check server status in iOS/MacOS","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/case/case2.md","filePath":"en_US/case/case2.md","lastUpdated":1720901424000}'),a={name:"en_US/case/case2.md"},c=s('
Use Siri to run shortcut to check server status in iOS/MacOS ​
Current Version：V1.0 (Chinese)
 Contributor:
Get shortcut command ​
Scan the following QR code with your iPhone or iPad to get the shortcut

coode


 MacOS users please visit here to get the shortcut
How to use ​
  • After getting the shortcut, open and edit the shortcut
  • Fill in Dashboard URL, API Token, Server ID in the three text boxes
  • Save the edit and test run, if you can get the result, the setting is correct.
  • Modify the name of the shortcut, such as: Server Status, then you can use Siri command: "Hey Siri, Server Status" to get the server status.
WARNING
Each shortcut can only monitor one server, if you need to monitor more than one server, please copy this shortcut several times and configure them separately, then modify the shortcut name separately, such as; Server 1 Status, Server 2 Status, etc.
',8),i=[c];function h(n,u,l,d,m,_){return o(),r("div",null,i)}const b=t(a,[["render",h]]);export{f as __pageData,b as default};
diff --git a/assets/en_US_case_case2.md.e4I5L63c.lean.js b/assets/en_US_case_case2.md.A3YJEqVR.lean.js
similarity index 87%
rename from assets/en_US_case_case2.md.e4I5L63c.lean.js
rename to assets/en_US_case_case2.md.A3YJEqVR.lean.js
index 717a8bf9..2e8bbb18 100644
--- a/assets/en_US_case_case2.md.e4I5L63c.lean.js
+++ b/assets/en_US_case_case2.md.A3YJEqVR.lean.js
@@ -1 +1 @@
-import{_ as e}from"./chunks/qrcode.CZOxHFH-.js";import{_ as t,c as r,o,a4 as s}from"./chunks/framework.BmdFiWrL.js";const f=JSON.parse('{"title":"Use Siri to run shortcut to check server status in iOS/MacOS","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/case/case2.md","filePath":"en_US/case/case2.md","lastUpdated":1720881864000}'),a={name:"en_US/case/case2.md"},c=s("",8),i=[c];function h(n,u,l,d,m,_){return o(),r("div",null,i)}const b=t(a,[["render",h]]);export{f as __pageData,b as default};
+import{_ as e}from"./chunks/qrcode.CZOxHFH-.js";import{_ as t,c as r,o,a4 as s}from"./chunks/framework.BmdFiWrL.js";const f=JSON.parse('{"title":"Use Siri to run shortcut to check server status in iOS/MacOS","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/case/case2.md","filePath":"en_US/case/case2.md","lastUpdated":1720901424000}'),a={name:"en_US/case/case2.md"},c=s("",8),i=[c];function h(n,u,l,d,m,_){return o(),r("div",null,i)}const b=t(a,[["render",h]]);export{f as __pageData,b as default};
diff --git a/assets/en_US_case_case3.md.CpXzTru0.js b/assets/en_US_case_case3.md.D2W661N3.js
similarity index 97%
rename from assets/en_US_case_case3.md.CpXzTru0.js
rename to assets/en_US_case_case3.md.D2W661N3.js
index 040d0dc0..870d8d21 100644
--- a/assets/en_US_case_case3.md.CpXzTru0.js
+++ b/assets/en_US_case_case3.md.D2W661N3.js
@@ -1 +1 @@
-import{_ as t,c as e,o as r,a4 as a}from"./chunks/framework.BmdFiWrL.js";const _=JSON.parse('{"title":"Build your own server status query Telegram bot","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/case/case3.md","filePath":"en_US/case/case3.md","lastUpdated":1720881864000}'),d={name:"en_US/case/case3.md"},o=a('
Build your own server status query Telegram bot ​
Contributor:
GitHub project: nezha_telegram_bot（English is already supported）
Mirror backup, non-real-time update : nezha_telegram_bot（English is already supported）
Features ​
  • [x] Support Chinese/English multi-language switch
  • [x] Support tag statistics (CPU, disk, memory, upstream and downstream speed, traffic statistics, etc.)
  • [x] Support real-time refresh of single server data
  • [x] Support keyboard interactive query
  • [x] Support query by command
  • [x] Support adding bot to group, privacy protection of bot replies in group chat
  • [x] Support bot messages automatic deletion in group chat within 20 seconds
  • [x] Support docker deployment
Commands list ​
CommandDescriptionPrivate chat only
startGetting started with the keyboard main menu✔️
helphelp message❌
addAdd Nezha monitoring url link and token✔️
urlAdd Nezha monitoring url link✔️
tokenAdd Nezha monitoring token✔️
infoGet saved Nezha monitoring url link and token✔️
deleteDelete saved Nezha monitoring url link and token✔️
idAdd an integer id after the command to query the information of a single server (refresh button only available in private chat)❌
allQuery statistics for all servers❌
searchSearch for keywords in server names (multiple keywords supported, split by spaces)❌
',9),i=[o];function s(n,l,u,h,c,p){return r(),e("div",null,i)}const b=t(d,[["render",s]]);export{_ as __pageData,b as default};
+import{_ as t,c as e,o as r,a4 as a}from"./chunks/framework.BmdFiWrL.js";const _=JSON.parse('{"title":"Build your own server status query Telegram bot","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/case/case3.md","filePath":"en_US/case/case3.md","lastUpdated":1720901424000}'),d={name:"en_US/case/case3.md"},o=a('
Build your own server status query Telegram bot ​
Contributor:
GitHub project: nezha_telegram_bot（English is already supported）
Mirror backup, non-real-time update : nezha_telegram_bot（English is already supported）
Features ​
  • [x] Support Chinese/English multi-language switch
  • [x] Support tag statistics (CPU, disk, memory, upstream and downstream speed, traffic statistics, etc.)
  • [x] Support real-time refresh of single server data
  • [x] Support keyboard interactive query
  • [x] Support query by command
  • [x] Support adding bot to group, privacy protection of bot replies in group chat
  • [x] Support bot messages automatic deletion in group chat within 20 seconds
  • [x] Support docker deployment
Commands list ​
CommandDescriptionPrivate chat only
startGetting started with the keyboard main menu✔️
helphelp message❌
addAdd Nezha monitoring url link and token✔️
urlAdd Nezha monitoring url link✔️
tokenAdd Nezha monitoring token✔️
infoGet saved Nezha monitoring url link and token✔️
deleteDelete saved Nezha monitoring url link and token✔️
idAdd an integer id after the command to query the information of a single server (refresh button only available in private chat)❌
allQuery statistics for all servers❌
searchSearch for keywords in server names (multiple keywords supported, split by spaces)❌
',9),i=[o];function s(n,l,u,h,c,p){return r(),e("div",null,i)}const b=t(d,[["render",s]]);export{_ as __pageData,b as default};
diff --git a/assets/en_US_case_case3.md.CpXzTru0.lean.js b/assets/en_US_case_case3.md.D2W661N3.lean.js
similarity index 86%
rename from assets/en_US_case_case3.md.CpXzTru0.lean.js
rename to assets/en_US_case_case3.md.D2W661N3.lean.js
index 57259d7e..fca528ff 100644
--- a/assets/en_US_case_case3.md.CpXzTru0.lean.js
+++ b/assets/en_US_case_case3.md.D2W661N3.lean.js
@@ -1 +1 @@
-import{_ as t,c as e,o as r,a4 as a}from"./chunks/framework.BmdFiWrL.js";const _=JSON.parse('{"title":"Build your own server status query Telegram bot","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/case/case3.md","filePath":"en_US/case/case3.md","lastUpdated":1720881864000}'),d={name:"en_US/case/case3.md"},o=a("",9),i=[o];function s(n,l,u,h,c,p){return r(),e("div",null,i)}const b=t(d,[["render",s]]);export{_ as __pageData,b as default};
+import{_ as t,c as e,o as r,a4 as a}from"./chunks/framework.BmdFiWrL.js";const _=JSON.parse('{"title":"Build your own server status query Telegram bot","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/case/case3.md","filePath":"en_US/case/case3.md","lastUpdated":1720901424000}'),d={name:"en_US/case/case3.md"},o=a("",9),i=[o];function s(n,l,u,h,c,p){return r(),e("div",null,i)}const b=t(d,[["render",s]]);export{_ as __pageData,b as default};
diff --git a/assets/en_US_case_case4.md.BY6h5Lyf.js b/assets/en_US_case_case4.md.BNCQiUe2.js
similarity index 94%
rename from assets/en_US_case_case4.md.BY6h5Lyf.js
rename to assets/en_US_case_case4.md.BNCQiUe2.js
index dcbf594e..7b3b231c 100644
--- a/assets/en_US_case_case4.md.BY6h5Lyf.js
+++ b/assets/en_US_case_case4.md.BNCQiUe2.js
@@ -1 +1 @@
-import{_ as e,c as a,o as t,a4 as r}from"./chunks/framework.BmdFiWrL.js";const g=JSON.parse('{"title":"Fake-agent, monitoring data cheater","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/case/case4.md","filePath":"en_US/case/case4.md","lastUpdated":1720881864000}'),n={name:"en_US/case/case4.md"},o=r('
Fake-agent, monitoring data cheater ​
Contributor:
GitHub project: fake-nezha-agent（Chinese）
 Mirror backup, non-real-time update ：fake-nezha-agent（Chinese）
You can modify the monitoring data uploaded to Dashboard by the Agent
 Use it for cheating 😈
',5),i=[o];function s(c,h,_,d,f,l){return t(),a("div",null,i)}const m=e(n,[["render",s]]);export{g as __pageData,m as default};
+import{_ as e,c as a,o as t,a4 as r}from"./chunks/framework.BmdFiWrL.js";const g=JSON.parse('{"title":"Fake-agent, monitoring data cheater","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/case/case4.md","filePath":"en_US/case/case4.md","lastUpdated":1720901424000}'),n={name:"en_US/case/case4.md"},o=r('
Fake-agent, monitoring data cheater ​
Contributor:
GitHub project: fake-nezha-agent（Chinese）
 Mirror backup, non-real-time update ：fake-nezha-agent（Chinese）
You can modify the monitoring data uploaded to Dashboard by the Agent
 Use it for cheating 😈
',5),i=[o];function s(c,h,_,d,f,l){return t(),a("div",null,i)}const m=e(n,[["render",s]]);export{g as __pageData,m as default};
diff --git a/assets/en_US_case_case4.md.BY6h5Lyf.lean.js b/assets/en_US_case_case4.md.BNCQiUe2.lean.js
similarity index 85%
rename from assets/en_US_case_case4.md.BY6h5Lyf.lean.js
rename to assets/en_US_case_case4.md.BNCQiUe2.lean.js
index f1ea6615..21c47aab 100644
--- a/assets/en_US_case_case4.md.BY6h5Lyf.lean.js
+++ b/assets/en_US_case_case4.md.BNCQiUe2.lean.js
@@ -1 +1 @@
-import{_ as e,c as a,o as t,a4 as r}from"./chunks/framework.BmdFiWrL.js";const g=JSON.parse('{"title":"Fake-agent, monitoring data cheater","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/case/case4.md","filePath":"en_US/case/case4.md","lastUpdated":1720881864000}'),n={name:"en_US/case/case4.md"},o=r("",5),i=[o];function s(c,h,_,d,f,l){return t(),a("div",null,i)}const m=e(n,[["render",s]]);export{g as __pageData,m as default};
+import{_ as e,c as a,o as t,a4 as r}from"./chunks/framework.BmdFiWrL.js";const g=JSON.parse('{"title":"Fake-agent, monitoring data cheater","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/case/case4.md","filePath":"en_US/case/case4.md","lastUpdated":1720901424000}'),n={name:"en_US/case/case4.md"},o=r("",5),i=[o];function s(c,h,_,d,f,l){return t(),a("div",null,i)}const m=e(n,[["render",s]]);export{g as __pageData,m as default};
diff --git a/assets/en_US_case_case5.md.DA6NprQ-.js b/assets/en_US_case_case5.md.CvvuNTjh.js
similarity index 99%
rename from assets/en_US_case_case5.md.DA6NprQ-.js
rename to assets/en_US_case_case5.md.CvvuNTjh.js
index 67f5dd61..0ec33937 100644
--- a/assets/en_US_case_case5.md.DA6NprQ-.js
+++ b/assets/en_US_case_case5.md.CvvuNTjh.js
@@ -1,4 +1,4 @@
-import{_ as e,c as a,o as t,a4 as n}from"./chunks/framework.BmdFiWrL.js";const g=JSON.parse('{"title":"Nezha server over Argo tunnel","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/case/case5.md","filePath":"en_US/case/case5.md","lastUpdated":1720881864000}'),s={name:"en_US/case/case5.md"},o=n(`
Nezha server over Argo tunnel ​
Contributors:
GitHub project: Argo-Nezha-Service-Container
Mirror backup (not live update): Argo-Nezha-Service-Container
Catalog ​
Project Features. ​
  • Wider scope of application --- As long as there is a network connection, Nezha server can be installed, such as LXC, OpenVZ VPS, Nas Virtual Machine, Container PaaS, etc.
  • Argo tunnel breaks through the restriction of requiring a public network portal --- The traditional Nezha requires two public network ports, one for panel visiting and the other for client reporting, this project uses Cloudflare Argo tunnels and uses intranet tunneling.
  • IPv4 / v6 with higher flexibility --- The traditional Nezha needs to deal with IPv4/v6 compatibility between server and client, and also needs to resolve mismatches through tools such as warp. However, this project does not need to consider these issues at all, and can be docked arbitrarily, which is much more convenient and easy!
  • One Argo tunnel for multiple domains and protocols --- Create an intranet-penetrating Argo tunnel for three domains (hostname) and protocols, which can be used for panel access (http), client reporting (tcp) and ssh (optional).
  • GrpcWebProxy reverse proxy gRPC data port --- with a certificate for tls termination, then Argo's tunnel configuration with https service pointing to this reverse proxy, enable http2 back to the source, grpc(nezha)->GrpcWebProxy->h2(argo)->cf cdn edge->agent
  • Daily automatic backup --- every day at 04:00 BST, the entire Nezha panel folder is automatically backed up to a designated private github repository, including panel themes, panel settings, probe data and tunnel information, the backup retains nearly 5 days of data; the content is so important that it must be placed in the private repository.
  • Automatic daily panel update -- the latest official panel version is automatically detected every day at 4:00 BST, and updated when there is an upgrade.
  • Manual/automatic restore backup --- check the content of online restore file once a minute, and restore immediately when there is any update.
  • Default built-in local probes --- can easily monitor their own server information
  • More secure data --- Argo Tunnel uses TLS encrypted communication to securely transmit application traffic to the Cloudflare network, improving application security and reliability. In addition, Argo Tunnel protects against network threats such as IP leaks and DDoS attacks.
image
Prepare variables to be used ​
  • Visit the Cloudflare website, select the domain name you want to use, and turn on the network option to turn the gRPC switch on.
image
Add https:// to the beginning of the panel's domain name and /oauth2/callback to the end of the callback address.
imageimageimageimageimage
How to get Argo authentication: json or token ​
Argo tunnel authentication methods include json and token, use one of the two methods. The former is recommended because the script will handle all the Argo tunnel parameters and paths, while the latter needs to be set manually on the Cloudflare website and is prone to errors.
(Methods 1 - Json): ​
Easily get Argo tunnel json information through Cloudflare Json Generation Network: https://fscarmen.cloudflare.now.cc ​
image
(Methods 2 - Token): Manually generate Argo tunnel token information via Cloudflare website. ​
Go to the cf website: https://dash.cloudflare.com/ ​
  • Go to zero trust and generate token tunnel and message.
  • The data path 443/https is proto.
  • ssh path 22/ssh for < client id >.
imageimageimageimageimageimageimage
PaaS Deployment Example ​
Image fscarmen/argo-nezha:latest, supports amd64 and arm64 architectures.
Variables used
Variable NameRequiredRemarks
GH_USERYesgithub username for panel admin authorization
GH_CLIENTIDyesapply on github
GH_CLIENTSECRETyesapply on github
GH_BACKUP_USERNoThe github username for backing up Nezha's server-side database on github, if not filled in, it is the same as the account GH_USER for panel management authorization
GH_REPONoThe github repository for backing up Nezha's server-side database files on github
GH_EMAILNogithub's mailbox for git push backups to remote repositories
GH_PATNogithub's PAT
ARGO_AUTHYesArgo Json from https://fscarmen.cloudflare.now.cc
Argo token from Cloudflare official website
ARGO_DOMAINYesArgo domain
Koyeb
Deploy to Koyeb
imageimageimageimageimage
VPS Deployment Method 1 --- docker ​
  • Note: ARGO_DOMAIN= must be followed by single quotes, which cannot be removed.
  • If the VPS is IPv6 only, please install WARP IPv4 or dual-stack first: https://github.com/fscarmen/warp
  • The backup directory is the dashboard folder in the current path.
docker deployment ​
docker run -dit \\
+import{_ as e,c as a,o as t,a4 as n}from"./chunks/framework.BmdFiWrL.js";const g=JSON.parse('{"title":"Nezha server over Argo tunnel","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/case/case5.md","filePath":"en_US/case/case5.md","lastUpdated":1720901424000}'),s={name:"en_US/case/case5.md"},o=n(`
Nezha server over Argo tunnel ​
Contributors:
GitHub project: Argo-Nezha-Service-Container
Mirror backup (not live update): Argo-Nezha-Service-Container
Catalog ​
Project Features. ​
  • Wider scope of application --- As long as there is a network connection, Nezha server can be installed, such as LXC, OpenVZ VPS, Nas Virtual Machine, Container PaaS, etc.
  • Argo tunnel breaks through the restriction of requiring a public network portal --- The traditional Nezha requires two public network ports, one for panel visiting and the other for client reporting, this project uses Cloudflare Argo tunnels and uses intranet tunneling.
  • IPv4 / v6 with higher flexibility --- The traditional Nezha needs to deal with IPv4/v6 compatibility between server and client, and also needs to resolve mismatches through tools such as warp. However, this project does not need to consider these issues at all, and can be docked arbitrarily, which is much more convenient and easy!
  • One Argo tunnel for multiple domains and protocols --- Create an intranet-penetrating Argo tunnel for three domains (hostname) and protocols, which can be used for panel access (http), client reporting (tcp) and ssh (optional).
  • GrpcWebProxy reverse proxy gRPC data port --- with a certificate for tls termination, then Argo's tunnel configuration with https service pointing to this reverse proxy, enable http2 back to the source, grpc(nezha)->GrpcWebProxy->h2(argo)->cf cdn edge->agent
  • Daily automatic backup --- every day at 04:00 BST, the entire Nezha panel folder is automatically backed up to a designated private github repository, including panel themes, panel settings, probe data and tunnel information, the backup retains nearly 5 days of data; the content is so important that it must be placed in the private repository.
  • Automatic daily panel update -- the latest official panel version is automatically detected every day at 4:00 BST, and updated when there is an upgrade.
  • Manual/automatic restore backup --- check the content of online restore file once a minute, and restore immediately when there is any update.
  • Default built-in local probes --- can easily monitor their own server information
  • More secure data --- Argo Tunnel uses TLS encrypted communication to securely transmit application traffic to the Cloudflare network, improving application security and reliability. In addition, Argo Tunnel protects against network threats such as IP leaks and DDoS attacks.
image
Prepare variables to be used ​
  • Visit the Cloudflare website, select the domain name you want to use, and turn on the network option to turn the gRPC switch on.
image
Add https:// to the beginning of the panel's domain name and /oauth2/callback to the end of the callback address.
imageimageimageimageimage
How to get Argo authentication: json or token ​
Argo tunnel authentication methods include json and token, use one of the two methods. The former is recommended because the script will handle all the Argo tunnel parameters and paths, while the latter needs to be set manually on the Cloudflare website and is prone to errors.
(Methods 1 - Json): ​
Easily get Argo tunnel json information through Cloudflare Json Generation Network: https://fscarmen.cloudflare.now.cc ​
image
(Methods 2 - Token): Manually generate Argo tunnel token information via Cloudflare website. ​
Go to the cf website: https://dash.cloudflare.com/ ​
  • Go to zero trust and generate token tunnel and message.
  • The data path 443/https is proto.
  • ssh path 22/ssh for < client id >.
imageimageimageimageimageimageimage
PaaS Deployment Example ​
Image fscarmen/argo-nezha:latest, supports amd64 and arm64 architectures.
Variables used
Variable NameRequiredRemarks
GH_USERYesgithub username for panel admin authorization
GH_CLIENTIDyesapply on github
GH_CLIENTSECRETyesapply on github
GH_BACKUP_USERNoThe github username for backing up Nezha's server-side database on github, if not filled in, it is the same as the account GH_USER for panel management authorization
GH_REPONoThe github repository for backing up Nezha's server-side database files on github
GH_EMAILNogithub's mailbox for git push backups to remote repositories
GH_PATNogithub's PAT
ARGO_AUTHYesArgo Json from https://fscarmen.cloudflare.now.cc
Argo token from Cloudflare official website
ARGO_DOMAINYesArgo domain
Koyeb
Deploy to Koyeb
imageimageimageimageimage
VPS Deployment Method 1 --- docker ​
  • Note: ARGO_DOMAIN= must be followed by single quotes, which cannot be removed.
  • If the VPS is IPv6 only, please install WARP IPv4 or dual-stack first: https://github.com/fscarmen/warp
  • The backup directory is the dashboard folder in the current path.
docker deployment ​
docker run -dit \\
            --name nezha_dashboard \\
            --pull always \\
            --restart always \\
diff --git a/assets/en_US_case_case5.md.DA6NprQ-.lean.js b/assets/en_US_case_case5.md.CvvuNTjh.lean.js
similarity index 85%
rename from assets/en_US_case_case5.md.DA6NprQ-.lean.js
rename to assets/en_US_case_case5.md.CvvuNTjh.lean.js
index 5857471b..f2c012ab 100644
--- a/assets/en_US_case_case5.md.DA6NprQ-.lean.js
+++ b/assets/en_US_case_case5.md.CvvuNTjh.lean.js
@@ -1 +1 @@
-import{_ as e,c as a,o as t,a4 as n}from"./chunks/framework.BmdFiWrL.js";const g=JSON.parse('{"title":"Nezha server over Argo tunnel","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/case/case5.md","filePath":"en_US/case/case5.md","lastUpdated":1720881864000}'),s={name:"en_US/case/case5.md"},o=n("",89),r=[o];function i(l,c,h,d,p,u){return t(),a("div",null,r)}const f=e(s,[["render",i]]);export{g as __pageData,f as default};
+import{_ as e,c as a,o as t,a4 as n}from"./chunks/framework.BmdFiWrL.js";const g=JSON.parse('{"title":"Nezha server over Argo tunnel","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/case/case5.md","filePath":"en_US/case/case5.md","lastUpdated":1720901424000}'),s={name:"en_US/case/case5.md"},o=n("",89),r=[o];function i(l,c,h,d,p,u){return t(),a("div",null,r)}const f=e(s,[["render",i]]);export{g as __pageData,f as default};
diff --git a/assets/en_US_case_index.md.BohQDlQR.js b/assets/en_US_case_index.md.Dx-Wd6dm.js
similarity index 95%
rename from assets/en_US_case_index.md.BohQDlQR.js
rename to assets/en_US_case_index.md.Dx-Wd6dm.js
index cec8f38a..b341e19f 100644
--- a/assets/en_US_case_index.md.BohQDlQR.js
+++ b/assets/en_US_case_index.md.Dx-Wd6dm.js
@@ -1 +1 @@
-import{_ as e,c as t,o}from"./chunks/framework.BmdFiWrL.js";const u=JSON.parse('{"title":"Nezha Monitoring - Server monitoring tool","titleTemplate":"Community Project","description":"","frontmatter":{"layout":"home","title":"Nezha Monitoring - Server monitoring tool","titleTemplate":"Community Project","hero":{"name":"Nezha Monitoring","text":"Community Project","tagline":"Nezha Monitoring has benefited from various projects contributed by the community, which have provided it with additional extensions.","image":"https://raw.githubusercontent.com/naiba/nezha/master/resource/static/brand.svg","actions":[{"theme":"brand","text":"Learn More →","link":"/en_US/case/case1"}]},"features":[{"title":"Submit a project","details":"We welcome you to submit your own project. Please join the Telegram group to contact the administrator for further information."},{"title":"Important Notes","details":"All projects are contributed by community members. Please be aware that the Nezha Monitoring Team cannot assume responsibility for community projects, including but not limited to warranty, availability, security, etc."}]},"headers":[],"relativePath":"en_US/case/index.md","filePath":"en_US/case/index.md","lastUpdated":1720881864000}'),a={name:"en_US/case/index.md"};function i(n,r,s,c,m,l){return o(),t("div")}const h=e(a,[["render",i]]);export{u as __pageData,h as default};
+import{_ as e,c as t,o}from"./chunks/framework.BmdFiWrL.js";const u=JSON.parse('{"title":"Nezha Monitoring - Server monitoring tool","titleTemplate":"Community Project","description":"","frontmatter":{"layout":"home","title":"Nezha Monitoring - Server monitoring tool","titleTemplate":"Community Project","hero":{"name":"Nezha Monitoring","text":"Community Project","tagline":"Nezha Monitoring has benefited from various projects contributed by the community, which have provided it with additional extensions.","image":"https://raw.githubusercontent.com/naiba/nezha/master/resource/static/brand.svg","actions":[{"theme":"brand","text":"Learn More →","link":"/en_US/case/case1"}]},"features":[{"title":"Submit a project","details":"We welcome you to submit your own project. Please join the Telegram group to contact the administrator for further information."},{"title":"Important Notes","details":"All projects are contributed by community members. Please be aware that the Nezha Monitoring Team cannot assume responsibility for community projects, including but not limited to warranty, availability, security, etc."}]},"headers":[],"relativePath":"en_US/case/index.md","filePath":"en_US/case/index.md","lastUpdated":1720901424000}'),a={name:"en_US/case/index.md"};function i(n,r,s,c,m,l){return o(),t("div")}const h=e(a,[["render",i]]);export{u as __pageData,h as default};
diff --git a/assets/en_US_case_index.md.BohQDlQR.lean.js b/assets/en_US_case_index.md.Dx-Wd6dm.lean.js
similarity index 95%
rename from assets/en_US_case_index.md.BohQDlQR.lean.js
rename to assets/en_US_case_index.md.Dx-Wd6dm.lean.js
index cec8f38a..b341e19f 100644
--- a/assets/en_US_case_index.md.BohQDlQR.lean.js
+++ b/assets/en_US_case_index.md.Dx-Wd6dm.lean.js
@@ -1 +1 @@
-import{_ as e,c as t,o}from"./chunks/framework.BmdFiWrL.js";const u=JSON.parse('{"title":"Nezha Monitoring - Server monitoring tool","titleTemplate":"Community Project","description":"","frontmatter":{"layout":"home","title":"Nezha Monitoring - Server monitoring tool","titleTemplate":"Community Project","hero":{"name":"Nezha Monitoring","text":"Community Project","tagline":"Nezha Monitoring has benefited from various projects contributed by the community, which have provided it with additional extensions.","image":"https://raw.githubusercontent.com/naiba/nezha/master/resource/static/brand.svg","actions":[{"theme":"brand","text":"Learn More →","link":"/en_US/case/case1"}]},"features":[{"title":"Submit a project","details":"We welcome you to submit your own project. Please join the Telegram group to contact the administrator for further information."},{"title":"Important Notes","details":"All projects are contributed by community members. Please be aware that the Nezha Monitoring Team cannot assume responsibility for community projects, including but not limited to warranty, availability, security, etc."}]},"headers":[],"relativePath":"en_US/case/index.md","filePath":"en_US/case/index.md","lastUpdated":1720881864000}'),a={name:"en_US/case/index.md"};function i(n,r,s,c,m,l){return o(),t("div")}const h=e(a,[["render",i]]);export{u as __pageData,h as default};
+import{_ as e,c as t,o}from"./chunks/framework.BmdFiWrL.js";const u=JSON.parse('{"title":"Nezha Monitoring - Server monitoring tool","titleTemplate":"Community Project","description":"","frontmatter":{"layout":"home","title":"Nezha Monitoring - Server monitoring tool","titleTemplate":"Community Project","hero":{"name":"Nezha Monitoring","text":"Community Project","tagline":"Nezha Monitoring has benefited from various projects contributed by the community, which have provided it with additional extensions.","image":"https://raw.githubusercontent.com/naiba/nezha/master/resource/static/brand.svg","actions":[{"theme":"brand","text":"Learn More →","link":"/en_US/case/case1"}]},"features":[{"title":"Submit a project","details":"We welcome you to submit your own project. Please join the Telegram group to contact the administrator for further information."},{"title":"Important Notes","details":"All projects are contributed by community members. Please be aware that the Nezha Monitoring Team cannot assume responsibility for community projects, including but not limited to warranty, availability, security, etc."}]},"headers":[],"relativePath":"en_US/case/index.md","filePath":"en_US/case/index.md","lastUpdated":1720901424000}'),a={name:"en_US/case/index.md"};function i(n,r,s,c,m,l){return o(),t("div")}const h=e(a,[["render",i]]);export{u as __pageData,h as default};
diff --git a/assets/en_US_developer_index.md.BDrJUsur.js b/assets/en_US_developer_index.md.pRAEvIf8.js
similarity index 92%
rename from assets/en_US_developer_index.md.BDrJUsur.js
rename to assets/en_US_developer_index.md.pRAEvIf8.js
index c997efa9..7c9c9716 100644
--- a/assets/en_US_developer_index.md.BDrJUsur.js
+++ b/assets/en_US_developer_index.md.pRAEvIf8.js
@@ -1 +1 @@
-import{_ as e,c as t,o as n}from"./chunks/framework.BmdFiWrL.js";const c=JSON.parse('{"title":"Nezha Monitoring - Server monitoring tool","titleTemplate":"Development Manual","description":"","frontmatter":{"layout":"home","title":"Nezha Monitoring - Server monitoring tool","titleTemplate":"Development Manual","hero":{"name":"Development Manual","text":"Nezha Monitoring Development Manual.","image":"https://raw.githubusercontent.com/naiba/nezha/master/resource/static/brand.svg","actions":[{"theme":"brand","text":"Start Now →","link":"/en_US/developer/theme"}]}},"headers":[],"relativePath":"en_US/developer/index.md","filePath":"en_US/developer/index.md","lastUpdated":1720881864000}'),a={name:"en_US/developer/index.md"};function o(r,i,l,m,s,p){return n(),t("div")}const _=e(a,[["render",o]]);export{c as __pageData,_ as default};
+import{_ as e,c as t,o as n}from"./chunks/framework.BmdFiWrL.js";const c=JSON.parse('{"title":"Nezha Monitoring - Server monitoring tool","titleTemplate":"Development Manual","description":"","frontmatter":{"layout":"home","title":"Nezha Monitoring - Server monitoring tool","titleTemplate":"Development Manual","hero":{"name":"Development Manual","text":"Nezha Monitoring Development Manual.","image":"https://raw.githubusercontent.com/naiba/nezha/master/resource/static/brand.svg","actions":[{"theme":"brand","text":"Start Now →","link":"/en_US/developer/theme"}]}},"headers":[],"relativePath":"en_US/developer/index.md","filePath":"en_US/developer/index.md","lastUpdated":1720901424000}'),a={name:"en_US/developer/index.md"};function o(r,i,l,m,s,p){return n(),t("div")}const _=e(a,[["render",o]]);export{c as __pageData,_ as default};
diff --git a/assets/en_US_developer_index.md.BDrJUsur.lean.js b/assets/en_US_developer_index.md.pRAEvIf8.lean.js
similarity index 92%
rename from assets/en_US_developer_index.md.BDrJUsur.lean.js
rename to assets/en_US_developer_index.md.pRAEvIf8.lean.js
index c997efa9..7c9c9716 100644
--- a/assets/en_US_developer_index.md.BDrJUsur.lean.js
+++ b/assets/en_US_developer_index.md.pRAEvIf8.lean.js
@@ -1 +1 @@
-import{_ as e,c as t,o as n}from"./chunks/framework.BmdFiWrL.js";const c=JSON.parse('{"title":"Nezha Monitoring - Server monitoring tool","titleTemplate":"Development Manual","description":"","frontmatter":{"layout":"home","title":"Nezha Monitoring - Server monitoring tool","titleTemplate":"Development Manual","hero":{"name":"Development Manual","text":"Nezha Monitoring Development Manual.","image":"https://raw.githubusercontent.com/naiba/nezha/master/resource/static/brand.svg","actions":[{"theme":"brand","text":"Start Now →","link":"/en_US/developer/theme"}]}},"headers":[],"relativePath":"en_US/developer/index.md","filePath":"en_US/developer/index.md","lastUpdated":1720881864000}'),a={name:"en_US/developer/index.md"};function o(r,i,l,m,s,p){return n(),t("div")}const _=e(a,[["render",o]]);export{c as __pageData,_ as default};
+import{_ as e,c as t,o as n}from"./chunks/framework.BmdFiWrL.js";const c=JSON.parse('{"title":"Nezha Monitoring - Server monitoring tool","titleTemplate":"Development Manual","description":"","frontmatter":{"layout":"home","title":"Nezha Monitoring - Server monitoring tool","titleTemplate":"Development Manual","hero":{"name":"Development Manual","text":"Nezha Monitoring Development Manual.","image":"https://raw.githubusercontent.com/naiba/nezha/master/resource/static/brand.svg","actions":[{"theme":"brand","text":"Start Now →","link":"/en_US/developer/theme"}]}},"headers":[],"relativePath":"en_US/developer/index.md","filePath":"en_US/developer/index.md","lastUpdated":1720901424000}'),a={name:"en_US/developer/index.md"};function o(r,i,l,m,s,p){return n(),t("div")}const _=e(a,[["render",o]]);export{c as __pageData,_ as default};
diff --git a/assets/en_US_developer_l10n.md.CPk2FH8T.js b/assets/en_US_developer_l10n.md.BRCCxeYb.js
similarity index 96%
rename from assets/en_US_developer_l10n.md.CPk2FH8T.js
rename to assets/en_US_developer_l10n.md.BRCCxeYb.js
index d3747497..323d8c7f 100644
--- a/assets/en_US_developer_l10n.md.CPk2FH8T.js
+++ b/assets/en_US_developer_l10n.md.BRCCxeYb.js
@@ -1 +1 @@
-import{_ as e,c as t,o as a,a4 as o}from"./chunks/framework.BmdFiWrL.js";const g=JSON.parse('{"title":"Localization","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/developer/l10n.md","filePath":"en_US/developer/l10n.md","lastUpdated":1720881864000}'),n={name:"en_US/developer/l10n.md"},i=o('
Localization ​
Nezha Monitoring's Dashboard has added localization to support multiple languages, and you can follow these steps to support localization when developing new features
Introduction ​
  1. You can directly use the text configuration already available in /resource/l10n/en-US.toml to replace the text in the new feature.
  2. If there is new text in the new feature, please refer to the configuration text in en-US.toml, pull the new text into the configuration files of other languages such as en-US.toml, and add translations.
Adding a new localized text file ​
  1. Add a new language text configuration in /resource/l10n/.
  2. Pull existing text configurations from other languages in the new language text configuration.
  3. Add translations for the new language text configuration.
',6),l=[i];function r(d,c,s,u,h,f){return a(),t("div",null,l)}const p=e(n,[["render",r]]);export{g as __pageData,p as default};
+import{_ as e,c as t,o as a,a4 as o}from"./chunks/framework.BmdFiWrL.js";const g=JSON.parse('{"title":"Localization","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/developer/l10n.md","filePath":"en_US/developer/l10n.md","lastUpdated":1720901424000}'),n={name:"en_US/developer/l10n.md"},i=o('
Localization ​
Nezha Monitoring's Dashboard has added localization to support multiple languages, and you can follow these steps to support localization when developing new features
Introduction ​
  1. You can directly use the text configuration already available in /resource/l10n/en-US.toml to replace the text in the new feature.
  2. If there is new text in the new feature, please refer to the configuration text in en-US.toml, pull the new text into the configuration files of other languages such as en-US.toml, and add translations.
Adding a new localized text file ​
  1. Add a new language text configuration in /resource/l10n/.
  2. Pull existing text configurations from other languages in the new language text configuration.
  3. Add translations for the new language text configuration.
',6),l=[i];function r(d,c,s,u,h,f){return a(),t("div",null,l)}const p=e(n,[["render",r]]);export{g as __pageData,p as default};
diff --git a/assets/en_US_developer_l10n.md.CPk2FH8T.lean.js b/assets/en_US_developer_l10n.md.BRCCxeYb.lean.js
similarity index 85%
rename from assets/en_US_developer_l10n.md.CPk2FH8T.lean.js
rename to assets/en_US_developer_l10n.md.BRCCxeYb.lean.js
index 5e4cab6f..25ad19a2 100644
--- a/assets/en_US_developer_l10n.md.CPk2FH8T.lean.js
+++ b/assets/en_US_developer_l10n.md.BRCCxeYb.lean.js
@@ -1 +1 @@
-import{_ as e,c as t,o as a,a4 as o}from"./chunks/framework.BmdFiWrL.js";const g=JSON.parse('{"title":"Localization","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/developer/l10n.md","filePath":"en_US/developer/l10n.md","lastUpdated":1720881864000}'),n={name:"en_US/developer/l10n.md"},i=o("",6),l=[i];function r(d,c,s,u,h,f){return a(),t("div",null,l)}const p=e(n,[["render",r]]);export{g as __pageData,p as default};
+import{_ as e,c as t,o as a,a4 as o}from"./chunks/framework.BmdFiWrL.js";const g=JSON.parse('{"title":"Localization","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/developer/l10n.md","filePath":"en_US/developer/l10n.md","lastUpdated":1720901424000}'),n={name:"en_US/developer/l10n.md"},i=o("",6),l=[i];function r(d,c,s,u,h,f){return a(),t("div",null,l)}const p=e(n,[["render",r]]);export{g as __pageData,p as default};
diff --git a/assets/en_US_developer_theme.md.CEA7TVXg.js b/assets/en_US_developer_theme.md.BX8kubGu.js
similarity index 96%
rename from assets/en_US_developer_theme.md.CEA7TVXg.js
rename to assets/en_US_developer_theme.md.BX8kubGu.js
index a996429b..0fb4871a 100644
--- a/assets/en_US_developer_theme.md.CEA7TVXg.js
+++ b/assets/en_US_developer_theme.md.BX8kubGu.js
@@ -1 +1 @@
-import{_ as e,c as o,o as t,a4 as a}from"./chunks/framework.BmdFiWrL.js";const _=JSON.parse('{"title":"Nezha Theme Development Environment","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/developer/theme.md","filePath":"en_US/developer/theme.md","lastUpdated":1720881864000}'),n={name:"en_US/developer/theme.md"},c=a('
Nezha Theme Development Environment ​
Nezha Monitoring provides a theme development environment that you can use to create new Nezha Monitoring themes
WARNING
Please note: This development environment only supports dashboard v0.13.16 and newer versions.
How to use ​
  1. Clone this repository to local
  2. Modify the Oauth2 configuration in data/config.yaml（The callback connection can be filled with http://localhost）
  3. Run docker-compose up
  4. Start development
  5. Once the theme has been created, you can place theme-custom in /opt/nezha/dashboard/theme-custom on the server
FAQ ​
  • If you can't use port 80, change the configuration in docker-compose.yaml.
',7),r=[c];function l(i,h,d,s,m,p){return t(),o("div",null,r)}const v=e(n,[["render",l]]);export{_ as __pageData,v as default};
+import{_ as e,c as o,o as t,a4 as a}from"./chunks/framework.BmdFiWrL.js";const _=JSON.parse('{"title":"Nezha Theme Development Environment","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/developer/theme.md","filePath":"en_US/developer/theme.md","lastUpdated":1720901424000}'),n={name:"en_US/developer/theme.md"},c=a('
Nezha Theme Development Environment ​
Nezha Monitoring provides a theme development environment that you can use to create new Nezha Monitoring themes
WARNING
Please note: This development environment only supports dashboard v0.13.16 and newer versions.
How to use ​
  1. Clone this repository to local
  2. Modify the Oauth2 configuration in data/config.yaml（The callback connection can be filled with http://localhost）
  3. Run docker-compose up
  4. Start development
  5. Once the theme has been created, you can place theme-custom in /opt/nezha/dashboard/theme-custom on the server
FAQ ​
  • If you can't use port 80, change the configuration in docker-compose.yaml.
',7),r=[c];function l(i,h,d,s,m,p){return t(),o("div",null,r)}const v=e(n,[["render",l]]);export{_ as __pageData,v as default};
diff --git a/assets/en_US_developer_theme.md.CEA7TVXg.lean.js b/assets/en_US_developer_theme.md.BX8kubGu.lean.js
similarity index 86%
rename from assets/en_US_developer_theme.md.CEA7TVXg.lean.js
rename to assets/en_US_developer_theme.md.BX8kubGu.lean.js
index 5c5bb917..ae6e6a1a 100644
--- a/assets/en_US_developer_theme.md.CEA7TVXg.lean.js
+++ b/assets/en_US_developer_theme.md.BX8kubGu.lean.js
@@ -1 +1 @@
-import{_ as e,c as o,o as t,a4 as a}from"./chunks/framework.BmdFiWrL.js";const _=JSON.parse('{"title":"Nezha Theme Development Environment","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/developer/theme.md","filePath":"en_US/developer/theme.md","lastUpdated":1720881864000}'),n={name:"en_US/developer/theme.md"},c=a("",7),r=[c];function l(i,h,d,s,m,p){return t(),o("div",null,r)}const v=e(n,[["render",l]]);export{_ as __pageData,v as default};
+import{_ as e,c as o,o as t,a4 as a}from"./chunks/framework.BmdFiWrL.js";const _=JSON.parse('{"title":"Nezha Theme Development Environment","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/developer/theme.md","filePath":"en_US/developer/theme.md","lastUpdated":1720901424000}'),n={name:"en_US/developer/theme.md"},c=a("",7),r=[c];function l(i,h,d,s,m,p){return t(),o("div",null,r)}const v=e(n,[["render",l]]);export{_ as __pageData,v as default};
diff --git a/assets/en_US_guide_agent.md.BuV95h8M.js b/assets/en_US_guide_agent.md.BuV95h8M.js
new file mode 100644
index 00000000..7b3bbb39
--- /dev/null
+++ b/assets/en_US_guide_agent.md.BuV95h8M.js
@@ -0,0 +1,66 @@
+import{_ as s,c as i,o as a,a4 as e}from"./chunks/framework.BmdFiWrL.js";const F=JSON.parse('{"title":"Install Agent","description":"","frontmatter":{"outline":"deep"},"headers":[],"relativePath":"en_US/guide/agent.md","filePath":"en_US/guide/agent.md","lastUpdated":1720901424000}'),n={name:"en_US/guide/agent.md"},t=e(`
Install Agent ​
This document will introduce how to install the Agent on the monitored server and connect it to the Dashboard.
TIP
The repository for Agent binaries can be found at: https://github.com/nezhahq/agent/releases
One-Click Installation of the Agent ​
Nezha Monitoring supports one-click installation of the Agent on both Windows and Linux. By following the steps in this document, you can easily deploy it on your server.
Preparation ​
You need to set up a communication domain in the admin panel in advance, and this domain should not be connected to a CDN. This document uses the example communication domain “data.example.com”.
 Go to the settings page in the admin panel, fill in the communication domain in the “Non-CDN Dashboard Server Domain/IP” field, and click "Save".
One-Click Installation on Linux ​
  1. First, add a server in the admin panel.
  2. Click the green Linux icon button next to the newly added server and copy the one-click installation command.
  3. Run the copied installation command on the monitored server, and wait for the installation to complete. Then, check if the server is online in the Dashboard home page.
One-Click Installation on macOS ​
  1. First, add a server in the admin panel.
  2. Click the green Apple icon button next to the newly added server and copy the one-click installation command.
  3. Run the copied installation command on the monitored server, and wait for the installation to complete. Then, check if the server is online in the Dashboard home page.
One-Click Installation on Windows ​
  1. First, add a server in the admin panel.
  2. Click the green Windows icon button next to the newly added server and copy the one-click installation command.
  3. Go to the Windows server, run PowerShell, and execute the copied installation command in PowerShell.
  4. If you encounter a prompt to "change execution policy," choose Y.
  5. Wait for the installation to complete, then check if the server is online in the Dashboard home page.
WARNING
If you encounter errors when running the one-click installation command in PowerShell, try the Manual Installation of the Agent on Windows below.
Other Ways to Install the Agent ​
Installing the Agent on Linux (Support most distros) ​
Click to expand/collapse
  1. First, add a server in the admin panel.
  2. Run the script on the monitored server:
bash
curl -L https://raw.githubusercontent.com/naiba/nezha/master/script/install_en.sh  -o nezha.sh && chmod +x nezha.sh && sudo ./nezha.sh
  1. Select “Install monitoring Agent.”
  2. Enter the communication domain, such as "data.example.com".
  3. Enter the dashboard communication port (gRPC port), default is 5555.
  4. Enter the Agent secret, which is generated when you add a server in the admin panel and can be found on the “Servers” page in the admin panel.
  5. Wait for the installation to complete, then check if the server is online in the Dashboard home page.
Installing the Agent using the built-in service command (Support most systems) ​
Click to expand/collapse
First, get a copy of Nezha Agent: https://github.com/nezhahq/agent/releases
After extracting the archive, run the following command to install the service (may require root permission):
bash
./nezha-agent service install -s server_name:port -p password
You can also add other arguments except the server address and password. For more details, refer to the documentation: Customizing Agent Monitoring Items.
Uninstall the service:
bash
./nezha-agent service uninstall
Start the service:
bash
./nezha-agent service start
Stop the service:
bash
./nezha-agent service stop
Restart the service:
bash
./nezha-agent service restart
Installing the Agent with runit ​
Click to expand/collapse
The built-in service command of Agent supports most init systems, including FreeBSD rc.d and openrc, but still missing some of them.
Here we take Void Linux's runit as an example:
  1. Create directory /etc/sv/nezha-agent:
bash
mkdir /etc/sv/nezha-agent
  1. Create service file /etc/sv/nezha-agent/run, with following content:
bash
#!/bin/sh
+exec 2>&1
+exec /opt/nezha/agent/nezha-agent -s server_name:port -p password 2>&1
You can add other arguments here as well.
  1. Create logging service file /etc/sv/nezha-agent/log/run:
bash
#!/bin/sh
+exec vlogger -t nezha-agent -p daemon
  1. Enable the service:
bash
sudo ln -s /etc/sv/nezha-agent/ /var/service
Use the sv command to manage the service.
How to view logs:
  1. Install socklog and enable it:
bash
sudo xbps-install -S socklog-void
+sudo ln -s /etc/sv/socklog-unix /var/service
  1. Run svlogtail:
bash
sudo svlogtail | grep nezha-agent
Manual Installation of the Agent on Windows ​
Installing the Agent on Synology DSM ​
Click to expand/collapse
sh
# Agent path
+EXEC="/PATH/TO/nezha-agent"
+# Log path
+LOG="\${EXEC}.log"
+# Additional execution parameters, can be empty
+ARGS=""
+# Nezha server gRPC address
+SERVER="HOST_OR_IP:gRPC_PORT"
+# The secret key obtained in the previous step
+SECRET="APP_SECRET"
+# User running the service, *strongly recommended to use non-root user*
+RUN_USER="nezha"
+
+# Write to systemd service file
+cat << EOF > /usr/lib/systemd/system/nezha.service
+[Unit]
+Description=Nezha Agent Service
+After=network.target
+
+[Service]
+Type=simple
+ExecStart=/bin/nohup \${EXEC} \${ARGS} -s \${SERVER} -p \${SECRET} &>> \${LOG} &
+ExecStop=ps -fe |grep nezha-agent|awk '{print \\$2}'|xargs kill
+User=\${RUN_USER}
+
+Restart=on-abort
+
+[Install]
+WantedBy=multi-user.target
+EOF
+
+# Reload service
+systemctl daemon-reload
+# Start service
+systemctl start nezha
+# Enable service startup
+systemctl enable nezha
‼️ Modify the corresponding information before running the above commands with the root account to complete the installation.
Installing the Agent on macOS Using Homebrew ​
Click to expand/collapse
This section is adapted from 🐿️松鼠收集🌰 with the author's permission
WARNING
Please be sure to add environment variables before installing nezha-agent through Homebrew! Homebrew creates the service-required plist file during software installation, and if you add the environment variables after installation, it will fail to start due to missing parameters.
  1. Add environment variables:
shell
echo 'export HOMEBREW_NEZHA_AGENT_PASSWORD="Communication key, obtained from the service page"' >> ~/.zshrc
+echo 'export HOMEBREW_NEZHA_AGENT_SERVER="Your server and port, format your.domain:5555 "' >> ~/.zshrc
+source ~/.zshrc
  1. Install Nezha Agent:
DANGER
Note that this Homebrew repository is maintained by a third party and is unrelated to Nezha Monitoring. The Nezha project team does not endorse this repository's usability, security, etc. Please evaluate the risks yourself before using!
Since it has not yet been submitted to the Homebrew Core official library, it is temporarily placed in the third-party Homebrew repository maintained by the author of the blog:
shell
brew install brewforge/chinese/nezha-agent
  1. Start Nezha Agent service through Homebrew:
shell
brew services start nezha-agent
  1. Check the service status:
shell
brew services info nezha-agent
  1. Stop the service:
shell
brew services stop nezha-agent
  1. Uninstall Nezha Agent:
shell
brew rm nezha-agent
  1. If there is an error, first check the environment variables:
shell
echo $HOMEBREW_NEZHA_AGENT_PASSWORD
+echo $HOMEBREW_NEZHA_AGENT_SERVER
  1. If the environment variables are configured correctly, try reinstalling:
shell
brew services stop nezha-agent
+brew reinstall nezha-agent
+brew services start nezha-agent
  1. If the issue persists, submit a issue to the third-party Homebrew repository.
Installing the Agent on OpenWRT ​
Click to expand/collapse
How to solve installation difficulties and issues in one step?
How to enable autostart on older OpenWRT/LEDE?
How to enable autostart on newer OpenWRT? Contributor: @艾斯德斯
  • First, download the corresponding binary from the release, unzip the zip package, and place it in /root.
  • Run chmod +x /root/nezha-agent to grant execution permission, then create /etc/init.d/nezha-service:
shell
#!/bin/sh /etc/rc.common
+
+START=99
+USE_PROCD=1
+
+start_service() {
+ procd_open_instance
+ procd_set_param command /root/nezha-agent -s Dashboard communication domain:port -p Key -d
+ procd_set_param respawn
+ procd_close_instance
+}
+
+stop_service() {
+  killall nezha-agent
+}
+
+restart() {
+ stop
+ sleep 2
+ start
+}
  • Run chmod +x /etc/init.d/nezha-service to grant execution permission.
  • Start the service: /etc/init.d/nezha-service enable && /etc/init.d/nezha-service start
Does the Agent Have a Docker Image? ​
The Agent does not currently have a Docker image.
 The design philosophy of the Agent is opposite to that of the Dashboard. While the Dashboard should minimally impact the server, the Agent needs to execute monitoring services and run commands within the server.
 Running the Agent inside a container can still perform monitoring tasks, but features like WebShell will not function properly, so no Docker image is provided.
`,31),l=[t];function h(p,o,r,k,d,c){return a(),i("div",null,l)}const u=s(n,[["render",h]]);export{F as __pageData,u as default};
diff --git a/assets/en_US_guide_agent.md.BuV95h8M.lean.js b/assets/en_US_guide_agent.md.BuV95h8M.lean.js
new file mode 100644
index 00000000..0a8d23e0
--- /dev/null
+++ b/assets/en_US_guide_agent.md.BuV95h8M.lean.js
@@ -0,0 +1 @@
+import{_ as s,c as i,o as a,a4 as e}from"./chunks/framework.BmdFiWrL.js";const F=JSON.parse('{"title":"Install Agent","description":"","frontmatter":{"outline":"deep"},"headers":[],"relativePath":"en_US/guide/agent.md","filePath":"en_US/guide/agent.md","lastUpdated":1720901424000}'),n={name:"en_US/guide/agent.md"},t=e("",31),l=[t];function h(p,o,r,k,d,c){return a(),i("div",null,l)}const u=s(n,[["render",h]]);export{F as __pageData,u as default};
diff --git a/assets/en_US_guide_agent.md.QSO76OyE.js b/assets/en_US_guide_agent.md.QSO76OyE.js
deleted file mode 100644
index 7573e2ef..00000000
--- a/assets/en_US_guide_agent.md.QSO76OyE.js
+++ /dev/null
@@ -1,144 +0,0 @@
-import{_ as s,c as i,o as a,a4 as n}from"./chunks/framework.BmdFiWrL.js";const c=JSON.parse('{"title":"Install Agent","description":"","frontmatter":{"outline":"deep"},"headers":[],"relativePath":"en_US/guide/agent.md","filePath":"en_US/guide/agent.md","lastUpdated":1720881864000}'),t={name:"en_US/guide/agent.md"},e=n(`
Install Agent ​
This document will introduce how to install the Agent on the monitored server and connect it to the Dashboard.
TIP
The repository for Agent binaries can be found at: https://github.com/nezhahq/agent/releases
One-Click Installation of the Agent ​
Nezha Monitoring supports one-click installation of the Agent on both Windows and Linux. By following the steps in this document, you can easily deploy it on your server.
Preparation ​
You need to set up a communication domain in the admin panel in advance, and this domain should not be connected to a CDN. This document uses the example communication domain “data.example.com”.
 Go to the settings page in the admin panel, fill in the communication domain in the “Non-CDN Dashboard Server Domain/IP” field, and click "Save".
One-Click Installation on Linux (Ubuntu, Debian, CentOS) ​
  1. First, add a server in the admin panel.
  2. Click the green Linux icon button next to the newly added server and copy the one-click installation command.
  3. Run the copied installation command on the monitored server, and wait for the installation to complete. Then, check if the server is online in the Dashboard home page.
One-Click Installation on Windows ​
  1. First, add a server in the admin panel.
  2. Click the green Windows icon button next to the newly added server and copy the one-click installation command.
  3. Go to the Windows server, run PowerShell, and execute the copied installation command in PowerShell.
  4. If you encounter a prompt to "change execution policy," choose Y.
  5. Wait for the installation to complete, then check if the server is online in the Dashboard home page.
WARNING
If you encounter errors when running the one-click installation command in PowerShell, try the Manual Installation of the Agent on Windows below.
Other Ways to Install the Agent ​
Installing the Agent on Linux (Ubuntu, Debian, CentOS) ​
Click to expand/collapse
  1. First, add a server in the admin panel.
  2. Run the script on the monitored server:
bash
curl -L https://raw.githubusercontent.com/naiba/nezha/master/script/install_en.sh  -o nezha.sh && chmod +x nezha.sh && sudo ./nezha.sh
  1. Select “Install monitoring Agent.”
  2. Enter the communication domain, such as "data.example.com".
  3. Enter the dashboard communication port (gRPC port), default is 5555.
  4. Enter the Agent secret, which is generated when you add a server in the admin panel and can be found on the “Servers” page in the admin panel.
  5. Wait for the installation to complete, then check if the server is online in the Dashboard home page.
Installing the Agent on Other Linux Distributions (e.g., Alpine using Openrc) ​
Click to expand/collapse
This section is contributed by unknown0054.
  1. Modify SERVER, SECRET, TLS, and execute in the shell:
shell
cat >/etc/init.d/nezha-agent<< EOF
-#!/sbin/openrc-run
-SERVER="" # Dashboard domain ip:port
-SECRET="" # SECRET
-TLS="" # Enable TLS if yes "--tls", leave empty if no
-NZ_BASE_PATH="/opt/nezha"
-NZ_AGENT_PATH="\${NZ_BASE_PATH}/agent"
-pidfile="/run/\${RC_SVCNAME}.pid"
-command="/opt/nezha/agent/nezha-agent"
-command_args="-s \${SERVER} -p \${SECRET} \${TLS}"
-command_background=true
-depend() {
-  need net
-}
-checkconfig() {
-  GITHUB_URL="github.com"
-  if [ ! -f "\${NZ_AGENT_PATH}/nezha-agent" ]; then
-    if [[ $(uname -m | grep 'x86_64') != "" ]]; then
-      os_arch="amd64"
-    elif [[ $(uname -m | grep 'i386\\|i686') != "" ]]; then
-      os_arch="386"
-    elif [[ $(uname -m | grep 'aarch64\\|armv8b\\|armv8l') != "" ]]; then
-      os_arch="arm64"
-    elif [[ $(uname -m | grep 'arm') != "" ]]; then
-      os_arch="arm"
-    elif [[ $(uname -m | grep 's390x') != "" ]]; then
-      os_arch="s390x"
-    elif [[ $(uname -m | grep 'riscv64') != "" ]]; then
-      os_arch="riscv64"
-    fi
-    local version=$(curl -m 10 -sL "https://api.github.com/repos/nezhahq/agent/releases/latest" | grep "tag_name" | head -n 1 | awk -F ":" '{print $2}' | sed 's/\\"//g;s/,//g;s/ //g')
-    if [ ! -n "$version" ]; then
-      version=$(curl -m 10 -sL "https://fastly.jsdelivr.net/gh/nezhahq/agent/" | grep "option\\.value" | awk -F "'" '{print $2}' | sed 's/nezhahq\\/agent@/v/g')
-    fi
-    if [ ! -n "$version" ]; then
-      version=$(curl -m 10 -sL "https://gcore.jsdelivr.net/gh/nezhahq/agent/" | grep "option\\.value" | awk -F "'" '{print $2}' | sed 's/nezhahq\\/agent@/v/g')
-    fi
-    if [ ! -n "$version" ]; then
-      echo -e "Failed to get the version number. Please check if the server can connect to https://api.github.com/repos/nezhahq/agent/releases/latest"
-      return 0
-    else
-      echo -e "The latest version is: \${version}"
-    fi
-    wget -t 2 -T 10 -O nezha-agent_linux_\${os_arch}.zip https://\${GITHUB_URL}/nezhahq/agent/releases/download/\${version}/nezha-agent_linux_\${os_arch}.zip >/dev/null 2>&1
-    if [[ $? != 0 ]]; then
-      echo -e "Failed to download Release. Please check if the server can connect to \${GITHUB_URL}"
-      return 0
-    fi
-    mkdir -p $NZ_AGENT_PATH
-    chmod 755 -R $NZ_AGENT_PATH
-    unzip -qo nezha-agent_linux_\${os_arch}.zip && mv nezha-agent $NZ_AGENT_PATH && rm -rf nezha-agent_linux_\${os_arch}.zip README.md
-  fi
-  if [ ! -x "\${NZ_AGENT_PATH}/nezha-agent" ]; then
-    chmod +x \${NZ_AGENT_PATH}/nezha-agent
-  fi
-}
-start_pre() {
-  if [ "\${RC_CMD}" != "restart" ]; then
-    checkconfig || return $?
-  fi
-}
-EOF
  1. Add execute permissions
shell
chmod +x /etc/init.d/nezha-agent
  1. Start Nezha-Agent
shell
rc-service nezha-agent start
  1. Add to startup
shell
rc-update add nezha-agent
Manual Installation of the Agent on Windows ​
Installing the Agent on Synology DSM ​
Click to expand/collapse
sh
# Agent path
-EXEC="/PATH/TO/nezha-agent"
-# Log path
-LOG="\${EXEC}.log"
-# Additional execution parameters, can be empty
-ARGS=""
-# Nezha server gRPC address
-SERVER="HOST_OR_IP:gRPC_PORT"
-# The secret key obtained in the previous step
-SECRET="APP_SECRET"
-# User running the service, *strongly recommended to use non-root user*
-RUN_USER="nezha"
-
-# Write to systemd service file
-cat << EOF > /usr/lib/systemd/system/nezha.service
-[Unit]
-Description=Nezha Agent Service
-After=network.target
-
-[Service]
-Type=simple
-ExecStart=/bin/nohup \${EXEC} \${ARGS} -s \${SERVER} -p \${SECRET} &>> \${LOG} &
-ExecStop=ps -fe |grep nezha-agent|awk '{print \\$2}'|xargs kill
-User=\${RUN_USER}
-
-Restart=on-abort
-
-[Install]
-WantedBy=multi-user.target
-EOF
-
-# Reload service
-systemctl daemon-reload
-# Start service
-systemctl start nezha
-# Enable service startup
-systemctl enable nezha
‼️ Modify the corresponding information before running the above commands with the root account to complete the installation.
Installing the Agent on macOS ​
Click to expand/collapse
This section is adapted from Mitsea Blog with the author's permission
WARNING
If you are prompted "macOS cannot verify this app" during installation, manually allow the program to run in System Settings.
  1. First, add a server in the admin panel.
  2. Go to the Release page to download the Agent binary file. Choose to download the darwin amd64 or arm64 Agent according to your CPU architecture. Download the amd64 version for Intel CPU, or the arm64 version for Apple Silicon. After downloading, unzip the Agent binary file, such as unzipping it to the Downloads folder.
  3. Create a file named nezha_agent.plist and save it with the following content:
xml
<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
-<plist version="1.0">
-<dict>
- <key>KeepAlive</key>
- <true/>
- <key>Label</key>
- <string>nezha_agent</string>
- <key>Program</key>
- <string>Modify the path to the Agent binary file here, such as: /Users/123/Downloads/nezha-agent</string>
- <key>ProgramArguments</key>
- <array>
-  <string>Modify the path to the Agent binary file here, same as above</string>
-  <string>--password</string>
-  <string>The communication secret, such as: 529664783eeb23cc25</string>
-  <string>--server</string>
-  <string>The communication URL and gRPC port, such as: data.example.com:5555</string>
- </array>
- <key>RunAtLoad</key>
- <true/>
-</dict>
-</plist>
  1. Load the plist file into launchd using the following command in Terminal, make sure to replace the file path:
shell
launchctl load /Users/123/Desktop/nezha_agent.plist
  1. Start the process:
shell
launchctl start nezha_agent
  1. Check if the process is running:
shell
launchctl list | grep nezha_agent
  1. Stop the process and remove it:
shell
launchctl stop nezha_agent
shell
launchctl remove nezha_agent
Installing the Agent on macOS Using Homebrew ​
Click to expand/collapse
This section is adapted from 🐿️松鼠收集🌰 with the author's permission
WARNING
Please be sure to add environment variables before installing nezha-agent through Homebrew! Homebrew creates the service-required plist file during software installation, and if you add the environment variables after installation, it will fail to start due to missing parameters.
  1. Add environment variables:
shell
echo 'export HOMEBREW_NEZHA_AGENT_PASSWORD="Communication key, obtained from the service page"' >> ~/.zshrc
-echo 'export HOMEBREW_NEZHA_AGENT_SERVER="Your server and port, format your.domain:5555 "' >> ~/.zshrc
-source ~/.zshrc
  1. Install Nezha Agent:
DANGER
Note that this Homebrew repository is maintained by a third party and is unrelated to Nezha Monitoring. The Nezha project team does not endorse this repository's usability, security, etc. Please evaluate the risks yourself before using!
Since it has not yet been submitted to the Homebrew Core official library, it is temporarily placed in the third-party Homebrew repository maintained by the author of the blog:
shell
brew install brewforge/chinese/nezha-agent
  1. Start Nezha Agent service through Homebrew:
shell
brew services start nezha-agent
  1. Check the service status:
shell
brew services info nezha-agent
  1. Stop the service:
shell
brew services stop nezha-agent
  1. Uninstall Nezha Agent:
shell
brew rm nezha-agent
  1. If there is an error, first check the environment variables:
shell
echo $HOMEBREW_NEZHA_AGENT_PASSWORD
-echo $HOMEBREW_NEZHA_AGENT_SERVER
  1. If the environment variables are configured correctly, try reinstalling:
shell
brew services stop nezha-agent
-brew reinstall nezha-agent
-brew services start nezha-agent
  1. If the issue persists, submit a issue to the third-party Homebrew repository.
Installing the Agent on OpenWRT ​
Click to expand/collapse
How to solve installation difficulties and issues in one step?
How to enable autostart on older OpenWRT/LEDE?
How to enable autostart on newer OpenWRT? Contributor: @艾斯德斯
  • First, download the corresponding binary from the release, unzip the zip package, and place it in /root.
  • Run chmod +x /root/nezha-agent to grant execution permission, then create /etc/init.d/nezha-service:
shell
#!/bin/sh /etc/rc.common
-
-START=99
-USE_PROCD=1
-
-start_service() {
- procd_open_instance
- procd_set_param command /root/nezha-agent -s Dashboard communication domain:port -p Key -d
- procd_set_param respawn
- procd_close_instance
-}
-
-stop_service() {
-  killall nezha-agent
-}
-
-restart() {
- stop
- sleep 2
- start
-}
  • Run chmod +x /etc/init.d/nezha-service to grant execution permission.
  • Start the service: /etc/init.d/nezha-service enable && /etc/init.d/nezha-service start
Does the Agent Have a Docker Image? ​
The Agent does not currently have a Docker image.
 The design philosophy of the Agent is opposite to that of the Dashboard. While the Dashboard should minimally impact the server, the Agent needs to execute monitoring services and run commands within the server.
 Running the Agent inside a container can still perform monitoring tasks, but features like WebShell will not function properly, so no Docker image is provided.
`,29),l=[e];function h(p,k,r,o,d,g){return a(),i("div",null,l)}const E=s(t,[["render",h]]);export{c as __pageData,E as default};
diff --git a/assets/en_US_guide_agent.md.QSO76OyE.lean.js b/assets/en_US_guide_agent.md.QSO76OyE.lean.js
deleted file mode 100644
index 8ea4c0ca..00000000
--- a/assets/en_US_guide_agent.md.QSO76OyE.lean.js
+++ /dev/null
@@ -1 +0,0 @@
-import{_ as s,c as i,o as a,a4 as n}from"./chunks/framework.BmdFiWrL.js";const c=JSON.parse('{"title":"Install Agent","description":"","frontmatter":{"outline":"deep"},"headers":[],"relativePath":"en_US/guide/agent.md","filePath":"en_US/guide/agent.md","lastUpdated":1720881864000}'),t={name:"en_US/guide/agent.md"},e=n("",29),l=[e];function h(p,k,r,o,d,g){return a(),i("div",null,l)}const E=s(t,[["render",h]]);export{c as __pageData,E as default};
diff --git a/assets/en_US_guide_agentq.md.CQxYnGfY.js b/assets/en_US_guide_agentq.md.BCdgnYHv.js
similarity index 97%
rename from assets/en_US_guide_agentq.md.CQxYnGfY.js
rename to assets/en_US_guide_agentq.md.BCdgnYHv.js
index 4ee8ec49..ac046021 100644
--- a/assets/en_US_guide_agentq.md.CQxYnGfY.js
+++ b/assets/en_US_guide_agentq.md.BCdgnYHv.js
@@ -1 +1 @@
-import{_ as e,c as t,o as a,a4 as n}from"./chunks/framework.BmdFiWrL.js";const f=JSON.parse('{"title":"Frequently Asked Questions about the Agent","description":"","frontmatter":{"outline":"deep"},"headers":[],"relativePath":"en_US/guide/agentq.md","filePath":"en_US/guide/agentq.md","lastUpdated":1720881864000}'),i={name:"en_US/guide/agentq.md"},s=n('
Frequently Asked Questions about the Agent ​
The IP Displayed in the Admin Panel is Different from the Actual Agent IP? ​
Please refer to Dashboard Related - Why is the IP Displayed in the Admin Panel Different from the Actual Agent IP?. This will not be repeated here.
Errors During One-Click Script Installation ​
curl: Failed to connect to raw.githubusercontent.com...... ​
This mostly occurs on servers in mainland China. Currently, the one-click script fetches the installation script directly from Github. You may try several times, or manually install the Agent. Additionally, you can find third-party Github acceleration services or mirrors and set them in the one-click installation script.
sudo: command not found ​
Please manually install sudo first, for example, in Ubuntu:
shell
apt install sudo
',9),o=[s];function r(l,d,h,c,u,p){return a(),t("div",null,o)}const g=e(i,[["render",r]]);export{f as __pageData,g as default};
+import{_ as e,c as t,o as a,a4 as n}from"./chunks/framework.BmdFiWrL.js";const f=JSON.parse('{"title":"Frequently Asked Questions about the Agent","description":"","frontmatter":{"outline":"deep"},"headers":[],"relativePath":"en_US/guide/agentq.md","filePath":"en_US/guide/agentq.md","lastUpdated":1720901424000}'),i={name:"en_US/guide/agentq.md"},s=n('
Frequently Asked Questions about the Agent ​
The IP Displayed in the Admin Panel is Different from the Actual Agent IP? ​
Please refer to Dashboard Related - Why is the IP Displayed in the Admin Panel Different from the Actual Agent IP?. This will not be repeated here.
Errors During One-Click Script Installation ​
curl: Failed to connect to raw.githubusercontent.com...... ​
This mostly occurs on servers in mainland China. Currently, the one-click script fetches the installation script directly from Github. You may try several times, or manually install the Agent. Additionally, you can find third-party Github acceleration services or mirrors and set them in the one-click installation script.
sudo: command not found ​
Please manually install sudo first, for example, in Ubuntu:
shell
apt install sudo
',9),o=[s];function r(l,d,h,c,u,p){return a(),t("div",null,o)}const g=e(i,[["render",r]]);export{f as __pageData,g as default};
diff --git a/assets/en_US_guide_agentq.md.CQxYnGfY.lean.js b/assets/en_US_guide_agentq.md.BCdgnYHv.lean.js
similarity index 86%
rename from assets/en_US_guide_agentq.md.CQxYnGfY.lean.js
rename to assets/en_US_guide_agentq.md.BCdgnYHv.lean.js
index 2cf2a885..1c0bd255 100644
--- a/assets/en_US_guide_agentq.md.CQxYnGfY.lean.js
+++ b/assets/en_US_guide_agentq.md.BCdgnYHv.lean.js
@@ -1 +1 @@
-import{_ as e,c as t,o as a,a4 as n}from"./chunks/framework.BmdFiWrL.js";const f=JSON.parse('{"title":"Frequently Asked Questions about the Agent","description":"","frontmatter":{"outline":"deep"},"headers":[],"relativePath":"en_US/guide/agentq.md","filePath":"en_US/guide/agentq.md","lastUpdated":1720881864000}'),i={name:"en_US/guide/agentq.md"},s=n("",9),o=[s];function r(l,d,h,c,u,p){return a(),t("div",null,o)}const g=e(i,[["render",r]]);export{f as __pageData,g as default};
+import{_ as e,c as t,o as a,a4 as n}from"./chunks/framework.BmdFiWrL.js";const f=JSON.parse('{"title":"Frequently Asked Questions about the Agent","description":"","frontmatter":{"outline":"deep"},"headers":[],"relativePath":"en_US/guide/agentq.md","filePath":"en_US/guide/agentq.md","lastUpdated":1720901424000}'),i={name:"en_US/guide/agentq.md"},s=n("",9),o=[s];function r(l,d,h,c,u,p){return a(),t("div",null,o)}const g=e(i,[["render",r]]);export{f as __pageData,g as default};
diff --git a/assets/en_US_guide_api.md.Bk6_Wmwt.js b/assets/en_US_guide_api.md.C56GHcq2.js
similarity index 99%
rename from assets/en_US_guide_api.md.Bk6_Wmwt.js
rename to assets/en_US_guide_api.md.C56GHcq2.js
index 3084f8e4..8c37c52c 100644
--- a/assets/en_US_guide_api.md.Bk6_Wmwt.js
+++ b/assets/en_US_guide_api.md.C56GHcq2.js
@@ -1,4 +1,4 @@
-import{_ as s,c as i,o as a,a4 as n}from"./chunks/framework.BmdFiWrL.js";const F=JSON.parse('{"title":"API Interface","description":"","frontmatter":{"outline":"deep"},"headers":[],"relativePath":"en_US/guide/api.md","filePath":"en_US/guide/api.md","lastUpdated":1720881864000}'),t={name:"en_US/guide/api.md"},h=n(`
API Interface ​
Nezha Monitoring supports querying the status information of Agents using the API interface
Creating a Token ​
Nezha Monitoring's API interface allows for Token authentication and Cookies authentication. To create a new Token, go to the admin panel, click on the avatar in the top right corner, select "API Token," and enter the Token management page. Click "Add Token", add a custom note, and click "Add".
To delete a Token, select the corresponding Token and click the delete icon on the right.
WARNING
Tokens are the authentication credentials for the API interface. They are critical to the security of your Dashboard's information, so do not share your Token with others.
Authentication Method ​
Ensure the request header contains Authorization: Token for authentication.
Token authentication method:
Request Headers:
+import{_ as s,c as i,o as a,a4 as n}from"./chunks/framework.BmdFiWrL.js";const F=JSON.parse('{"title":"API Interface","description":"","frontmatter":{"outline":"deep"},"headers":[],"relativePath":"en_US/guide/api.md","filePath":"en_US/guide/api.md","lastUpdated":1720901424000}'),t={name:"en_US/guide/api.md"},h=n(`
API Interface ​
Nezha Monitoring supports querying the status information of Agents using the API interface
Creating a Token ​
Nezha Monitoring's API interface allows for Token authentication and Cookies authentication. To create a new Token, go to the admin panel, click on the avatar in the top right corner, select "API Token," and enter the Token management page. Click "Add Token", add a custom note, and click "Add".
To delete a Token, select the corresponding Token and click the delete icon on the right.
WARNING
Tokens are the authentication credentials for the API interface. They are critical to the security of your Dashboard's information, so do not share your Token with others.
Authentication Method ​
Ensure the request header contains Authorization: Token for authentication.
Token authentication method:
Request Headers:
 Authorization: Token
Usage Instructions ​
WARNING
Negative timestamps in the following examples represent 0000-00-00. This currently indicates that the Agent has never reported since the Dashboard went online, but it is not recommended to use the positive or negative value to determine the status.
TIP
The request method is GET, and the response format is JSON.
Get Server List ​
Request:
GET /api/v1/server/list?tag=
Parameters:
  • tag (optional): ServerTag is the server group. Provide this parameter to query only servers in that group.
Example response:
json
{
     "code": 0,
     "message": "success",
diff --git a/assets/en_US_guide_api.md.Bk6_Wmwt.lean.js b/assets/en_US_guide_api.md.C56GHcq2.lean.js
similarity index 85%
rename from assets/en_US_guide_api.md.Bk6_Wmwt.lean.js
rename to assets/en_US_guide_api.md.C56GHcq2.lean.js
index e0ce3a52..8a748166 100644
--- a/assets/en_US_guide_api.md.Bk6_Wmwt.lean.js
+++ b/assets/en_US_guide_api.md.C56GHcq2.lean.js
@@ -1 +1 @@
-import{_ as s,c as i,o as a,a4 as n}from"./chunks/framework.BmdFiWrL.js";const F=JSON.parse('{"title":"API Interface","description":"","frontmatter":{"outline":"deep"},"headers":[],"relativePath":"en_US/guide/api.md","filePath":"en_US/guide/api.md","lastUpdated":1720881864000}'),t={name:"en_US/guide/api.md"},h=n("",33),k=[h];function p(l,e,E,r,d,o){return a(),i("div",null,k)}const y=s(t,[["render",p]]);export{F as __pageData,y as default};
+import{_ as s,c as i,o as a,a4 as n}from"./chunks/framework.BmdFiWrL.js";const F=JSON.parse('{"title":"API Interface","description":"","frontmatter":{"outline":"deep"},"headers":[],"relativePath":"en_US/guide/api.md","filePath":"en_US/guide/api.md","lastUpdated":1720901424000}'),t={name:"en_US/guide/api.md"},h=n("",33),k=[h];function p(l,e,E,r,d,o){return a(),i("div",null,k)}const y=s(t,[["render",p]]);export{F as __pageData,y as default};
diff --git a/assets/en_US_guide_dashboard.md.DRdDzW_7.js b/assets/en_US_guide_dashboard.md.DeHZrujK.js
similarity index 99%
rename from assets/en_US_guide_dashboard.md.DRdDzW_7.js
rename to assets/en_US_guide_dashboard.md.DeHZrujK.js
index 0e9ee8d5..e50ba2c3 100644
--- a/assets/en_US_guide_dashboard.md.DRdDzW_7.js
+++ b/assets/en_US_guide_dashboard.md.DeHZrujK.js
@@ -1,4 +1,4 @@
-import{_ as a,c as e,o as s,a4 as t}from"./chunks/framework.BmdFiWrL.js";const k=JSON.parse('{"title":"Install Dashboard","description":"","frontmatter":{"outline":"deep"},"headers":[],"relativePath":"en_US/guide/dashboard.md","filePath":"en_US/guide/dashboard.md","lastUpdated":1720881864000}'),i={name:"en_US/guide/dashboard.md"},n=t(`
Install Dashboard ​
Preparation ​
To set up Nezha Monitoring, you need:
  1. A server with public internet access, with firewall and security policies allowing traffic on ports 8008 and 5555. These ports are necessary for accessing and receiving data. A server with a single core and 512MB of RAM is sufficient for most use cases.
  2. A domain with an A record set to point to your Dashboard server IP.
TIP
If you want to use a CDN, prepare two domains: one configured with CDN for public access (CDN must support WebSocket protocol), and another domain not using CDN for communication between the Agent and Dashboard.
This document uses "dashboard.example.com" and "data.example.com" as example domains.
  1. A Github account (or Gitlab, Gitee).
This document uses the aaPanel for reverse proxying the Dashboard as an example. As future versions change, some features may change their entry points. This document is for reference only.
WARNING
This project does not depend on the aaPanel; you can choose any server panel you prefer or manually install Nginx or Caddy to configure SSL and reverse proxy.
 If you do not need to use ports 80 and 443 to access the Dashboard, you can directly use the installation script to install and run Nezha Monitoring without installing Nginx.
Obtaining Github Client ID and Secret ​
Nezha Monitoring uses Github, Gitlab, or Gitee as admin accounts.
  1. First, create an OAuth application. For Github, log in to Github, open Github OAuth Apps, and select "OAuth Apps" -> "New OAuth App".
    Application name - Fill in as you like.
    Homepage URL - Fill in with the domain for accessing the dashboard, such as "http://dashboard.example.com" (your domain).
    Authorization callback URL - Fill in with the callback address, such as "http://dashboard.example.com/oauth2/callback" (don't forget /oauth2/callback).
  2. Click “Register application”.
  3. Save the Client ID on the page, then click “Generate a new client secret” to create a new Client Secret, which will be displayed only once, please keep it safe.
Using Cloudflare Access as an OAuth2 Provider ​
If you encounter issues using GitHub, GitLab, or Gitee for admin account logins, consider switching to Cloudflare Access as your OAuth2 provider for authentication.
Setting Up a New SaaS-OIDC Application ​
WARNING
The following steps are for users who have already started using Zero Trust. If you have not previously used Cloudflare Zero Trust, we strongly recommend that you first read the Guide on Using Cloudflare Access as an OAuth2 Provider to understand the configuration examples and setup process.
  1. Go to Zero Trust Dashboard and log in with your Cloudflare account.
  2. My Team -> Users -> <specific user> -> Get User ID and save it.
  3. Access -> Application -> Add an Application.
  4. Choose SaaS, enter a custom application name in Application (e.g., nezha), select OIDC, and click Add application.
  5. Select Scopes: openid, email, profile, groups.
  6. Fill in your callback address in Redirect URLs, such as https://dashboard.example.com/oauth2/callback.
  7. Save the Client ID, Client Secret, and Issuer address (protocol and domain part), e.g., https://xxxxx.cloudflareaccess.com.
If using this method, after installing the Dashboard, modify the configuration file /opt/nezha/dashboard/data/config.yaml, and change the Endpoint configuration to the Issuer address saved earlier, e.g., https://xxxxx.cloudflareaccess.com, and restart the Dashboard.
Installing the Dashboard on the Server ​
Run the installation script on the dashboard server:
bash
curl -L https://raw.githubusercontent.com/naiba/nezha/master/script/install_en.sh  -o nezha.sh && chmod +x nezha.sh && sudo ./nezha.sh
After Docker installation completes, enter the following values:
  • OAuth provider - choose one from github, cloudflare, gitlab, gitee.
  • Client ID - the previously saved Client ID.
  • Client Secret - the previously saved Client Secret.
  • Username - the username/User ID from the OAuth provider.
  • Site title - custom site title.
  • Access port - public access port, customizable, default is 8008.
  • Agent communication port - port for Agent and Dashboard communication, default is 5555.
After inputting the values, wait for the image to be pulled.
 When the installation completes, you can access the dashboard by visiting your domain and port number, such as “http://dashboard.example.com:8008”.
In the future, if you need to run the script again, run:
bash
./nezha.sh
to open the management script.
Configuring Reverse Proxy ​
Create a new site in the aaPanel, with the domain filled in as the public access domain, such as “http://dashboard.example.com”. Then click “Settings” to enter the site settings options, select “Reverse Proxy” - “New Reverse Proxy”.
Customize a proxy name and fill in http://127.0.0.1 in the "Target URL" below, then click “Save”.
Open the “Configuration File” on the right side of the newly created reverse proxy and replace the configuration file with the following content:
nginx
#PROXY-START/
+import{_ as a,c as e,o as s,a4 as t}from"./chunks/framework.BmdFiWrL.js";const k=JSON.parse('{"title":"Install Dashboard","description":"","frontmatter":{"outline":"deep"},"headers":[],"relativePath":"en_US/guide/dashboard.md","filePath":"en_US/guide/dashboard.md","lastUpdated":1720901424000}'),i={name:"en_US/guide/dashboard.md"},n=t(`
Install Dashboard ​
Preparation ​
To set up Nezha Monitoring, you need:
  1. A server with public internet access, with firewall and security policies allowing traffic on ports 8008 and 5555. These ports are necessary for accessing and receiving data. A server with a single core and 512MB of RAM is sufficient for most use cases.
  2. A domain with an A record set to point to your Dashboard server IP.
TIP
If you want to use a CDN, prepare two domains: one configured with CDN for public access (CDN must support WebSocket protocol), and another domain not using CDN for communication between the Agent and Dashboard.
This document uses "dashboard.example.com" and "data.example.com" as example domains.
  1. A Github account (or Gitlab, Gitee).
This document uses the aaPanel for reverse proxying the Dashboard as an example. As future versions change, some features may change their entry points. This document is for reference only.
WARNING
This project does not depend on the aaPanel; you can choose any server panel you prefer or manually install Nginx or Caddy to configure SSL and reverse proxy.
 If you do not need to use ports 80 and 443 to access the Dashboard, you can directly use the installation script to install and run Nezha Monitoring without installing Nginx.
Obtaining Github Client ID and Secret ​
Nezha Monitoring uses Github, Gitlab, or Gitee as admin accounts.
  1. First, create an OAuth application. For Github, log in to Github, open Github OAuth Apps, and select "OAuth Apps" -> "New OAuth App".
    Application name - Fill in as you like.
    Homepage URL - Fill in with the domain for accessing the dashboard, such as "http://dashboard.example.com" (your domain).
    Authorization callback URL - Fill in with the callback address, such as "http://dashboard.example.com/oauth2/callback" (don't forget /oauth2/callback).
  2. Click “Register application”.
  3. Save the Client ID on the page, then click “Generate a new client secret” to create a new Client Secret, which will be displayed only once, please keep it safe.
Using Cloudflare Access as an OAuth2 Provider ​
If you encounter issues using GitHub, GitLab, or Gitee for admin account logins, consider switching to Cloudflare Access as your OAuth2 provider for authentication.
Setting Up a New SaaS-OIDC Application ​
WARNING
The following steps are for users who have already started using Zero Trust. If you have not previously used Cloudflare Zero Trust, we strongly recommend that you first read the Guide on Using Cloudflare Access as an OAuth2 Provider to understand the configuration examples and setup process.
  1. Go to Zero Trust Dashboard and log in with your Cloudflare account.
  2. My Team -> Users -> <specific user> -> Get User ID and save it.
  3. Access -> Application -> Add an Application.
  4. Choose SaaS, enter a custom application name in Application (e.g., nezha), select OIDC, and click Add application.
  5. Select Scopes: openid, email, profile, groups.
  6. Fill in your callback address in Redirect URLs, such as https://dashboard.example.com/oauth2/callback.
  7. Save the Client ID, Client Secret, and Issuer address (protocol and domain part), e.g., https://xxxxx.cloudflareaccess.com.
If using this method, after installing the Dashboard, modify the configuration file /opt/nezha/dashboard/data/config.yaml, and change the Endpoint configuration to the Issuer address saved earlier, e.g., https://xxxxx.cloudflareaccess.com, and restart the Dashboard.
Installing the Dashboard on the Server ​
Run the installation script on the dashboard server:
bash
curl -L https://raw.githubusercontent.com/naiba/nezha/master/script/install_en.sh  -o nezha.sh && chmod +x nezha.sh && sudo ./nezha.sh
After Docker installation completes, enter the following values:
  • OAuth provider - choose one from github, cloudflare, gitlab, gitee.
  • Client ID - the previously saved Client ID.
  • Client Secret - the previously saved Client Secret.
  • Username - the username/User ID from the OAuth provider.
  • Site title - custom site title.
  • Access port - public access port, customizable, default is 8008.
  • Agent communication port - port for Agent and Dashboard communication, default is 5555.
After inputting the values, wait for the image to be pulled.
 When the installation completes, you can access the dashboard by visiting your domain and port number, such as “http://dashboard.example.com:8008”.
In the future, if you need to run the script again, run:
bash
./nezha.sh
to open the management script.
Configuring Reverse Proxy ​
Create a new site in the aaPanel, with the domain filled in as the public access domain, such as “http://dashboard.example.com”. Then click “Settings” to enter the site settings options, select “Reverse Proxy” - “New Reverse Proxy”.
Customize a proxy name and fill in http://127.0.0.1 in the "Target URL" below, then click “Save”.
Open the “Configuration File” on the right side of the newly created reverse proxy and replace the configuration file with the following content:
nginx
#PROXY-START/
 location / {
     proxy_pass http://127.0.0.1:8008;
     proxy_set_header Host $http_host;
diff --git a/assets/en_US_guide_dashboard.md.DRdDzW_7.lean.js b/assets/en_US_guide_dashboard.md.DeHZrujK.lean.js
similarity index 86%
rename from assets/en_US_guide_dashboard.md.DRdDzW_7.lean.js
rename to assets/en_US_guide_dashboard.md.DeHZrujK.lean.js
index 34f75746..028c26bc 100644
--- a/assets/en_US_guide_dashboard.md.DRdDzW_7.lean.js
+++ b/assets/en_US_guide_dashboard.md.DeHZrujK.lean.js
@@ -1 +1 @@
-import{_ as a,c as e,o as s,a4 as t}from"./chunks/framework.BmdFiWrL.js";const k=JSON.parse('{"title":"Install Dashboard","description":"","frontmatter":{"outline":"deep"},"headers":[],"relativePath":"en_US/guide/dashboard.md","filePath":"en_US/guide/dashboard.md","lastUpdated":1720881864000}'),i={name:"en_US/guide/dashboard.md"},n=t("",39),o=[n];function r(l,h,d,p,c,u){return s(),e("div",null,o)}const b=a(i,[["render",r]]);export{k as __pageData,b as default};
+import{_ as a,c as e,o as s,a4 as t}from"./chunks/framework.BmdFiWrL.js";const k=JSON.parse('{"title":"Install Dashboard","description":"","frontmatter":{"outline":"deep"},"headers":[],"relativePath":"en_US/guide/dashboard.md","filePath":"en_US/guide/dashboard.md","lastUpdated":1720901424000}'),i={name:"en_US/guide/dashboard.md"},n=t("",39),o=[n];function r(l,h,d,p,c,u){return s(),e("div",null,o)}const b=a(i,[["render",r]]);export{k as __pageData,b as default};
diff --git a/assets/en_US_guide_dashboardq.md.B4DEvbIt.js b/assets/en_US_guide_dashboardq.md.Ch1jJAla.js
similarity index 99%
rename from assets/en_US_guide_dashboardq.md.B4DEvbIt.js
rename to assets/en_US_guide_dashboardq.md.Ch1jJAla.js
index ca534cef..a61bc19c 100644
--- a/assets/en_US_guide_dashboardq.md.B4DEvbIt.js
+++ b/assets/en_US_guide_dashboardq.md.Ch1jJAla.js
@@ -1,4 +1,4 @@
-import{_ as a,c as e,o as t,a4 as i}from"./chunks/framework.BmdFiWrL.js";const g=JSON.parse('{"title":"Frequently Asked Questions about the Dashboard","description":"","frontmatter":{"outline":"deep"},"headers":[],"relativePath":"en_US/guide/dashboardq.md","filePath":"en_US/guide/dashboardq.md","lastUpdated":1720881864000}'),s={name:"en_US/guide/dashboardq.md"},o=i(`
Frequently Asked Questions about the Dashboard ​
Why is the IP Displayed in the Admin Panel Different from the Actual Agent IP? ​
First, let's explain how the IP displayed in the Admin panel is obtained: The Agent periodically requests IP-API to get IP information and reports it to the Dashboard. The currently used IP-API can be viewed here: myip.go.
 If you find that the IP displayed in the Admin panel is different from the IP provided by your service provider, it is most likely that the service provider has given you an entry IP, but the Agent is testing your exit IP. This issue can also occur with multi-line servers and IPLC private lines.
TIP
For example, a common scenario is that the service provider gives you a high-defense server. To meet both high defense and low network interruption rate goals, the IP provided may be a mapped high-defense IP rather than your server's real exit IP.
You can also test the exit IP on the Agent server by running the following commands:
shell
curl https://ipapi.co/ip/
+import{_ as a,c as e,o as t,a4 as i}from"./chunks/framework.BmdFiWrL.js";const g=JSON.parse('{"title":"Frequently Asked Questions about the Dashboard","description":"","frontmatter":{"outline":"deep"},"headers":[],"relativePath":"en_US/guide/dashboardq.md","filePath":"en_US/guide/dashboardq.md","lastUpdated":1720901424000}'),s={name:"en_US/guide/dashboardq.md"},o=i(`
Frequently Asked Questions about the Dashboard ​
Why is the IP Displayed in the Admin Panel Different from the Actual Agent IP? ​
First, let's explain how the IP displayed in the Admin panel is obtained: The Agent periodically requests IP-API to get IP information and reports it to the Dashboard. The currently used IP-API can be viewed here: myip.go.
 If you find that the IP displayed in the Admin panel is different from the IP provided by your service provider, it is most likely that the service provider has given you an entry IP, but the Agent is testing your exit IP. This issue can also occur with multi-line servers and IPLC private lines.
TIP
For example, a common scenario is that the service provider gives you a high-defense server. To meet both high defense and low network interruption rate goals, the IP provided may be a mapped high-defense IP rather than your server's real exit IP.
You can also test the exit IP on the Agent server by running the following commands:
shell
curl https://ipapi.co/ip/
 curl ip.sb
 curl ip-api.com
Forgot or Deleted Viewing Password ​
Please view or edit the /opt/nezha/dashboard/data/config.yaml file.
 The password is located under the site-viewpassword item.
Dashboard Installation/Restart/Update Failure: iptables ...... ​
First, try restarting Docker before proceeding:
shell
systemctl status docker
 systemctl restart docker
diff --git a/assets/en_US_guide_dashboardq.md.B4DEvbIt.lean.js b/assets/en_US_guide_dashboardq.md.Ch1jJAla.lean.js
similarity index 87%
rename from assets/en_US_guide_dashboardq.md.B4DEvbIt.lean.js
rename to assets/en_US_guide_dashboardq.md.Ch1jJAla.lean.js
index 8e7ec431..e9e8a71a 100644
--- a/assets/en_US_guide_dashboardq.md.B4DEvbIt.lean.js
+++ b/assets/en_US_guide_dashboardq.md.Ch1jJAla.lean.js
@@ -1 +1 @@
-import{_ as a,c as e,o as t,a4 as i}from"./chunks/framework.BmdFiWrL.js";const g=JSON.parse('{"title":"Frequently Asked Questions about the Dashboard","description":"","frontmatter":{"outline":"deep"},"headers":[],"relativePath":"en_US/guide/dashboardq.md","filePath":"en_US/guide/dashboardq.md","lastUpdated":1720881864000}'),s={name:"en_US/guide/dashboardq.md"},o=i("",31),n=[o];function r(d,h,l,c,p,u){return t(),e("div",null,n)}const f=a(s,[["render",r]]);export{g as __pageData,f as default};
+import{_ as a,c as e,o as t,a4 as i}from"./chunks/framework.BmdFiWrL.js";const g=JSON.parse('{"title":"Frequently Asked Questions about the Dashboard","description":"","frontmatter":{"outline":"deep"},"headers":[],"relativePath":"en_US/guide/dashboardq.md","filePath":"en_US/guide/dashboardq.md","lastUpdated":1720901424000}'),s={name:"en_US/guide/dashboardq.md"},o=i("",31),n=[o];function r(d,h,l,c,p,u){return t(),e("div",null,n)}const f=a(s,[["render",r]]);export{g as __pageData,f as default};
diff --git a/assets/en_US_guide_loginq.md.Dw2Asnbl.js b/assets/en_US_guide_loginq.md.CFelVFsR.js
similarity index 99%
rename from assets/en_US_guide_loginq.md.Dw2Asnbl.js
rename to assets/en_US_guide_loginq.md.CFelVFsR.js
index d803e18e..33cadeed 100644
--- a/assets/en_US_guide_loginq.md.Dw2Asnbl.js
+++ b/assets/en_US_guide_loginq.md.CFelVFsR.js
@@ -1 +1 @@
-import{_ as e,c as a,o,a4 as t}from"./chunks/framework.BmdFiWrL.js";const p=JSON.parse('{"title":"FAQ about logging into the Dashboard","description":"","frontmatter":{"outline":"deep"},"headers":[],"relativePath":"en_US/guide/loginq.md","filePath":"en_US/guide/loginq.md","lastUpdated":1720881864000}'),i={name:"en_US/guide/loginq.md"},r=t('
FAQ about logging into the Dashboard ​
Stuck Page/Connection Refused/Long Response Time After Login Callback ​
These issues can manifest in various ways, but ultimately the browser cannot display correctly after login.
  1. Your server cannot connect to Github/Gitee, which is most common when configuring Github on servers in mainland China. You may try several times or switch to Cloudflare Access.
  2. You have configured the callback address incorrectly. Ensure that your callback address is correct and that both the port and protocol are accurate!
  3. An unknown error occurred on the Dashboard. You can use a script to check the logs.
TIP
What is a protocol? In the browser, the string that ends your domain with :// is the protocol, usually http or https. Since there may be multiple protocol+domain+port combinations available for accessing the Dashboard in a normal deployment, make sure to choose the most appropriate one as the callback.
How to Check if My Callback Address is Wrong? ​
Ensure that the protocol+domain+port displayed in the browser before login and after the callback are consistent.
 Ensure that your path is /oauth2/callback, all in lowercase.
Errors After Logging into the Admin Panel ​
  1. Clear cookies and log in again, or try a different browser.
  2. Check the callback address to ensure it is correct and that both the port and protocol are accurate! The address initiating the request must be in the same domain as the callback address, with the port, protocol, and domain (or IP) all matching.
lookup xxx ​
The container DNS resolution failed, usually due to modified iptables configurations.
 It is recommended to restart Docker first, sudo systemctl restart docker, then restart the Dashboard using the script.
 If the lookup error persists, check if there are other tools controlling iptables, such as firewall.
 This issue might also be related to the kernel, so try switching to the official kernel.
Invalid authorization method, or the login callback address is invalid, expired, or has been revoked ​
This issue appears only when using Gitee login, and the reason is unclear. Switching to GitHub is recommended.
oauth2: server response missing access_token ​
This could be caused by various factors, most likely a network issue. Check your network and try again.
 If unresolved, switching to Github or another method is recommended.
The user is not an admin of this site and cannot log in ​
You logged in with the wrong account or configured the wrong username. Note that the username is not an email, and you can use a script to modify it.
 For Cloudflare Access users, note that your username is not an email but a User ID.
dial tcp xxx:443 i/o timeout ​
This is a network issue. Try restarting Docker first, sudo systemctl restart docker, then restart the Dashboard using the script.
 If you are configuring Github login on a server in mainland China, switching to Cloudflare Access is recommended to avoid network interference.
net/http: TLS handshake timeout ​
Same as above.
Unable to receive email verification codes using Cloudflare Access as an OAuth2 Provider ​
  • Ensure that the email verification policy has been correctly configured in Policies.
  • Verify that the email address you provided is correct. Note that email addresses not on the policy whitelist will not receive verification codes.
',24),n=[r];function s(l,c,h,d,u,g){return o(),a("div",null,n)}const b=e(i,[["render",s]]);export{p as __pageData,b as default};
+import{_ as e,c as a,o,a4 as t}from"./chunks/framework.BmdFiWrL.js";const p=JSON.parse('{"title":"FAQ about logging into the Dashboard","description":"","frontmatter":{"outline":"deep"},"headers":[],"relativePath":"en_US/guide/loginq.md","filePath":"en_US/guide/loginq.md","lastUpdated":1720901424000}'),i={name:"en_US/guide/loginq.md"},r=t('
FAQ about logging into the Dashboard ​
Stuck Page/Connection Refused/Long Response Time After Login Callback ​
These issues can manifest in various ways, but ultimately the browser cannot display correctly after login.
  1. Your server cannot connect to Github/Gitee, which is most common when configuring Github on servers in mainland China. You may try several times or switch to Cloudflare Access.
  2. You have configured the callback address incorrectly. Ensure that your callback address is correct and that both the port and protocol are accurate!
  3. An unknown error occurred on the Dashboard. You can use a script to check the logs.
TIP
What is a protocol? In the browser, the string that ends your domain with :// is the protocol, usually http or https. Since there may be multiple protocol+domain+port combinations available for accessing the Dashboard in a normal deployment, make sure to choose the most appropriate one as the callback.
How to Check if My Callback Address is Wrong? ​
Ensure that the protocol+domain+port displayed in the browser before login and after the callback are consistent.
 Ensure that your path is /oauth2/callback, all in lowercase.
Errors After Logging into the Admin Panel ​
  1. Clear cookies and log in again, or try a different browser.
  2. Check the callback address to ensure it is correct and that both the port and protocol are accurate! The address initiating the request must be in the same domain as the callback address, with the port, protocol, and domain (or IP) all matching.
lookup xxx ​
The container DNS resolution failed, usually due to modified iptables configurations.
 It is recommended to restart Docker first, sudo systemctl restart docker, then restart the Dashboard using the script.
 If the lookup error persists, check if there are other tools controlling iptables, such as firewall.
 This issue might also be related to the kernel, so try switching to the official kernel.
Invalid authorization method, or the login callback address is invalid, expired, or has been revoked ​
This issue appears only when using Gitee login, and the reason is unclear. Switching to GitHub is recommended.
oauth2: server response missing access_token ​
This could be caused by various factors, most likely a network issue. Check your network and try again.
 If unresolved, switching to Github or another method is recommended.
The user is not an admin of this site and cannot log in ​
You logged in with the wrong account or configured the wrong username. Note that the username is not an email, and you can use a script to modify it.
 For Cloudflare Access users, note that your username is not an email but a User ID.
dial tcp xxx:443 i/o timeout ​
This is a network issue. Try restarting Docker first, sudo systemctl restart docker, then restart the Dashboard using the script.
 If you are configuring Github login on a server in mainland China, switching to Cloudflare Access is recommended to avoid network interference.
net/http: TLS handshake timeout ​
Same as above.
Unable to receive email verification codes using Cloudflare Access as an OAuth2 Provider ​
  • Ensure that the email verification policy has been correctly configured in Policies.
  • Verify that the email address you provided is correct. Note that email addresses not on the policy whitelist will not receive verification codes.
',24),n=[r];function s(l,c,h,d,u,g){return o(),a("div",null,n)}const b=e(i,[["render",s]]);export{p as __pageData,b as default};
diff --git a/assets/en_US_guide_loginq.md.Dw2Asnbl.lean.js b/assets/en_US_guide_loginq.md.CFelVFsR.lean.js
similarity index 86%
rename from assets/en_US_guide_loginq.md.Dw2Asnbl.lean.js
rename to assets/en_US_guide_loginq.md.CFelVFsR.lean.js
index 548abbdb..2ff6045c 100644
--- a/assets/en_US_guide_loginq.md.Dw2Asnbl.lean.js
+++ b/assets/en_US_guide_loginq.md.CFelVFsR.lean.js
@@ -1 +1 @@
-import{_ as e,c as a,o,a4 as t}from"./chunks/framework.BmdFiWrL.js";const p=JSON.parse('{"title":"FAQ about logging into the Dashboard","description":"","frontmatter":{"outline":"deep"},"headers":[],"relativePath":"en_US/guide/loginq.md","filePath":"en_US/guide/loginq.md","lastUpdated":1720881864000}'),i={name:"en_US/guide/loginq.md"},r=t("",24),n=[r];function s(l,c,h,d,u,g){return o(),a("div",null,n)}const b=e(i,[["render",s]]);export{p as __pageData,b as default};
+import{_ as e,c as a,o,a4 as t}from"./chunks/framework.BmdFiWrL.js";const p=JSON.parse('{"title":"FAQ about logging into the Dashboard","description":"","frontmatter":{"outline":"deep"},"headers":[],"relativePath":"en_US/guide/loginq.md","filePath":"en_US/guide/loginq.md","lastUpdated":1720901424000}'),i={name:"en_US/guide/loginq.md"},r=t("",24),n=[r];function s(l,c,h,d,u,g){return o(),a("div",null,n)}const b=e(i,[["render",s]]);export{p as __pageData,b as default};
diff --git a/assets/en_US_guide_notifications.md.C1ETW-wK.js b/assets/en_US_guide_notifications.md.BKPemZAi.js
similarity index 99%
rename from assets/en_US_guide_notifications.md.C1ETW-wK.js
rename to assets/en_US_guide_notifications.md.BKPemZAi.js
index 7f37cf49..da510237 100644
--- a/assets/en_US_guide_notifications.md.C1ETW-wK.js
+++ b/assets/en_US_guide_notifications.md.BKPemZAi.js
@@ -1,4 +1,4 @@
-import{_ as i,c as s,o as t,a4 as a}from"./chunks/framework.BmdFiWrL.js";const E=JSON.parse('{"title":"Notification Configuration","description":"","frontmatter":{"outline":"deep"},"headers":[],"relativePath":"en_US/guide/notifications.md","filePath":"en_US/guide/notifications.md","lastUpdated":1720881864000}'),e={name:"en_US/guide/notifications.md"},n=a(`
Notification Configuration ​
Nezha Monitoring supports monitoring server load, CPU, memory, disk, traffic, monthly traffic, process count, and connection count, and sending notifications when user-defined thresholds are reached.
Flexible Notification Methods ​
  • In Dashboard messages, the placeholder #DATETIME# represents the timestamp of the event. When the notification is triggered, the Dashboard automatically replaces #DATETIME# with the actual event time.
  • #NEZHA# is a placeholder for Dashboard messages, and the Dashboard automatically replaces the placeholder with the actual message when the notification is triggered.
  • The body content is in JSON format: When the request type is FORM, the value is in key:value form, and placeholders can be placed inside value. The placeholders will be automatically replaced during notification. When the request type is JSON, only simple string replacement is performed before being submitted to the URL.
  • Placeholders can also be placed inside the URL, and simple string replacement will be performed during the request.
Refer to the following notification method examples, and you can also flexibly set the push method according to your needs.
Bark Example ​
Click to expand/collapse
  • Name: Bark
  • URL structure: /:key/:body or /:key/:title/:body or /:key/:category/:title/:body
  • Request Method: GET
  • Request Type: Default
  • Body: Empty
  • Name: Bark
  • URL structure: /push
  • Request Method: POST
  • Request Type: form
  • Body: {"title": "#SERVER.NAME#","device_key":"xxxxxxxxx","body":"#NEZHA#","icon":"https://xxxxxxxx/nz.png"}
Slack Example Contributor: @白歌 ​
Click to expand/collapse
URL Parameter Acquisition Instructions ​
Prepare your Slack Workspace in advance and create an App for this Workspace. If you have not created one, you can create an App at Slack API.
After creating the App, you need to add an Incoming Webhook to the App. In the App's settings page, find Incoming Webhooks, enable Activate Incoming Webhooks, and at the bottom of the page, find and click Add New Webhook to Workspace, choose a Channel, and click Allow. After creating, you will get a Webhook URL, which you will use to replace the example URL below.
Telegram Example Contributor: @白歌 ​
Click to expand/collapse
URL Parameter Acquisition Instructions ​
Create a bot in Telegram and get the bot's token and your Telegram user ID.
The token and user ID are alphanumeric strings. You can get your user ID by chatting with @userinfobot on Telegram. Create a bot by chatting with @BotFather, and you will get the bot's token.
Replace botXXXXXX with your bot token and YYYYYY with your user ID in the URL below. Note that you need to chat with the bot first, otherwise the bot cannot send messages to you.
Email Notification Example - Outlook Contributor: @白歌 ​
Click to expand/collapse
Note: SendCloud has a daily free email sending limit. This is just an example. You can choose a paid service or other similar free services. The usage method is similar.
URL Parameter Acquisition Instructions ​
This example uses SendCloud as the email service. You need to register an account on SendCloud, create a sender email, and then obtain the APIUSER and APIKEY here.
Replace <replaceAPIUSER> and <replaceAPIKEY> in the example URL below with your APIUSER and APIKEY, and replace <customSenderEmail> and <customRecipientEmail> with any sender and recipient email addresses.
Acknowledgements for articles and projects by ​
Disclaimer ​
  • This program is only for learning and understanding, non-profit purposes, please delete within 24 hours after downloading, not for any commercial purposes, text, data and images are copyrighted, if reproduced must indicate the source.
  • Use of this program is subject to the deployment disclaimer. Use of this program must follow the deployment of the server location, the country and the user's country laws and regulations, the author of the program is not responsible for any misconduct of the user.
+ \ No newline at end of file diff --git a/en_US/case/index.html b/en_US/case/index.html index 495a912a..52fddd04 100644 --- a/en_US/case/index.html +++ b/en_US/case/index.html @@ -12,7 +12,7 @@ - + @@ -23,7 +23,7 @@
Nezha Server Monitoring

English

简体中文

English

简体中文

Appearance

Nezha Monitoring

Community Project

Nezha Monitoring has benefited from various projects contributed by the community, which have provided it with additional extensions.

Learn More →

Submit a project

We welcome you to submit your own project. Please join the Telegram group to contact the administrator for further information.

Important Notes

All projects are contributed by community members. Please be aware that the Nezha Monitoring Team cannot assume responsibility for community projects, including but not limited to warranty, availability, security, etc.

- + \ No newline at end of file diff --git a/en_US/developer/index.html b/en_US/developer/index.html index 0e12a829..f6998828 100644 --- a/en_US/developer/index.html +++ b/en_US/developer/index.html @@ -12,7 +12,7 @@ - + @@ -23,7 +23,7 @@
Nezha Server Monitoring

English

简体中文

English

简体中文

Appearance

Development Manual

Nezha Monitoring Development Manual.

Start Now →
- + \ No newline at end of file diff --git a/en_US/developer/l10n.html b/en_US/developer/l10n.html index a983c4c9..9060a2e4 100644 --- a/en_US/developer/l10n.html +++ b/en_US/developer/l10n.html @@ -12,7 +12,7 @@ - + @@ -22,8 +22,8 @@ -
Nezha Server Monitoring

English

简体中文

English

简体中文

Appearance

Localization ​

Nezha Monitoring's Dashboard has added localization to support multiple languages, and you can follow these steps to support localization when developing new features

Introduction ​

  1. You can directly use the text configuration already available in /resource/l10n/en-US.toml to replace the text in the new feature.
  2. If there is new text in the new feature, please refer to the configuration text in en-US.toml, pull the new text into the configuration files of other languages such as en-US.toml, and add translations.

Adding a new localized text file ​

  1. Add a new language text configuration in /resource/l10n/.
  2. Pull existing text configurations from other languages in the new language text configuration.
  3. Add translations for the new language text configuration.
- +
Nezha Server Monitoring

English

简体中文

English

简体中文

Appearance

Localization ​

Nezha Monitoring's Dashboard has added localization to support multiple languages, and you can follow these steps to support localization when developing new features

Introduction ​

  1. You can directly use the text configuration already available in /resource/l10n/en-US.toml to replace the text in the new feature.
  2. If there is new text in the new feature, please refer to the configuration text in en-US.toml, pull the new text into the configuration files of other languages such as en-US.toml, and add translations.

Adding a new localized text file ​

  1. Add a new language text configuration in /resource/l10n/.
  2. Pull existing text configurations from other languages in the new language text configuration.
  3. Add translations for the new language text configuration.
+ \ No newline at end of file diff --git a/en_US/developer/theme.html b/en_US/developer/theme.html index 2e2739f2..ea9e045a 100644 --- a/en_US/developer/theme.html +++ b/en_US/developer/theme.html @@ -12,7 +12,7 @@ - + @@ -22,8 +22,8 @@ -
Nezha Server Monitoring

English

简体中文

English

简体中文

Appearance

Nezha Theme Development Environment ​

Nezha Monitoring provides a theme development environment that you can use to create new Nezha Monitoring themes

WARNING

Please note: This development environment only supports dashboard v0.13.16 and newer versions.

How to use ​

  1. Clone this repository to local
  2. Modify the Oauth2 configuration in data/config.yaml（The callback connection can be filled with http://localhost）
  3. Run docker-compose up
  4. Start development
  5. Once the theme has been created, you can place theme-custom in /opt/nezha/dashboard/theme-custom on the server

FAQ ​

  • If you can't use port 80, change the configuration in docker-compose.yaml.
- +
Nezha Server Monitoring

English

简体中文

English

简体中文

Appearance

Nezha Theme Development Environment ​

Nezha Monitoring provides a theme development environment that you can use to create new Nezha Monitoring themes

WARNING

Please note: This development environment only supports dashboard v0.13.16 and newer versions.

How to use ​

  1. Clone this repository to local
  2. Modify the Oauth2 configuration in data/config.yaml（The callback connection can be filled with http://localhost）
  3. Run docker-compose up
  4. Start development
  5. Once the theme has been created, you can place theme-custom in /opt/nezha/dashboard/theme-custom on the server

FAQ ​

  • If you can't use port 80, change the configuration in docker-compose.yaml.
+ \ No newline at end of file diff --git a/en_US/guide/agent.html b/en_US/guide/agent.html index 9a4157d4..dba45b5a 100644 --- a/en_US/guide/agent.html +++ b/en_US/guide/agent.html @@ -12,7 +12,7 @@ - + @@ -22,68 +22,11 @@ -
Nezha Server Monitoring

English

简体中文

English

简体中文

Appearance

Install Agent ​

This document will introduce how to install the Agent on the monitored server and connect it to the Dashboard.

TIP

The repository for Agent binaries can be found at: https://github.com/nezhahq/agent/releases

One-Click Installation of the Agent ​

Nezha Monitoring supports one-click installation of the Agent on both Windows and Linux. By following the steps in this document, you can easily deploy it on your server.

Preparation ​

You need to set up a communication domain in the admin panel in advance, and this domain should not be connected to a CDN. This document uses the example communication domain “data.example.com”.
Go to the settings page in the admin panel, fill in the communication domain in the “Non-CDN Dashboard Server Domain/IP” field, and click "Save".

One-Click Installation on Linux (Ubuntu, Debian, CentOS) ​

  1. First, add a server in the admin panel.
  2. Click the green Linux icon button next to the newly added server and copy the one-click installation command.
  3. Run the copied installation command on the monitored server, and wait for the installation to complete. Then, check if the server is online in the Dashboard home page.

One-Click Installation on Windows ​

  1. First, add a server in the admin panel.
  2. Click the green Windows icon button next to the newly added server and copy the one-click installation command.
  3. Go to the Windows server, run PowerShell, and execute the copied installation command in PowerShell.
  4. If you encounter a prompt to "change execution policy," choose Y.
  5. Wait for the installation to complete, then check if the server is online in the Dashboard home page.

WARNING

If you encounter errors when running the one-click installation command in PowerShell, try the Manual Installation of the Agent on Windows below.

Other Ways to Install the Agent ​

Installing the Agent on Linux (Ubuntu, Debian, CentOS) ​

Click to expand/collapse
  1. First, add a server in the admin panel.
  2. Run the script on the monitored server:
bash
curl -L https://raw.githubusercontent.com/naiba/nezha/master/script/install_en.sh  -o nezha.sh && chmod +x nezha.sh && sudo ./nezha.sh
  1. Select “Install monitoring Agent.”
  2. Enter the communication domain, such as "data.example.com".
  3. Enter the dashboard communication port (gRPC port), default is 5555.
  4. Enter the Agent secret, which is generated when you add a server in the admin panel and can be found on the “Servers” page in the admin panel.
  5. Wait for the installation to complete, then check if the server is online in the Dashboard home page.

Installing the Agent on Other Linux Distributions (e.g., Alpine using Openrc) ​

Click to expand/collapse

This section is contributed by unknown0054.

  1. Modify SERVER, SECRET, TLS, and execute in the shell:
shell
cat >/etc/init.d/nezha-agent<< EOF
-#!/sbin/openrc-run
-SERVER="" # Dashboard domain ip:port
-SECRET="" # SECRET
-TLS="" # Enable TLS if yes "--tls", leave empty if no
-NZ_BASE_PATH="/opt/nezha"
-NZ_AGENT_PATH="${NZ_BASE_PATH}/agent"
-pidfile="/run/${RC_SVCNAME}.pid"
-command="/opt/nezha/agent/nezha-agent"
-command_args="-s ${SERVER} -p ${SECRET} ${TLS}"
-command_background=true
-depend() {
-  need net
-}
-checkconfig() {
-  GITHUB_URL="github.com"
-  if [ ! -f "${NZ_AGENT_PATH}/nezha-agent" ]; then
-    if [[ $(uname -m | grep 'x86_64') != "" ]]; then
-      os_arch="amd64"
-    elif [[ $(uname -m | grep 'i386\|i686') != "" ]]; then
-      os_arch="386"
-    elif [[ $(uname -m | grep 'aarch64\|armv8b\|armv8l') != "" ]]; then
-      os_arch="arm64"
-    elif [[ $(uname -m | grep 'arm') != "" ]]; then
-      os_arch="arm"
-    elif [[ $(uname -m | grep 's390x') != "" ]]; then
-      os_arch="s390x"
-    elif [[ $(uname -m | grep 'riscv64') != "" ]]; then
-      os_arch="riscv64"
-    fi
-    local version=$(curl -m 10 -sL "https://api.github.com/repos/nezhahq/agent/releases/latest" | grep "tag_name" | head -n 1 | awk -F ":" '{print $2}' | sed 's/\"//g;s/,//g;s/ //g')
-    if [ ! -n "$version" ]; then
-      version=$(curl -m 10 -sL "https://fastly.jsdelivr.net/gh/nezhahq/agent/" | grep "option\.value" | awk -F "'" '{print $2}' | sed 's/nezhahq\/agent@/v/g')
-    fi
-    if [ ! -n "$version" ]; then
-      version=$(curl -m 10 -sL "https://gcore.jsdelivr.net/gh/nezhahq/agent/" | grep "option\.value" | awk -F "'" '{print $2}' | sed 's/nezhahq\/agent@/v/g')
-    fi
-    if [ ! -n "$version" ]; then
-      echo -e "Failed to get the version number. Please check if the server can connect to https://api.github.com/repos/nezhahq/agent/releases/latest"
-      return 0
-    else
-      echo -e "The latest version is: ${version}"
-    fi
-    wget -t 2 -T 10 -O nezha-agent_linux_${os_arch}.zip https://${GITHUB_URL}/nezhahq/agent/releases/download/${version}/nezha-agent_linux_${os_arch}.zip >/dev/null 2>&1
-    if [[ $? != 0 ]]; then
-      echo -e "Failed to download Release. Please check if the server can connect to ${GITHUB_URL}"
-      return 0
-    fi
-    mkdir -p $NZ_AGENT_PATH
-    chmod 755 -R $NZ_AGENT_PATH
-    unzip -qo nezha-agent_linux_${os_arch}.zip && mv nezha-agent $NZ_AGENT_PATH && rm -rf nezha-agent_linux_${os_arch}.zip README.md
-  fi
-  if [ ! -x "${NZ_AGENT_PATH}/nezha-agent" ]; then
-    chmod +x ${NZ_AGENT_PATH}/nezha-agent
-  fi
-}
-start_pre() {
-  if [ "${RC_CMD}" != "restart" ]; then
-    checkconfig || return $?
-  fi
-}
-EOF
  1. Add execute permissions
shell
chmod +x /etc/init.d/nezha-agent
  1. Start Nezha-Agent
shell
rc-service nezha-agent start
  1. Add to startup
shell
rc-update add nezha-agent

Manual Installation of the Agent on Windows ​

Installing the Agent on Synology DSM ​

Click to expand/collapse
sh
# Agent path
+    
Nezha Server Monitoring
English
简体中文
English
简体中文
Appearance
Install Agent ​
This document will introduce how to install the Agent on the monitored server and connect it to the Dashboard.
TIP
The repository for Agent binaries can be found at: https://github.com/nezhahq/agent/releases
One-Click Installation of the Agent ​
Nezha Monitoring supports one-click installation of the Agent on both Windows and Linux. By following the steps in this document, you can easily deploy it on your server.
Preparation ​
You need to set up a communication domain in the admin panel in advance, and this domain should not be connected to a CDN. This document uses the example communication domain “data.example.com”.
 Go to the settings page in the admin panel, fill in the communication domain in the “Non-CDN Dashboard Server Domain/IP” field, and click "Save".
One-Click Installation on Linux ​
  1. First, add a server in the admin panel.
  2. Click the green Linux icon button next to the newly added server and copy the one-click installation command.
  3. Run the copied installation command on the monitored server, and wait for the installation to complete. Then, check if the server is online in the Dashboard home page.
One-Click Installation on macOS ​
  1. First, add a server in the admin panel.
  2. Click the green Apple icon button next to the newly added server and copy the one-click installation command.
  3. Run the copied installation command on the monitored server, and wait for the installation to complete. Then, check if the server is online in the Dashboard home page.
One-Click Installation on Windows ​
  1. First, add a server in the admin panel.
  2. Click the green Windows icon button next to the newly added server and copy the one-click installation command.
  3. Go to the Windows server, run PowerShell, and execute the copied installation command in PowerShell.
  4. If you encounter a prompt to "change execution policy," choose Y.
  5. Wait for the installation to complete, then check if the server is online in the Dashboard home page.
WARNING
If you encounter errors when running the one-click installation command in PowerShell, try the Manual Installation of the Agent on Windows below.
Other Ways to Install the Agent ​
Installing the Agent on Linux (Support most distros) ​
Click to expand/collapse
  1. First, add a server in the admin panel.
  2. Run the script on the monitored server:
bash
curl -L https://raw.githubusercontent.com/naiba/nezha/master/script/install_en.sh  -o nezha.sh && chmod +x nezha.sh && sudo ./nezha.sh
  1. Select “Install monitoring Agent.”
  2. Enter the communication domain, such as "data.example.com".
  3. Enter the dashboard communication port (gRPC port), default is 5555.
  4. Enter the Agent secret, which is generated when you add a server in the admin panel and can be found on the “Servers” page in the admin panel.
  5. Wait for the installation to complete, then check if the server is online in the Dashboard home page.
Installing the Agent using the built-in service command (Support most systems) ​
Click to expand/collapse
First, get a copy of Nezha Agent: https://github.com/nezhahq/agent/releases
After extracting the archive, run the following command to install the service (may require root permission):
bash
./nezha-agent service install -s server_name:port -p password
You can also add other arguments except the server address and password. For more details, refer to the documentation: Customizing Agent Monitoring Items.
Uninstall the service:
bash
./nezha-agent service uninstall
Start the service:
bash
./nezha-agent service start
Stop the service:
bash
./nezha-agent service stop
Restart the service:
bash
./nezha-agent service restart
Installing the Agent with runit ​
Click to expand/collapse
The built-in service command of Agent supports most init systems, including FreeBSD rc.d and openrc, but still missing some of them.
Here we take Void Linux's runit as an example:
  1. Create directory /etc/sv/nezha-agent:
bash
mkdir /etc/sv/nezha-agent
  1. Create service file /etc/sv/nezha-agent/run, with following content:
bash
#!/bin/sh
+exec 2>&1
+exec /opt/nezha/agent/nezha-agent -s server_name:port -p password 2>&1
You can add other arguments here as well.
  1. Create logging service file /etc/sv/nezha-agent/log/run:
bash
#!/bin/sh
+exec vlogger -t nezha-agent -p daemon
  1. Enable the service:
bash
sudo ln -s /etc/sv/nezha-agent/ /var/service
Use the sv command to manage the service.
How to view logs:
  1. Install socklog and enable it:
bash
sudo xbps-install -S socklog-void
+sudo ln -s /etc/sv/socklog-unix /var/service
  1. Run svlogtail:
bash
sudo svlogtail | grep nezha-agent
Manual Installation of the Agent on Windows ​
Installing the Agent on Synology DSM ​
Click to expand/collapse
sh
# Agent path
 EXEC="/PATH/TO/nezha-agent"
 # Log path
 LOG="${EXEC}.log"
@@ -119,28 +62,7 @@
 # Start service
 systemctl start nezha
 # Enable service startup
-systemctl enable nezha
‼️ Modify the corresponding information before running the above commands with the root account to complete the installation.
Installing the Agent on macOS ​
Click to expand/collapse
This section is adapted from Mitsea Blog with the author's permission
WARNING
If you are prompted "macOS cannot verify this app" during installation, manually allow the program to run in System Settings.
  1. First, add a server in the admin panel.
  2. Go to the Release page to download the Agent binary file. Choose to download the darwin amd64 or arm64 Agent according to your CPU architecture. Download the amd64 version for Intel CPU, or the arm64 version for Apple Silicon. After downloading, unzip the Agent binary file, such as unzipping it to the Downloads folder.
  3. Create a file named nezha_agent.plist and save it with the following content:
xml
<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
-<plist version="1.0">
-<dict>
- <key>KeepAlive</key>
- <true/>
- <key>Label</key>
- <string>nezha_agent</string>
- <key>Program</key>
- <string>Modify the path to the Agent binary file here, such as: /Users/123/Downloads/nezha-agent</string>
- <key>ProgramArguments</key>
- <array>
-  <string>Modify the path to the Agent binary file here, same as above</string>
-  <string>--password</string>
-  <string>The communication secret, such as: 529664783eeb23cc25</string>
-  <string>--server</string>
-  <string>The communication URL and gRPC port, such as: data.example.com:5555</string>
- </array>
- <key>RunAtLoad</key>
- <true/>
-</dict>
-</plist>
  1. Load the plist file into launchd using the following command in Terminal, make sure to replace the file path:
shell
launchctl load /Users/123/Desktop/nezha_agent.plist
  1. Start the process:
shell
launchctl start nezha_agent
  1. Check if the process is running:
shell
launchctl list | grep nezha_agent
  1. Stop the process and remove it:
shell
launchctl stop nezha_agent
shell
launchctl remove nezha_agent
Installing the Agent on macOS Using Homebrew ​
Click to expand/collapse
This section is adapted from 🐿️松鼠收集🌰 with the author's permission
WARNING
Please be sure to add environment variables before installing nezha-agent through Homebrew! Homebrew creates the service-required plist file during software installation, and if you add the environment variables after installation, it will fail to start due to missing parameters.
  1. Add environment variables:
shell
echo 'export HOMEBREW_NEZHA_AGENT_PASSWORD="Communication key, obtained from the service page"' >> ~/.zshrc
+systemctl enable nezha
‼️ Modify the corresponding information before running the above commands with the root account to complete the installation.
Installing the Agent on macOS Using Homebrew ​
Click to expand/collapse
This section is adapted from 🐿️松鼠收集🌰 with the author's permission
WARNING
Please be sure to add environment variables before installing nezha-agent through Homebrew! Homebrew creates the service-required plist file during software installation, and if you add the environment variables after installation, it will fail to start due to missing parameters.
  1. Add environment variables:
shell
echo 'export HOMEBREW_NEZHA_AGENT_PASSWORD="Communication key, obtained from the service page"' >> ~/.zshrc
 echo 'export HOMEBREW_NEZHA_AGENT_SERVER="Your server and port, format your.domain:5555 "' >> ~/.zshrc
 source ~/.zshrc
  1. Install Nezha Agent:
DANGER
Note that this Homebrew repository is maintained by a third party and is unrelated to Nezha Monitoring. The Nezha project team does not endorse this repository's usability, security, etc. Please evaluate the risks yourself before using!
Since it has not yet been submitted to the Homebrew Core official library, it is temporarily placed in the third-party Homebrew repository maintained by the author of the blog:
shell
brew install brewforge/chinese/nezha-agent
  1. Start Nezha Agent service through Homebrew:
shell
brew services start nezha-agent
  1. Check the service status:
shell
brew services info nezha-agent
  1. Stop the service:
shell
brew services stop nezha-agent
  1. Uninstall Nezha Agent:
shell
brew rm nezha-agent
  1. If there is an error, first check the environment variables:
shell
echo $HOMEBREW_NEZHA_AGENT_PASSWORD
 echo $HOMEBREW_NEZHA_AGENT_SERVER
  1. If the environment variables are configured correctly, try reinstalling:
shell
brew services stop nezha-agent
@@ -165,8 +87,8 @@
  stop
  sleep 2
  start
-}
  • Run chmod +x /etc/init.d/nezha-service to grant execution permission.
  • Start the service: /etc/init.d/nezha-service enable && /etc/init.d/nezha-service start
Does the Agent Have a Docker Image? ​
The Agent does not currently have a Docker image.
 The design philosophy of the Agent is opposite to that of the Dashboard. While the Dashboard should minimally impact the server, the Agent needs to execute monitoring services and run commands within the server.
 Running the Agent inside a container can still perform monitoring tasks, but features like WebShell will not function properly, so no Docker image is provided.

-    
+}

Does the Agent Have a Docker Image? ​

The Agent does not currently have a Docker image.
The design philosophy of the Agent is opposite to that of the Dashboard. While the Dashboard should minimally impact the server, the Agent needs to execute monitoring services and run commands within the server.
Running the Agent inside a container can still perform monitoring tasks, but features like WebShell will not function properly, so no Docker image is provided.

+ \ No newline at end of file diff --git a/en_US/guide/agentq.html b/en_US/guide/agentq.html index 47163506..48dd25e0 100644 --- a/en_US/guide/agentq.html +++ b/en_US/guide/agentq.html @@ -12,7 +12,7 @@ - + @@ -22,8 +22,8 @@ -
Nezha Server Monitoring

English

简体中文

English

简体中文

Appearance

Frequently Asked Questions about the Agent ​

The IP Displayed in the Admin Panel is Different from the Actual Agent IP? ​

Please refer to Dashboard Related - Why is the IP Displayed in the Admin Panel Different from the Actual Agent IP?. This will not be repeated here.

Errors During One-Click Script Installation ​

curl: Failed to connect to raw.githubusercontent.com...... ​

This mostly occurs on servers in mainland China. Currently, the one-click script fetches the installation script directly from Github. You may try several times, or manually install the Agent. Additionally, you can find third-party Github acceleration services or mirrors and set them in the one-click installation script.

sudo: command not found ​

Please manually install sudo first, for example, in Ubuntu:

shell
apt install sudo
- +
Nezha Server Monitoring

English

简体中文

English

简体中文

Appearance

Frequently Asked Questions about the Agent ​

The IP Displayed in the Admin Panel is Different from the Actual Agent IP? ​

Please refer to Dashboard Related - Why is the IP Displayed in the Admin Panel Different from the Actual Agent IP?. This will not be repeated here.

Errors During One-Click Script Installation ​

curl: Failed to connect to raw.githubusercontent.com...... ​

This mostly occurs on servers in mainland China. Currently, the one-click script fetches the installation script directly from Github. You may try several times, or manually install the Agent. Additionally, you can find third-party Github acceleration services or mirrors and set them in the one-click installation script.

sudo: command not found ​

Please manually install sudo first, for example, in Ubuntu:

shell
apt install sudo
+ \ No newline at end of file diff --git a/en_US/guide/api.html b/en_US/guide/api.html index 4a3d2221..2fad441f 100644 --- a/en_US/guide/api.html +++ b/en_US/guide/api.html @@ -12,7 +12,7 @@ - + @@ -159,8 +159,8 @@ print(f"Memory Used: {server['status']['MemUsed']} bytes") print(f"Disk Used: {server['status']['DiskUsed']} bytes") print(f"Network In Speed: {server['status']['NetInSpeed']} bytes/s") -print(f"Network Out Speed: {server['status']['NetOutSpeed']} bytes/s")

With the above example code, you can easily obtain and process server status information, enabling automated monitoring and management.

 - +print(f"Network Out Speed: {server['status']['NetOutSpeed']} bytes/s")

With the above example code, you can easily obtain and process server status information, enabling automated monitoring and management.

 + \ No newline at end of file diff --git a/en_US/guide/dashboard.html b/en_US/guide/dashboard.html index fbfa5b3b..7aa30360 100644 --- a/en_US/guide/dashboard.html +++ b/en_US/guide/dashboard.html @@ -12,7 +12,7 @@ - + @@ -42,8 +42,8 @@ proxy /terminal/* http://ip:8008 { websocket header_upstream -Origin -}

Configuring SSL in the aaPanel ​

First, temporarily disable the reverse proxy.
Like configuring SSL certificates for other websites, enter the “SSL” in the site settings, and you can choose to automatically apply for a Let’s Encrypt certificate or manually configure an existing certificate.
After completing the SSL settings, go back to Github OAuth Apps and edit the previously created OAuth application. Change all the domain parts in "Homepage URL" and "Authorization callback URL" from http to https, such as "https://dashboard.example.com" and "https://dashboard.example.com/oauth2/callback". Failing to change this may result in being unable to log in to the admin panel.

Updating the Dashboard ​

Run the script ./nezha.sh, and select to restart and update the dashboard.

- +}

Configuring SSL in the aaPanel ​

First, temporarily disable the reverse proxy.
Like configuring SSL certificates for other websites, enter the “SSL” in the site settings, and you can choose to automatically apply for a Let’s Encrypt certificate or manually configure an existing certificate.
After completing the SSL settings, go back to Github OAuth Apps and edit the previously created OAuth application. Change all the domain parts in "Homepage URL" and "Authorization callback URL" from http to https, such as "https://dashboard.example.com" and "https://dashboard.example.com/oauth2/callback". Failing to change this may result in being unable to log in to the admin panel.

Updating the Dashboard ​

Run the script ./nezha.sh, and select to restart and update the dashboard.

+ \ No newline at end of file diff --git a/en_US/guide/dashboardq.html b/en_US/guide/dashboardq.html index 6f407a22..6998742d 100644 --- a/en_US/guide/dashboardq.html +++ b/en_US/guide/dashboardq.html @@ -12,7 +12,7 @@ - + @@ -31,8 +31,8 @@ expires 12h; error_log /dev/null; access_log /dev/null; - }

  • Save the configuration, clear the browser, Nginx, and CDN caches, and refresh the page to see if it returns to normal.

    • Dashboard Cannot Start: panic: Unable to find the configured DDNS provider... ​

    The value entered for the DDNS provider is incorrect. Currently, only webhook, cloudflare, tencentcloud, and dummy are supported.

    Dashboard DDNS Update Crash: panic: interface conversion: interface {} is nil, not []interface {} ​

    The entered DDNS AccessID or AccessSecret is incorrect.

    Network Monitoring Page Shows: server monitor history not found ​

    This error indicates that no TCP-Ping or ICMP-Ping type monitoring has been set in the services page or monitoring data has not yet been generated.
    If it has been set up, wait for some time and then check again.

    What to do if /terminal or /ws can't connect properly after enabling HTTPS? ​

    This is often due to an incomplete certificate. Add the -d parameter to the agent run command. If the log contains x509:certificate signed by unknown authority, replacing with a complete certificate will solve the problem.

    What if I'm not satisfied with the data modification/addition functionality provided by the dashboard and want to modify/add data myself? ​

    Common in scenarios like batch adding Agents, you can directly modify the database.
    Note that not everything in the database can be modified; incorrect modifications can lead to data corruption and inability to start the Dashboard. Do not modify the database casually!

    DANGER

    Again, do not modify the database casually!

    If you need to modify data in the database, stop the dashboard container first.
    The database type is sqlite3, located at /opt/nezha/dashboard/data/sqlite.db. Backup before modifying.

    Will the Dashboard automatically update? ​

    Agents typically update automatically, but the Dashboard does not and requires manual updates.

    - + }

  • Save the configuration, clear the browser, Nginx, and CDN caches, and refresh the page to see if it returns to normal.

    • Dashboard Cannot Start: panic: Unable to find the configured DDNS provider... ​

    The value entered for the DDNS provider is incorrect. Currently, only webhook, cloudflare, tencentcloud, and dummy are supported.

    Dashboard DDNS Update Crash: panic: interface conversion: interface {} is nil, not []interface {} ​

    The entered DDNS AccessID or AccessSecret is incorrect.

    Network Monitoring Page Shows: server monitor history not found ​

    This error indicates that no TCP-Ping or ICMP-Ping type monitoring has been set in the services page or monitoring data has not yet been generated.
    If it has been set up, wait for some time and then check again.

    What to do if /terminal or /ws can't connect properly after enabling HTTPS? ​

    This is often due to an incomplete certificate. Add the -d parameter to the agent run command. If the log contains x509:certificate signed by unknown authority, replacing with a complete certificate will solve the problem.

    What if I'm not satisfied with the data modification/addition functionality provided by the dashboard and want to modify/add data myself? ​

    Common in scenarios like batch adding Agents, you can directly modify the database.
    Note that not everything in the database can be modified; incorrect modifications can lead to data corruption and inability to start the Dashboard. Do not modify the database casually!

    DANGER

    Again, do not modify the database casually!

    If you need to modify data in the database, stop the dashboard container first.
    The database type is sqlite3, located at /opt/nezha/dashboard/data/sqlite.db. Backup before modifying.

    Will the Dashboard automatically update? ​

    Agents typically update automatically, but the Dashboard does not and requires manual updates.

    + \ No newline at end of file diff --git a/en_US/guide/loginq.html b/en_US/guide/loginq.html index 1d76abb6..c6403892 100644 --- a/en_US/guide/loginq.html +++ b/en_US/guide/loginq.html @@ -12,7 +12,7 @@ - + @@ -22,8 +22,8 @@ -
    Nezha Server Monitoring

    English

    简体中文

    English

    简体中文

    Appearance

    FAQ about logging into the Dashboard ​

    Stuck Page/Connection Refused/Long Response Time After Login Callback ​

    These issues can manifest in various ways, but ultimately the browser cannot display correctly after login.

    1. Your server cannot connect to Github/Gitee, which is most common when configuring Github on servers in mainland China. You may try several times or switch to Cloudflare Access.
    2. You have configured the callback address incorrectly. Ensure that your callback address is correct and that both the port and protocol are accurate!
    3. An unknown error occurred on the Dashboard. You can use a script to check the logs.

    TIP

    What is a protocol? In the browser, the string that ends your domain with :// is the protocol, usually http or https. Since there may be multiple protocol+domain+port combinations available for accessing the Dashboard in a normal deployment, make sure to choose the most appropriate one as the callback.

    How to Check if My Callback Address is Wrong? ​

    Ensure that the protocol+domain+port displayed in the browser before login and after the callback are consistent.
    Ensure that your path is /oauth2/callback, all in lowercase.

    Errors After Logging into the Admin Panel ​

    1. Clear cookies and log in again, or try a different browser.
    2. Check the callback address to ensure it is correct and that both the port and protocol are accurate! The address initiating the request must be in the same domain as the callback address, with the port, protocol, and domain (or IP) all matching.

    lookup xxx ​

    The container DNS resolution failed, usually due to modified iptables configurations.
    It is recommended to restart Docker first, sudo systemctl restart docker, then restart the Dashboard using the script.
    If the lookup error persists, check if there are other tools controlling iptables, such as firewall.
    This issue might also be related to the kernel, so try switching to the official kernel.

    Invalid authorization method, or the login callback address is invalid, expired, or has been revoked ​

    This issue appears only when using Gitee login, and the reason is unclear. Switching to GitHub is recommended.

    oauth2: server response missing access_token ​

    This could be caused by various factors, most likely a network issue. Check your network and try again.
    If unresolved, switching to Github or another method is recommended.

    The user is not an admin of this site and cannot log in ​

    You logged in with the wrong account or configured the wrong username. Note that the username is not an email, and you can use a script to modify it.
    For Cloudflare Access users, note that your username is not an email but a User ID.

    dial tcp xxx:443 i/o timeout ​

    This is a network issue. Try restarting Docker first, sudo systemctl restart docker, then restart the Dashboard using the script.
    If you are configuring Github login on a server in mainland China, switching to Cloudflare Access is recommended to avoid network interference.

    net/http: TLS handshake timeout ​

    Same as above.

    Unable to receive email verification codes using Cloudflare Access as an OAuth2 Provider ​

    • Ensure that the email verification policy has been correctly configured in Policies.
    • Verify that the email address you provided is correct. Note that email addresses not on the policy whitelist will not receive verification codes.
    - +
    Nezha Server Monitoring

    English

    简体中文

    English

    简体中文

    Appearance

    FAQ about logging into the Dashboard ​

    Stuck Page/Connection Refused/Long Response Time After Login Callback ​

    These issues can manifest in various ways, but ultimately the browser cannot display correctly after login.

    1. Your server cannot connect to Github/Gitee, which is most common when configuring Github on servers in mainland China. You may try several times or switch to Cloudflare Access.
    2. You have configured the callback address incorrectly. Ensure that your callback address is correct and that both the port and protocol are accurate!
    3. An unknown error occurred on the Dashboard. You can use a script to check the logs.

    TIP

    What is a protocol? In the browser, the string that ends your domain with :// is the protocol, usually http or https. Since there may be multiple protocol+domain+port combinations available for accessing the Dashboard in a normal deployment, make sure to choose the most appropriate one as the callback.

    How to Check if My Callback Address is Wrong? ​

    Ensure that the protocol+domain+port displayed in the browser before login and after the callback are consistent.
    Ensure that your path is /oauth2/callback, all in lowercase.

    Errors After Logging into the Admin Panel ​

    1. Clear cookies and log in again, or try a different browser.
    2. Check the callback address to ensure it is correct and that both the port and protocol are accurate! The address initiating the request must be in the same domain as the callback address, with the port, protocol, and domain (or IP) all matching.

    lookup xxx ​

    The container DNS resolution failed, usually due to modified iptables configurations.
    It is recommended to restart Docker first, sudo systemctl restart docker, then restart the Dashboard using the script.
    If the lookup error persists, check if there are other tools controlling iptables, such as firewall.
    This issue might also be related to the kernel, so try switching to the official kernel.

    Invalid authorization method, or the login callback address is invalid, expired, or has been revoked ​

    This issue appears only when using Gitee login, and the reason is unclear. Switching to GitHub is recommended.

    oauth2: server response missing access_token ​

    This could be caused by various factors, most likely a network issue. Check your network and try again.
    If unresolved, switching to Github or another method is recommended.

    The user is not an admin of this site and cannot log in ​

    You logged in with the wrong account or configured the wrong username. Note that the username is not an email, and you can use a script to modify it.
    For Cloudflare Access users, note that your username is not an email but a User ID.

    dial tcp xxx:443 i/o timeout ​

    This is a network issue. Try restarting Docker first, sudo systemctl restart docker, then restart the Dashboard using the script.
    If you are configuring Github login on a server in mainland China, switching to Cloudflare Access is recommended to avoid network interference.

    net/http: TLS handshake timeout ​

    Same as above.

    Unable to receive email verification codes using Cloudflare Access as an OAuth2 Provider ​

    • Ensure that the email verification policy has been correctly configured in Policies.
    • Verify that the email address you provided is correct. Note that email addresses not on the policy whitelist will not receive verification codes.
    + \ No newline at end of file diff --git a/en_US/guide/notifications.html b/en_US/guide/notifications.html index 007dc12c..c66dc118 100644 --- a/en_US/guide/notifications.html +++ b/en_US/guide/notifications.html @@ -12,7 +12,7 @@ - + @@ -61,8 +61,8 @@ "markdown": { "content": "# Nezha Notification\n\n\"#NEZHA#\"\n\n> Name: \"#SERVER.NAME#\"\n> IP: \"#SERVER.IP#\"\n> IPv4: \"#SERVER.IPV4#\"\nIPv6: \"#SERVER.IPV6#\"\n> CPU: \"#SERVER.CPU#\"\n> Memory: \"#SERVER.MEM#\"\n> Swap: \"#SERVER.SWAP#\"\n> Disk: \"#SERVER.DISK#\"\n> Upload Speed: \"#SERVER.NETINSPEED#\"\n> Download Speed: \"#SERVER.NETOUTSPEED#\"\n> Total Upload: \"#SERVER.TRANSFERIN#\"\n> Total Download: \"#SERVER.TRANSFEROUT#\"\n> Load1: \"#SERVER.LOAD1#\"\n> Load5: \"#SERVER.LOAD5#\"\n> Load15: \"#SERVER.LOAD15#\"\n> TCP Connection Count: \"#SERVER.TCPCONNCOUNT\"\n> UDP Connection Count: \"#SERVER.UDPCONNCOUNT\"\n\n" } -}

    You can remove or add relevant information as needed.

    Notification Rule Explanation ​

    Basic Rules ​

    Complete Examples:

    Add an offline notification:

    Add an notification for CPU usage exceeding 50% for 10 seconds and memory usage below 20% for 20 seconds:

    Send notifications for specific servers to specific notification groups:

    Scenario example:
    There are 4 servers (1, 2, 3, 4) and two notification groups (A, B).
    Notify group A if servers 1 and 2 are offline for 10 minutes.
    Notify group B if servers 3 and 4 are offline for 10 minutes.

    First, set up notification groups A and B, then add two notification rules:

    Rule 1:

    Rule 2:

    Flexibly using parameters can make your notification function fully utilized

    Special: Any Cycle Traffic notification ​

    Can be used for monthly traffic monitoring

    Example:

    For servers with IDs 3 and 4 (defined in ignore), if the monthly outbound traffic exceeds 1TB starting from the 1st of each month, send an notification:

    json
    [{"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}}]

    Notification Trigger Modes ​

    Set Tasks to Execute on notifications ​

    If you need to execute a task while sending an notification message, you can set this item.

    - +}

    You can remove or add relevant information as needed.

    Notification Rule Explanation ​

    Basic Rules ​

    Complete Examples:

    Add an offline notification:

    Add an notification for CPU usage exceeding 50% for 10 seconds and memory usage below 20% for 20 seconds:

    Send notifications for specific servers to specific notification groups:

    Scenario example:
    There are 4 servers (1, 2, 3, 4) and two notification groups (A, B).
    Notify group A if servers 1 and 2 are offline for 10 minutes.
    Notify group B if servers 3 and 4 are offline for 10 minutes.

    First, set up notification groups A and B, then add two notification rules:

    Rule 1:

    Rule 2:

    Flexibly using parameters can make your notification function fully utilized

    Special: Any Cycle Traffic notification ​

    Can be used for monthly traffic monitoring

    Example:

    For servers with IDs 3 and 4 (defined in ignore), if the monthly outbound traffic exceeds 1TB starting from the 1st of each month, send an notification:

    json
    [{"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}}]

    Notification Trigger Modes ​

    Set Tasks to Execute on notifications ​

    If you need to execute a task while sending an notification message, you can set this item.

    + \ No newline at end of file diff --git a/en_US/guide/q2.html b/en_US/guide/q2.html index 4da73446..08f7769c 100644 --- a/en_US/guide/q2.html +++ b/en_US/guide/q2.html @@ -12,7 +12,7 @@ - + @@ -22,8 +22,8 @@ -
    Nezha Server Monitoring

    English

    简体中文

    English

    简体中文

    Appearance

    Agent Startup/Online Troubleshooting Process ​

    1. Directly execute /opt/nezha/agent/nezha-agent -s DashboardIP or non-CDN domain:RPCPort -p AgentKey -d to check if the logs indicate timeouts due to DNS or poor network conditions.
    2. Use nc -v Domain/IP RPCPort or telnet Domain/IP RPCPort to check for network issues, inspect the inbound and outbound firewalls of the local machine and the panel server. If you cannot determine the issue, you can use the port checking tool provided by https://port.ping.pe/.
    3. If the above steps indicate no issues but the Agent still does not go online correctly, try disabling SELinux. How to disable SELinux?
    - +
    Nezha Server Monitoring

    English

    简体中文

    English

    简体中文

    Appearance

    Agent Startup/Online Troubleshooting Process ​

    1. Directly execute /opt/nezha/agent/nezha-agent -s DashboardIP or non-CDN domain:RPCPort -p AgentKey -d to check if the logs indicate timeouts due to DNS or poor network conditions.
    2. Use nc -v Domain/IP RPCPort or telnet Domain/IP RPCPort to check for network issues, inspect the inbound and outbound firewalls of the local machine and the panel server. If you cannot determine the issue, you can use the port checking tool provided by https://port.ping.pe/.
    3. If the above steps indicate no issues but the Agent still does not go online correctly, try disabling SELinux. How to disable SELinux?
    + \ No newline at end of file diff --git a/en_US/guide/q3.html b/en_US/guide/q3.html index d967b917..76167a26 100644 --- a/en_US/guide/q3.html +++ b/en_US/guide/q3.html @@ -12,7 +12,7 @@ - + @@ -95,8 +95,8 @@ localhost:~/agent# /opt/nezha/agent/nezha-agent -s nezha.xxx.xxx:443 -p YOUR_KEY --tls -d NEZHA@2023-12-20 05:14:00>> 检查更新： 0.15.14 NEZHA@2023-12-20 05:14:01>> 上报系统信息失败： rpc error: code = Unknown desc = EOF # You need to modify the GRPCHost and TLS options in the Dashboard /opt/nezha/dashboard/data/config.yaml -NEZHA@2023-12-20 05:14:01>> Error to close connection ... - +NEZHA@2023-12-20 05:14:01>> Error to close connection ... + \ No newline at end of file diff --git a/en_US/guide/q4.html b/en_US/guide/q4.html index 48f4c614..9aae1326 100644 --- a/en_US/guide/q4.html +++ b/en_US/guide/q4.html @@ -12,7 +12,7 @@ - + @@ -22,8 +22,8 @@ -
    Nezha Server Monitoring

    English

    简体中文

    English

    简体中文

    Appearance

    Real-Time Channel Disconnection/Online & Terminal Connection Failure ​

    • If you are using a CDN, ensure that the CDN provider offers WebSocket services and that WebSocket is enabled.
    • Confirm that your reverse proxy rules have special configurations for the /ws and /terminal paths. You can click here to view the reverse proxy configuration.
    - +
    Nezha Server Monitoring

    English

    简体中文

    English

    简体中文

    Appearance

    Real-Time Channel Disconnection/Online & Terminal Connection Failure ​

    • If you are using a CDN, ensure that the CDN provider offers WebSocket services and that WebSocket is enabled.
    • Confirm that your reverse proxy rules have special configurations for the /ws and /terminal paths. You can click here to view the reverse proxy configuration.
    + \ No newline at end of file diff --git a/en_US/guide/q5.html b/en_US/guide/q5.html index 0b882ad0..80e960f8 100644 --- a/en_US/guide/q5.html +++ b/en_US/guide/q5.html @@ -12,7 +12,7 @@ - + @@ -22,8 +22,8 @@ -
    Nezha Server Monitoring

    English

    简体中文

    English

    简体中文

    Appearance

    How to Perform Data Migration and Backup Recovery? ​

    1. Run the one-click script and choose Stop Dashboard.
    2. On the old server, package the /opt/nezha folder, copy it to the same location in the new environment, and extract it.
    3. In the new server, run the one-click script and choose Start Dashboard.
    - +
    Nezha Server Monitoring

    English

    简体中文

    English

    简体中文

    Appearance

    How to Perform Data Migration and Backup Recovery? ​

    1. Run the one-click script and choose Stop Dashboard.
    2. On the old server, package the /opt/nezha folder, copy it to the same location in the new environment, and extract it.
    3. In the new server, run the one-click script and choose Start Dashboard.
    + \ No newline at end of file diff --git a/en_US/guide/q6.html b/en_US/guide/q6.html index 4f2198d1..f7dd7519 100644 --- a/en_US/guide/q6.html +++ b/en_US/guide/q6.html @@ -12,7 +12,7 @@ - + @@ -22,8 +22,8 @@ -
    Nezha Server Monitoring

    English

    简体中文

    English

    简体中文

    Appearance

    How to Reset Traffic Statistics Monthly? ​

    The traffic statistics on the homepage reset every time the server restarts. To achieve a monthly reset of the traffic counter, you can do the following:

    1. Go to the Notification page in the management panel.
    2. Refer to this document to create a monthly traffic notification.
    3. Return to the homepage and go to the Services page, where you can see the monthly traffic statistics. The statistics here will not reset when the server restarts.

    TIP

    This method allows you to set any period, including but not limited to hourly, daily, weekly, monthly, or yearly traffic statistics reset, offering great flexibility!

    - +
    Nezha Server Monitoring

    English

    简体中文

    English

    简体中文

    Appearance

    How to Reset Traffic Statistics Monthly? ​

    The traffic statistics on the homepage reset every time the server restarts. To achieve a monthly reset of the traffic counter, you can do the following:

    1. Go to the Notification page in the management panel.
    2. Refer to this document to create a monthly traffic notification.
    3. Return to the homepage and go to the Services page, where you can see the monthly traffic statistics. The statistics here will not reset when the server restarts.

    TIP

    This method allows you to set any period, including but not limited to hourly, daily, weekly, monthly, or yearly traffic statistics reset, offering great flexibility!

    + \ No newline at end of file diff --git a/en_US/guide/q7.html b/en_US/guide/q7.html index ea66a64d..aac6aaf1 100644 --- a/en_US/guide/q7.html +++ b/en_US/guide/q7.html @@ -12,7 +12,7 @@ - + @@ -22,8 +22,8 @@ -
    Nezha Server Monitoring

    English

    简体中文

    English

    简体中文

    Appearance

    Customizing Agent Monitoring Items ​

    Customize Monitoring for Network Interfaces and Disk Partitions ​

    Execute the following command to select network interfaces and partitions, then restart the Agent for changes to take effect:

    bash
    /opt/nezha/agent/nezha-agent edit

    Additional Runtime Parameters ​

    Viewing Supported Parameters ​

    To view the supported runtime parameters, please execute the following command:

    bash
    ./nezha-agent --help

    Configuring Parameters ​

    If you installed the Agent using a one-click script, you can add or modify parameters by editing the system service configuration. Edit the file /etc/systemd/system/nezha-agent.service and append your desired parameters at the end of the ExecStart= line:

    • --report-delay: Sets the interval for reporting system information. The default is 1 second. To reduce system resource usage, you can set this to 3 (valid range: 1-4 seconds).
    • --skip-conn: Disables monitoring of network connections. Recommended for servers with high numbers of connections or high CPU usage.
    • --skip-procs: Disables monitoring of process counts, helping to reduce resource usage of the Agent.
    • --disable-auto-update: Disables the automatic update feature of the Agent, enhancing security.
    • --disable-force-update: Disables the forced update feature of the Agent, enhancing security.
    • --disable-command-execute: Prevents execution of any scheduled tasks or use of the WebSSH on the Agent, enhancing security.
    • --tls: Enables SSL/TLS encryption. This should be enabled when you are using nginx to reverse proxy the Agent's gRPC connections and nginx is configured with SSL/TLS.
    • --use-ipv6-countrycode: Forces the use of IPv6 addresses to query country codes. By default, the Agent uses IPv4 addresses to query country codes. If server supports IPv6 and the country code of the IPv4 address is different, can use this parameter.
    • --gpu: Enables GPU monitoring. Note: Monitoring GPU usage may require installation of additional dependencies. For more details, refer to the documentation: Enable GPU Monitoring.
    • --temperature: Enables hardware temperature monitoring. Only effective on supported hardware, some VPS may not be able to retrieve temperature information.
    • --debug: Enables debug mode.
    - +
    Nezha Server Monitoring

    English

    简体中文

    English

    简体中文

    Appearance

    Customizing Agent Monitoring Items ​

    Customize Monitoring for Network Interfaces and Disk Partitions ​

    Execute the following command to select network interfaces and partitions, then restart the Agent for changes to take effect:

    bash
    /opt/nezha/agent/nezha-agent edit

    Additional Runtime Parameters ​

    Viewing Supported Parameters ​

    To view the supported runtime parameters, please execute the following command:

    bash
    ./nezha-agent --help

    Configuring Parameters ​

    If you installed the Agent using a one-click script, you can add or modify parameters by editing the system service configuration. Edit the file /etc/systemd/system/nezha-agent.service and append your desired parameters at the end of the ExecStart= line:

    • --report-delay: Sets the interval for reporting system information. The default is 1 second. To reduce system resource usage, you can set this to 3 (valid range: 1-4 seconds).
    • --skip-conn: Disables monitoring of network connections. Recommended for servers with high numbers of connections or high CPU usage.
    • --skip-procs: Disables monitoring of process counts, helping to reduce resource usage of the Agent.
    • --disable-auto-update: Disables the automatic update feature of the Agent, enhancing security.
    • --disable-force-update: Disables the forced update feature of the Agent, enhancing security.
    • --disable-command-execute: Prevents execution of any scheduled tasks or use of the WebSSH on the Agent, enhancing security.
    • --tls: Enables SSL/TLS encryption. This should be enabled when you are using nginx to reverse proxy the Agent's gRPC connections and nginx is configured with SSL/TLS.
    • --use-ipv6-countrycode: Forces the use of IPv6 addresses to query country codes. By default, the Agent uses IPv4 addresses to query country codes. If server supports IPv6 and the country code of the IPv4 address is different, can use this parameter.
    • --gpu: Enables GPU monitoring. Note: Monitoring GPU usage may require installation of additional dependencies. For more details, refer to the documentation: Enable GPU Monitoring.
    • --temperature: Enables hardware temperature monitoring. Only effective on supported hardware, some VPS may not be able to retrieve temperature information.
    • -d --debug: Enables debug mode.
    • -u --ip-report-period: Set IP update interval. Is only effective when the set value is higher than --report-delay. The default is 1800 seconds.
    • -k --insecure: Disable TLS certificate integrity check. Useful in situations involving a self-signed certificate.
    + \ No newline at end of file diff --git a/en_US/guide/q8.html b/en_US/guide/q8.html index dc7d8cd0..c11e195a 100644 --- a/en_US/guide/q8.html +++ b/en_US/guide/q8.html @@ -12,7 +12,7 @@ - + @@ -27,8 +27,8 @@ ClientID: 3516291f53eca9b4901a01337e41be7dc52f565c8657d08a3fddb2178d13c5bf ClientSecret: 0568b67c7b6d0ed51c663e2fe935683007c28f947a27b7bd47a5ad3d8b56fb67 Endpoint: "https://xxxxx.cloudflareaccess.com" - Type: cloudflare

    Configuration Description: ​

    ParameterRetrieval Method
    AdminMy Team -> Users -> <specific user> -> User ID
    ClientID/ClientSecretAccess -> Application -> Add an Application
    -> SaaS -> OIDC
    EndpointAccess -> Application -> Application URL -> Only keep the protocol and domain, no path

    Setting Up a New SaaS-OIDC Application ​

    Navigate to the Zero Trust Dashboard: https://one.dash.cloudflare.com/. Choose or create a new account, then follow these steps:

    1. Go to My Team -> Users -> Click <specific user> -> Obtain and save the User ID. (If this is your first time using Zero Trust, the Users list will be empty, and you can skip this step; users will appear after completing a verification.)
    2. Navigate to Access -> Applications -> Add an Application.
    3. Select SaaS. In the Application field, enter a custom application name (e.g., nezha), select OIDC, and then click Add application.
    4. For Scopes, select openid, email, profile, groups.
    5. In Redirect URLs, enter your Dashboard Callback URL, such as https://dashboard.example.com/oauth2/callback.
    6. Record the Client ID, Client Secret, and the protocol and domain part of the Issuer address, for example, https://xxxxx.cloudflareaccess.com.
    7. Edit the Dashboard configuration file (usually located at /opt/nezha/dashboard/data/config.yaml), adjust the OAuth2 settings according to the example configuration, and restart the Dashboard service.

    Identity Verification Strategy Configuration ​

    After setting up the Dashboard, you need to configure identity verification policies in the Zero Trust Dashboard. Navigate to: Access -> Applications -> <application name> -> Policies. You can choose from various SSO authentication methods, including email OTP and hardware key verification. For detailed configurations, refer to the Cloudflare Zero Trust Documentation.

    Policy Configuration Example (One-time PIN) ​

    Using email OTP as the default verification method:

    1. Navigate to Access -> Applications -> <application name> -> Policies -> Add a policy.
    2. Set a Policy Name, for example, OTP, and set Action to Allow.
    3. Under Configure rules, add a new Include rule. Select Emails as the Selector and enter your email address in the textbox.
    4. Click Save policy to save the configuration.

    Testing the Policy ​

    1. If the configuration is correct, when you visit the Dashboard login interface, it will display as "Log in with Cloudflare Account." Clicking on login will redirect you to the Cloudflare Access login page.
    2. Enter the email address configured previously, click Send me a code, and then enter the code received to log in to the Dashboard.
    3. If User ID was not specified in Admin during previous steps, an error message will be displayed after login: "This user is not an administrator of this site and cannot log in." At this point, you need to go to My Team -> Users, find the corresponding user, click on the username to get the User ID, and enter it into the Admin section of the Dashboard configuration file. After restarting the Dashboard service, try logging in again.
    - + Type: cloudflare

    Configuration Description: ​

    ParameterRetrieval Method
    AdminMy Team -> Users -> <specific user> -> User ID
    ClientID/ClientSecretAccess -> Application -> Add an Application
    -> SaaS -> OIDC
    EndpointAccess -> Application -> Application URL -> Only keep the protocol and domain, no path

    Setting Up a New SaaS-OIDC Application ​

    Navigate to the Zero Trust Dashboard: https://one.dash.cloudflare.com/. Choose or create a new account, then follow these steps:

    1. Go to My Team -> Users -> Click <specific user> -> Obtain and save the User ID. (If this is your first time using Zero Trust, the Users list will be empty, and you can skip this step; users will appear after completing a verification.)
    2. Navigate to Access -> Applications -> Add an Application.
    3. Select SaaS. In the Application field, enter a custom application name (e.g., nezha), select OIDC, and then click Add application.
    4. For Scopes, select openid, email, profile, groups.
    5. In Redirect URLs, enter your Dashboard Callback URL, such as https://dashboard.example.com/oauth2/callback.
    6. Record the Client ID, Client Secret, and the protocol and domain part of the Issuer address, for example, https://xxxxx.cloudflareaccess.com.
    7. Edit the Dashboard configuration file (usually located at /opt/nezha/dashboard/data/config.yaml), adjust the OAuth2 settings according to the example configuration, and restart the Dashboard service.

    Identity Verification Strategy Configuration ​

    After setting up the Dashboard, you need to configure identity verification policies in the Zero Trust Dashboard. Navigate to: Access -> Applications -> <application name> -> Policies. You can choose from various SSO authentication methods, including email OTP and hardware key verification. For detailed configurations, refer to the Cloudflare Zero Trust Documentation.

    Policy Configuration Example (One-time PIN) ​

    Using email OTP as the default verification method:

    1. Navigate to Access -> Applications -> <application name> -> Policies -> Add a policy.
    2. Set a Policy Name, for example, OTP, and set Action to Allow.
    3. Under Configure rules, add a new Include rule. Select Emails as the Selector and enter your email address in the textbox.
    4. Click Save policy to save the configuration.

    Testing the Policy ​

    1. If the configuration is correct, when you visit the Dashboard login interface, it will display as "Log in with Cloudflare Account." Clicking on login will redirect you to the Cloudflare Access login page.
    2. Enter the email address configured previously, click Send me a code, and then enter the code received to log in to the Dashboard.
    3. If User ID was not specified in Admin during previous steps, an error message will be displayed after login: "This user is not an administrator of this site and cannot log in." At this point, you need to go to My Team -> Users, find the corresponding user, click on the username to get the User ID, and enter it into the Admin section of the Dashboard configuration file. After restarting the Dashboard service, try logging in again.
    + \ No newline at end of file diff --git a/en_US/guide/q9.html b/en_US/guide/q9.html index b7681201..2d668d94 100644 --- a/en_US/guide/q9.html +++ b/en_US/guide/q9.html @@ -12,7 +12,7 @@ - + @@ -22,7 +22,7 @@ -
    Nezha Server Monitoring

    English

    简体中文

    English

    简体中文

    Appearance

    Enable GPU monitoring ​

    GPU monitoring is a new feature implemented in Nezha Monitoring v0.17.x. Before using the feature, please check you Dashboard version is higher than v0.17.2 and Agent version is higher than v0.17.0.

    Enable ​

    From Command-Line Flag ​

    Append the --gpu flag to the Agent argument. For example:

    bash
    /opt/nezha/agent/nezha-agent -s example.com:5555 -p example --gpu

    From configuration file ​

    Execute the following command to modify Agent configuration to enable GPU monitoring.

    bash
    /opt/nezha/agent/nezha-agent edit

    In the returned interactive menu, choose to enable GPU monitoring.

    Enable GPU utilization monitoring ​

    GPU model and GPU utilization are two different monitor items, which uses different approaches to obtain their value.

    Windows and macOS supports getting GPU utilization without extra dependencies, and support multiple graphics card brands.

    Linux distros support only NVIDIA and AMD cards and need to install extra dependencies.

    Below are the instructions on how to enable GPU utilization monitoring on Linux for NVIDIA / AMD graphics cards.

    NVIDIA ​

    NVIDIA cards need the nvidia-smi utility to get GPU utilization. This utility is included in the official driver by default.

    If you use unofficial drivers like nouveau, then it's not possible to get GPU utilization.

    AMD ​

    AMD cards need to install the official amdgpu driver and the rocm-smi utility.

    Mainstream distros have already packaged rocm-smi, below are commands to install the utility on these distros:

    bash
    # Arch Linux
+    
    Nezha Server Monitoring
    English
    简体中文
    English
    简体中文
    Appearance
    Enable GPU monitoring ​
    GPU monitoring is a new feature implemented in Nezha Monitoring v0.17.x. Before using the feature, please ensure your Dashboard version is higher than v0.17.2 and Agent version is higher than v0.17.0.
    Enable ​
    From Command-Line Flag ​
    Append the --gpu flag to the Agent argument. For example:
    bash
    /opt/nezha/agent/nezha-agent -s example.com:5555 -p example --gpu
    From configuration file ​
    Execute the following command to modify Agent configuration to enable GPU monitoring.
    bash
    /opt/nezha/agent/nezha-agent edit
    In the interactive menu returned, choose to enable GPU monitoring.
    Enable GPU utilization monitoring ​
    GPU model and GPU utilization are two different monitor items, which uses different approaches to obtain their value.
    Windows and macOS supports getting GPU utilization without extra dependencies, and support multiple graphics card brands.
    Linux distros support only NVIDIA and AMD cards and need to install extra dependencies.
    Below are the instructions on how to enable GPU utilization monitoring on Linux for NVIDIA / AMD graphics cards.
    NVIDIA ​
    NVIDIA cards need the nvidia-smi utility to get GPU utilization. This utility is included in the official driver by default.
    If you use unofficial drivers like nouveau, then it's not possible to get GPU utilization.
    AMD ​
    AMD cards need to install the open source amdgpu driver and the rocm-smi utility.
    Mainstream distros have already packaged rocm-smi, below are commands to install the utility on these distros:
    bash
    # Arch Linux
 pacman -Sy rocm-smi-lib
 
 # Debian / Ubuntu
@@ -35,8 +35,8 @@
 cmake ..
 make -j $(nproc)
 # Install library file and header; default location is /opt/rocm
-make install
    
-    
+make install
    + \ No newline at end of file diff --git a/en_US/guide/servers.html b/en_US/guide/servers.html index 37a1de97..7b0d3a3d 100644 --- a/en_US/guide/servers.html +++ b/en_US/guide/servers.html @@ -12,7 +12,7 @@ - + @@ -47,8 +47,8 @@ WebhookURL: "" WebhookRequestBody: "" WebhookHeaders: ""

    Other options can be referenced from the Single Configuration section.

    Dashboard Configuration ​

    After modifying the configuration file, you also need to modify the server settings in the Dashboard for the DDNS to take effect.

    DDNS related options:

    WARNING

    When you modify the configuration and save it in the Dashboard settings, it will populate the default configuration options in config.yaml, and both single and multiple configurations will exist in the DDNS section.

    Viewing Logs ​

    In the Dashboard logs, you can see the relevant logs for the DDNS functionality. When configured correctly, there will be corresponding log entries when updating DNS records.

    shell
    dashboard_1  | 2024/03/16 23:16:25 NEZHA>> 正在尝试更新域名(ddns.example.com)DDNS(1/3) # Attempting to update domain (ddns.example.com) DDNS (1/3)
-dashboard_1  | 2024/03/16 23:16:28 NEZHA>> 尝试更新域名(ddns.example.com)DDNS成功 # Successfully updated domain (ddns.example.com) DDNS
    - +dashboard_1 | 2024/03/16 23:16:28 NEZHA>> 尝试更新域名(ddns.example.com)DDNS成功 # Successfully updated domain (ddns.example.com) DDNS + \ No newline at end of file diff --git a/en_US/guide/services.html b/en_US/guide/services.html index 30c35f1c..e98cd1f2 100644 --- a/en_US/guide/services.html +++ b/en_US/guide/services.html @@ -12,7 +12,7 @@ - + @@ -22,8 +22,8 @@ -
    Nezha Server Monitoring

    English

    简体中文

    English

    简体中文

    Appearance

    Service Monitoring ​

    The Services section is where you set up monitoring for external websites or servers using Agents.
    Configured service monitors can be viewed on the "Services" page of the homepage, displaying the availability monitoring results for the past 30 days.

    How to Use ​

    To add a new monitor, go to the "Services" page in the Admin Panel and click "Add Monitor."

    When adding a new service monitor, you need to set the following parameters:

    • Name: Customize a name.

    • Type: Select a monitor type. Nezha Monitoring currently supports three types: "HTTP-GET," "ICMP-Ping," and "TCP-Ping."

    • Target: Depending on the type you choose, the method for setting the target differs:

      • HTTP-GET: For this type, you should enter a URL as the target, including http:// or https://. If your target URL is https://, the SSL certificate of that URL will also be monitored. Notifications will be triggered when the SSL certificate expires or changes. Example: https://example.com.
      • ICMP-Ping: For this type, you should enter a domain name or IP without a port number. Example: 1.1.1.1 or example.com.
      • TCP-Ping: For this type, you should enter a domain name or IP with a port number. Example: 1.1.1.1:80 or example.com:22.

    • Request Interval: Set the interval in seconds at which the Agent requests the target.

    • Coverage: Select a rule to determine which Agents will request the target.

    • Specific Servers: Used in conjunction with the coverage scope, select Agents within the rule to exclude.

    • Notification Group: Choose the notification methods you have already set up on the "Notification" page. Click here for more details.

    • Enable Fault Notification: Choose whether to receive fault notifications for the target as needed. The default is unchecked.

    After setting it up, click "Add." Wait a moment and go to the "Services" page on the homepage to view the monitoring results.

    Latency Change Notification ​

    Nezha Monitoring can monitor and record the latency between the Agent and the target server, sending notifications when there are significant changes. This feature helps you monitor if the server's network route has changed.

    • Enable Latency Notifications: When enabled, Notification will be sent if the latency from the Agent to the target server is greater than the Maximum Latency or less than the Minimum Latency.

    Trigger Tasks on Notification ​

    If you need to execute tasks when service monitoring Notification are triggered, you can check "Enable Trigger Tasks" and select the pre-configured trigger tasks in "Task on Notification" and "Task on Recovery."

    Network Latency Chart ​

    The TCP-Ping and ICMP-Ping monitoring types set in the Services page will automatically enable the monitoring chart feature. On the "Network" page of the homepage, you can view historical network latency charts. The data in the charts is based on the latency from the Agent to the target server. You can click the Agent's name to toggle the chart display. In the chart, you can uncheck the target server's name to hide or show the corresponding data.

    Managing Monitors ​

    To manage existing service monitors, go to the "Services" page in the Admin Panel. Select a monitor configuration and click the icons on the right to edit or delete it.

    - +
    Nezha Server Monitoring

    English

    简体中文

    English

    简体中文

    Appearance

    Service Monitoring ​

    The Services section is where you set up monitoring for external websites or servers using Agents.
    Configured service monitors can be viewed on the "Services" page of the homepage, displaying the availability monitoring results for the past 30 days.

    How to Use ​

    To add a new monitor, go to the "Services" page in the Admin Panel and click "Add Monitor."

    When adding a new service monitor, you need to set the following parameters:

    • Name: Customize a name.

    • Type: Select a monitor type. Nezha Monitoring currently supports three types: "HTTP-GET," "ICMP-Ping," and "TCP-Ping."

    • Target: Depending on the type you choose, the method for setting the target differs:

      • HTTP-GET: For this type, you should enter a URL as the target, including http:// or https://. If your target URL is https://, the SSL certificate of that URL will also be monitored. Notifications will be triggered when the SSL certificate expires or changes. Example: https://example.com.
      • ICMP-Ping: For this type, you should enter a domain name or IP without a port number. Example: 1.1.1.1 or example.com.
      • TCP-Ping: For this type, you should enter a domain name or IP with a port number. Example: 1.1.1.1:80 or example.com:22.

    • Request Interval: Set the interval in seconds at which the Agent requests the target.

    • Coverage: Select a rule to determine which Agents will request the target.

    • Specific Servers: Used in conjunction with the coverage scope, select Agents within the rule to exclude.

    • Notification Group: Choose the notification methods you have already set up on the "Notification" page. Click here for more details.

    • Enable Fault Notification: Choose whether to receive fault notifications for the target as needed. The default is unchecked.

    After setting it up, click "Add." Wait a moment and go to the "Services" page on the homepage to view the monitoring results.

    Latency Change Notification ​

    Nezha Monitoring can monitor and record the latency between the Agent and the target server, sending notifications when there are significant changes. This feature helps you monitor if the server's network route has changed.

    • Enable Latency Notifications: When enabled, Notification will be sent if the latency from the Agent to the target server is greater than the Maximum Latency or less than the Minimum Latency.

    Trigger Tasks on Notification ​

    If you need to execute tasks when service monitoring Notification are triggered, you can check "Enable Trigger Tasks" and select the pre-configured trigger tasks in "Task on Notification" and "Task on Recovery."

    Network Latency Chart ​

    The TCP-Ping and ICMP-Ping monitoring types set in the Services page will automatically enable the monitoring chart feature. On the "Network" page of the homepage, you can view historical network latency charts. The data in the charts is based on the latency from the Agent to the target server. You can click the Agent's name to toggle the chart display. In the chart, you can uncheck the target server's name to hide or show the corresponding data.

    Managing Monitors ​

    To manage existing service monitors, go to the "Services" page in the Admin Panel. Select a monitor configuration and click the icons on the right to edit or delete it.

    + \ No newline at end of file diff --git a/en_US/guide/settings.html b/en_US/guide/settings.html index 500837e4..af7c9526 100644 --- a/en_US/guide/settings.html +++ b/en_US/guide/settings.html @@ -12,7 +12,7 @@ - + @@ -332,8 +332,8 @@ .hotaru-cover { background: url(https://s3.ax1x.com/2020/12/08/DzHv6A.jpg) center; } -</style>

    View Password ​

    If you don't want to display your Dashboard directly to visitors, you can set a view password here. After setting the password, visitors need to enter the password to access the homepage.

    Non-CDN Dashboard Server Domain/IP ​

    This setting is a prerequisite for using the one-click script to install the Agent. For details, please see here.

    IP Change Notifications ​

    If you want to receive notifications when a server's IP changes, you can set it up here.

    Coverage ​

    Select a rule to determine which servers to monitor. Choose according to your needs.

    Specific Servers ​

    Set exclusions for the selected rule in conjunction with the coverage scope.

    Send Notifications to a Specific Notification Group ​

    Choose a notification method, which should be set up in advance on the "Notification" page.

    WARNING

    Notifications take effect after enabling this setting.

    Show Full IP Address in Notifications ​

    IP change notifications hide the full IP by default. If you don't want to hide it, check "Show Full IP Address in Notification."

    Disable Homepage Theme Switching ​

    By default, the Dashboard allows visitors to change the theme. This feature only affects individual visitors and does not affect the theme set by the administrator in the admin panel. If you don't want visitors to switch themes, check this option.

    - +</style>

    View Password ​

    If you don't want to display your Dashboard directly to visitors, you can set a view password here. After setting the password, visitors need to enter the password to access the homepage.

    Non-CDN Dashboard Server Domain/IP ​

    This setting is a prerequisite for using the one-click script to install the Agent. For details, please see here.

    IP Change Notifications ​

    If you want to receive notifications when a server's IP changes, you can set it up here.

    Coverage ​

    Select a rule to determine which servers to monitor. Choose according to your needs.

    Specific Servers ​

    Set exclusions for the selected rule in conjunction with the coverage scope.

    Send Notifications to a Specific Notification Group ​

    Choose a notification method, which should be set up in advance on the "Notification" page.

    WARNING

    Notifications take effect after enabling this setting.

    Show Full IP Address in Notifications ​

    IP change notifications hide the full IP by default. If you don't want to hide it, check "Show Full IP Address in Notification."

    Disable Homepage Theme Switching ​

    By default, the Dashboard allows visitors to change the theme. This feature only affects individual visitors and does not affect the theme set by the administrator in the admin panel. If you don't want visitors to switch themes, check this option.

    + \ No newline at end of file diff --git a/en_US/guide/tasks.html b/en_US/guide/tasks.html index 5894d172..8765baba 100644 --- a/en_US/guide/tasks.html +++ b/en_US/guide/tasks.html @@ -12,7 +12,7 @@ - + @@ -22,8 +22,8 @@ -
    Nezha Server Monitoring

    English

    简体中文

    English

    简体中文

    Appearance

    Task Management ​

    In the Tasks section, you can set up scheduled tasks, trigger tasks, and batch execute tasks on multiple servers.

    Nezha Monitoring supports pushing commands to Agents for execution. This feature is highly flexible and can be used for regular backups using tools like restic or rclone, periodically restarting a service to reset network connections, or executing a task when an notification is triggered, such as running a script when CPU usage is high for an extended period.

    How to Use ​

    Go to the "Tasks" page in the admin panel and click "Add Scheduled Task." When adding a scheduled task, you need to fill in the following parameters:

    • Name: Customize a task name.

    • Task Type: Choose the type of task.

      • Scheduled Task: Executes periodically according to the schedule set below.
      • Trigger Task: Only executed when triggered by an API call or notification rule, runs once per trigger.

    • Schedule: Set the schedule time (not enable when using trigger task type). The time format is * * * * * *, corresponding to second minute hour day month weekday. For more details, see Cron Expression Format.
      For example: 0 0 3 * * * means "3 AM every day."

    • Command: Set the command to execute, similar to writing Shell/Bat scripts, but it's recommended not to use new lines; connect multiple commands with && or &.
      For example, to schedule a reboot, you can enter reboot here.

    • Coverage and Specific Servers: Select rules to determine which Agents execute the scheduled task, similar to the settings on the "Services" page. When using the trigger task type, you can choose "executed by the triggered server."

    • Notification Group: Choose the notification methods you have set up on the "Notifications" page. Click here for more details.

    • Send Success Notification: Check this option to trigger a notification upon successful task execution.

    Managing Tasks ​

    To manage existing scheduled tasks, go to the "Tasks" page in the admin panel. For each task configuration, the three icons on the right are:

    • Execute Immediately: Click to ignore the scheduled time and execute the task immediately.
    • Edit: Click to modify the task configuration.
    • Delete: Delete the scheduled task.

    Frequently Asked Questions ​

    1. Command not found error
      If a command fails to run with a "command not found" error, it may be a PATH environment variable issue. On Linux servers, you can add source ~/.bashrc at the beginning of the command or use the absolute path to execute the command.
    - +
    Nezha Server Monitoring

    English

    简体中文

    English

    简体中文

    Appearance

    Task Management ​

    In the Tasks section, you can set up scheduled tasks, trigger tasks, and batch execute tasks on multiple servers.

    Nezha Monitoring supports pushing commands to Agents for execution. This feature is highly flexible and can be used for regular backups using tools like restic or rclone, periodically restarting a service to reset network connections, or executing a task when an notification is triggered, such as running a script when CPU usage is high for an extended period.

    How to Use ​

    Go to the "Tasks" page in the admin panel and click "Add Scheduled Task." When adding a scheduled task, you need to fill in the following parameters:

    • Name: Customize a task name.

    • Task Type: Choose the type of task.

      • Scheduled Task: Executes periodically according to the schedule set below.
      • Trigger Task: Only executed when triggered by an API call or notification rule, runs once per trigger.

    • Schedule: Set the schedule time (not enable when using trigger task type). The time format is * * * * * *, corresponding to second minute hour day month weekday. For more details, see Cron Expression Format.
      For example: 0 0 3 * * * means "3 AM every day."

    • Command: Set the command to execute, similar to writing Shell/Bat scripts, but it's recommended not to use new lines; connect multiple commands with && or &.
      For example, to schedule a reboot, you can enter reboot here.

    • Coverage and Specific Servers: Select rules to determine which Agents execute the scheduled task, similar to the settings on the "Services" page. When using the trigger task type, you can choose "executed by the triggered server."

    • Notification Group: Choose the notification methods you have set up on the "Notifications" page. Click here for more details.

    • Send Success Notification: Check this option to trigger a notification upon successful task execution.

    Managing Tasks ​

    To manage existing scheduled tasks, go to the "Tasks" page in the admin panel. For each task configuration, the three icons on the right are:

    • Execute Immediately: Click to ignore the scheduled time and execute the task immediately.
    • Edit: Click to modify the task configuration.
    • Delete: Delete the scheduled task.

    Frequently Asked Questions ​

    1. Command not found error
      If a command fails to run with a "command not found" error, it may be a PATH environment variable issue. On Linux servers, you can add source ~/.bashrc at the beginning of the command or use the absolute path to execute the command.
    + \ No newline at end of file diff --git a/en_US/index.html b/en_US/index.html index 2b2cb095..fc9355e8 100644 --- a/en_US/index.html +++ b/en_US/index.html @@ -12,7 +12,7 @@ - + @@ -23,7 +23,7 @@
    Nezha Server Monitoring

    English

    简体中文

    English

    简体中文

    Appearance

    Nezha Monitoring

    Open-source, lightweight, and easy-to-use server monitoring and operation tool

    Preview
    Get Started →

    One-Click Installation

    Supports one-click installation of the Dashboard and Agent services, making it easy to operate. Compatible with mainstream systems, including Linux, Windows, macOS, OpenWRT, and Synology.

    Real-Time Monitoring

    Supports monitoring the status of multiple servers simultaneously, providing historical network status and latency charts, monitoring webpage and port availability, and SSL certificate status. Supports alerts for status such as faults and traffic, with notifications via Telegram, email, Slack, and more.

    Easy Operations

    Provides an API to get server status, supports WebSSH, DDNS, and traffic monitoring. Allows setting up scheduled and triggered tasks and executing server tasks in batches.

    - + \ No newline at end of file diff --git a/guide/agent.html b/guide/agent.html index 4eed07bc..5ef3ab02 100644 --- a/guide/agent.html +++ b/guide/agent.html @@ -12,7 +12,7 @@ - + @@ -22,68 +22,11 @@ -
    哪吒服务器监控

    简体中文

    English

    简体中文

    English

    Appearance

    安装 Agent ​

    哪吒监控的被控端服务被称为 Agent，本文档将介绍如何在被控端服务器上安装 Agent，并与 Dashboard 连接。

    TIP

    Agent 二进制文件仓库地址为：https://github.com/nezhahq/agent/releases

    一键安装 Agent ​

    哪吒监控支持在 Windows 和 Linux 上一键安装 Agent。遵循本文档的步骤，你可以很轻松地在服务器上部署它。

    准备工作 ​

    你需要提前在管理面板中设置好通信域名，此域名不可以接入 CDN。本文档以示例通信域名 “data.example.com” 为例。
    进入后台管理面板，转到“设置”页，在“未接入 CDN 的面板服务器域名/IP”项中填入通信域名，然后点击"保存"。

    在 Linux 中一键安装 (Ubuntu、Debian、CentOS) ​

    1. 首先在管理面板中添加一台服务器。
    2. 点击新添加的服务器旁的绿色 Linux 图标按钮，复制一键安装命令。
    3. 在被控端服务器中运行复制的一键安装命令，等待安装完成后返回到 Dashboard 主页查看服务器是否上线。

    在 Windows 中一键安装 ​

    1. 首先在管理面板中添加一台服务器。
    2. 点击新添加的服务器旁的绿色 Windows 图标按钮，复制一键安装命令。
    3. 进入 Windows 服务器，运行 PowerShell，在 PowerShell 中运行复制的安装命令。
    4. 如遇到确认「执行策略变更」请选择 Y。
    5. 等待安装完成后返回 Dashboard 主页查看服务器是否上线。

    WARNING

    如果在 PowerShell 中运行一键安装命令时遇到错误，请尝试下方的在 Windows 中手动安装 Agent。

    其他方式安装 Agent ​

    在 Linux 中安装 Agent (Ubuntu、Debian、CentOS) ​

    点击展开/收起
    1. 首先在管理面板中添加一台服务器。
    2. 在被控服务器中，运行脚本（位于中国大陆的服务器请使用镜像）：
    bash
    curl -L https://raw.githubusercontent.com/naiba/nezha/master/script/install.sh -o nezha.sh && chmod +x nezha.sh && sudo ./nezha.sh

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

    bash
    curl -L https://gitee.com/naibahq/nezha/raw/master/script/install.sh -o nezha.sh && chmod +x nezha.sh && sudo CN=true ./nezha.sh
    1. 选择“安装监控 Agent”。
    2. 输入通信域名，如：”data.example.com“。
    3. 输入面板通信端口（gRPC 端口），默认为 5555。
    4. 输入 Agent 密钥，Agent 密钥在管理面板中添加服务器时生成，可以在管理面板中的“服务器”页中找到。
    5. 等待安装完成后返回 Dashboard 主页查看服务器是否上线。

    在其他 Linux 发行版（如 Alpine 使用 Openrc）中安装 Agent ​

    点击展开/收起

    本节内容由 unknown0054 贡献。

    1. 修改 SERVER、SECRET、TLS，然后在 shell 中执行：
    shell
    cat >/etc/init.d/nezha-agent<< EOF
-#!/sbin/openrc-run
-SERVER="" # Dashboard 地址 ip:port
-SECRET="" # SECRET
-TLS="" # 是否启用 TLS，是 "--tls" ，否留空
-NZ_BASE_PATH="/opt/nezha"
-NZ_AGENT_PATH="${NZ_BASE_PATH}/agent"
-pidfile="/run/${RC_SVCNAME}.pid"
-command="/opt/nezha/agent/nezha-agent"
-command_args="-s ${SERVER} -p ${SECRET} ${TLS}"
-command_background=true
-depend() {
-  need net
-}
-checkconfig() {
-  GITHUB_URL="github.com"
-  if [ ! -f "${NZ_AGENT_PATH}/nezha-agent" ]; then
-    if [[ $(uname -m | grep 'x86_64') != "" ]]; then
-      os_arch="amd64"
-    elif [[ $(uname -m | grep 'i386\|i686') != "" ]]; then
-      os_arch="386"
-    elif [[ $(uname -m | grep 'aarch64\|armv8b\|armv8l') != "" ]]; then
-      os_arch="arm64"
-    elif [[ $(uname -m | grep 'arm') != "" ]]; then
-      os_arch="arm"
-    elif [[ $(uname -m | grep 's390x') != "" ]]; then
-      os_arch="s390x"
-    elif [[ $(uname -m | grep 'riscv64') != "" ]]; then
-      os_arch="riscv64"
-    fi
-    local version=$(curl -m 10 -sL "https://api.github.com/repos/nezhahq/agent/releases/latest" | grep "tag_name" | head -n 1 | awk -F ":" '{print $2}' | sed 's/\"//g;s/,//g;s/ //g')
-    if [ ! -n "$version" ]; then
-      version=$(curl -m 10 -sL "https://fastly.jsdelivr.net/gh/nezhahq/agent/" | grep "option\.value" | awk -F "'" '{print $2}' | sed 's/nezhahq\/agent@/v/g')
-    fi
-    if [ ! -n "$version" ]; then
-      version=$(curl -m 10 -sL "https://gcore.jsdelivr.net/gh/nezhahq/agent/" | grep "option\.value" | awk -F "'" '{print $2}' | sed 's/nezhahq\/agent@/v/g')
-    fi
-    if [ ! -n "$version" ]; then
-      echo -e "获取版本号失败，请检查本机能否链接 https://api.github.com/repos/nezhahq/agent/releases/latest"
-      return 0
-    else
-      echo -e "当前最新版本为: ${version}"
-    fi
-    wget -t 2 -T 10 -O nezha-agent_linux_${os_arch}.zip https://${GITHUB_URL}/nezhahq/agent/releases/download/${version}/nezha-agent_linux_${os_arch}.zip >/dev/null 2>&1
-    if [[ $? != 0 ]]; then
-      echo -e "Release 下载失败，请检查本机能否连接 ${GITHUB_URL}${plain}"
-      return 0
-    fi
-    mkdir -p $NZ_AGENT_PATH
-    chmod 755 -R $NZ_AGENT_PATH
-    unzip -qo nezha-agent_linux_${os_arch}.zip && mv nezha-agent $NZ_AGENT_PATH && rm -rf nezha-agent_linux_${os_arch}.zip README.md
-  fi
-  if [ ! -x "${NZ_AGENT_PATH}/nezha-agent" ]; then
-    chmod +x ${NZ_AGENT_PATH}/nezha-agent
-  fi
-}
-start_pre() {
-  if [ "${RC_CMD}" != "restart" ]; then
-    checkconfig || return $?
-  fi
-}
-EOF
    1. 增加运行权限
    shell
    chmod +x /etc/init.d/nezha-agent
    1. 运行 Nezha-Agent
    shell
    rc-service nezha-agent start
    1. 添加开机自启动
    shell
    rc-update add nezha-agent

    在 Windows 中手动安装 Agent ​

    在群晖 DSM 中安装 Agent ​

    点击展开/收起
    sh
    # Agent 路径
+    
    哪吒服务器监控
    简体中文
    English
    简体中文
    English
    Appearance
    安装 Agent ​
    哪吒监控的被控端服务被称为 Agent，本文档将介绍如何在被控端服务器上安装 Agent，并与 Dashboard 连接。
    TIP
    Agent 二进制文件仓库地址为：https://github.com/nezhahq/agent/releases
    一键安装 Agent ​
    哪吒监控支持在 Windows 和 Linux 上一键安装 Agent。遵循本文档的步骤，你可以很轻松地在服务器上部署它。
    准备工作 ​
    你需要提前在管理面板中设置好通信域名，此域名不可以接入 CDN。本文档以示例通信域名 “data.example.com” 为例。
     进入后台管理面板，转到“设置”页，在“未接入 CDN 的面板服务器域名/IP”项中填入通信域名，然后点击"保存"。
    在 Linux 中一键安装 ​
    1. 首先在管理面板中添加一台服务器。
    2. 点击新添加的服务器旁的绿色 Linux 图标按钮，复制一键安装命令。
    3. 在被控端服务器中运行复制的一键安装命令，等待安装完成后返回到 Dashboard 主页查看服务器是否上线。
    在 macOS 中一键安装 ​
    1. 首先在管理面板中添加一台服务器。
    2. 点击新添加的服务器旁的绿色 Apple 图标按钮，复制一键安装命令。
    3. 在被控端服务器中运行复制的一键安装命令，等待安装完成后返回到 Dashboard 主页查看服务器是否上线。
    在 Windows 中一键安装 ​
    1. 首先在管理面板中添加一台服务器。
    2. 点击新添加的服务器旁的绿色 Windows 图标按钮，复制一键安装命令。
    3. 进入 Windows 服务器，运行 PowerShell，在 PowerShell 中运行复制的安装命令。
    4. 如遇到确认「执行策略变更」请选择 Y。
    5. 等待安装完成后返回 Dashboard 主页查看服务器是否上线。
    WARNING
    如果在 PowerShell 中运行一键安装命令时遇到错误，请尝试下方的在 Windows 中手动安装 Agent。
    其他方式安装 Agent ​
    在 Linux 中安装 Agent（支持大部分发行版） ​
    点击展开/收起
    1. 首先在管理面板中添加一台服务器。
    2. 在被控服务器中，运行脚本（位于中国大陆的服务器请使用镜像）：
    bash
    curl -L https://raw.githubusercontent.com/naiba/nezha/master/script/install.sh -o nezha.sh && chmod +x nezha.sh && sudo ./nezha.sh
    如果你的被控服务器位于中国大陆，可以使用镜像：
    bash
    curl -L https://gitee.com/naibahq/nezha/raw/master/script/install.sh -o nezha.sh && chmod +x nezha.sh && sudo CN=true ./nezha.sh
    1. 选择“安装监控 Agent”。
    2. 输入通信域名，如：”data.example.com“。
    3. 输入面板通信端口（gRPC 端口），默认为 5555。
    4. 输入 Agent 密钥，Agent 密钥在管理面板中添加服务器时生成，可以在管理面板中的“服务器”页中找到。
    5. 等待安装完成后返回 Dashboard 主页查看服务器是否上线。
    使用 Agent 内置服务命令安装（支持主流系统） ​
    点击展开/收起
    首先获取 Agent 的二进制文件：https://github.com/nezhahq/agent/releases
    解压后输入以下命令安装服务（可能需要 root 权限）：
    bash
    ./nezha-agent service install -s server_name:port -p password
    除了服务器地址和密码，还可以添加其它支持的参数。具体参考自定义 Agent 监控项目
    卸载服务：
    bash
    ./nezha-agent service uninstall
    启动服务：
    bash
    ./nezha-agent service start
    停止服务：
    bash
    ./nezha-agent service stop
    重启服务：
    bash
    ./nezha-agent service restart
    runit 安装 Agent ​
    点击展开/收起
    目前 Agent 内置的服务功能已经支持了绝大部分 init 系统，包括 FreeBSD rc.d 和 openrc。尽管如此还是有一些漏网之鱼。
    这里使用 Void Linux 的 runit 作为示例：
    1. 创建 /etc/sv/nezha-agent 目录：
    bash
    mkdir /etc/sv/nezha-agent
    1. 创建 /etc/sv/nezha-agent/run 服务文件，写入以下内容：
    bash
    #!/bin/sh
+exec 2>&1
+exec /opt/nezha/agent/nezha-agent -s server_name:port -p password 2>&1
    这里同样可以添加其它参数。
    1. 创建 /etc/sv/nezha-agent/log/run：
    bash
    #!/bin/sh
+exec vlogger -t nezha-agent -p daemon
    1. 启用服务：
    bash
    sudo ln -s /etc/sv/nezha-agent/ /var/service
    之后可以通过 sv 命令来操作服务。
    如何查看日志：
    1. 安装 socklog，并启用：
    bash
    sudo xbps-install -S socklog-void
+sudo ln -s /etc/sv/socklog-unix /var/service
    1. 运行 svlogtail 查看日志：
    bash
    sudo svlogtail | grep nezha-agent
    在 Windows 中手动安装 Agent ​
    在群晖 DSM 中安装 Agent ​
    点击展开/收起
    sh
    # Agent 路径
 EXEC="/PATH/TO/nezha-agent"
 # 日志路径地址
 LOG="${EXEC}.log"
@@ -120,28 +63,7 @@
 # 启动服务
 systemctl start nezha
 # 服务自启动
-systemctl enable nezha
    ‼️修改对应信息后‼️
     使用 root 账号执行上述命令即可安装完成。
    在 macOS 中安装 Agent ​
    点击展开/收起
    本节内容改编自 Mitsea Blog，改编已获得原作者授权
    WARNING
    安装过程中如提示“macOS 无法验证此 app“，请前往系统设置手动允许程序运行。
    1. 首先在管理面板中添加一台服务器。
    2. 前往 Release 页下载 Agent 二进制文件，根据 CPU 架构选择下载 darwin amd64 还是 arm64 的 Agent。
       如 Intel CPU 下载 amd64，Apple Silicon 下载 arm64 版本。下载完成后解压 Agent 二进制文件，如解压到下载文件夹。
    3. 新建一个名为 nezha_agent.plist 的文件并保存，修改文件内容如下：
    xml
    <?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
-<plist version="1.0">
-<dict>
- <key>KeepAlive</key>
- <true/>
- <key>Label</key>
- <string>nezha_agent</string>
- <key>Program</key>
- <string>在这里修改 Agent 二进制文件的的路径，如：/Users/123/Downloads/nezha-agent</string>
- <key>ProgramArguments</key>
- <array>
-  <string>在这里修改 Agent 二进制文件的的路径，同上</string>
-  <string>--password</string>
-  <string>通信密钥，如：529664783eeb23cc25</string>
-  <string>--server</string>
-  <string>通信网址和 gRPC 端口，如:data.example.com:5555</string>
- </array>
- <key>RunAtLoad</key>
- <true/>
-</dict>
-</plist>
    1. 在 Terminal 中使用下面的命令加载 plist 文件到 launchd 里，注意替换文件路径：
    shell
    launchctl load /Users/123/Desktop/nezha_agent.plist
    1. 启动进程：
    shell
    launchctl start nezha_agent
    1. 检查进程是否运行：
    shell
    launchctl list | grep nezha_agent
    1. 停止进程并移除：
    shell
    launchctl stop nezha_agent
    shell
    launchctl remove nezha_agent
    在 macOS 中使用 Homebrew 安装 Agent ​
    点击展开/收起
    本节内容改编自 🐿️松鼠收集🌰，改编已获得原作者授权
    WARNING
    请务必先添加环境变量，再通过 Homebrew 安装 nezha-agent！ 因 Homebrew 在软件安装时创建服务所需 plist 文件，若先安装再添加环境变量，会因缺少参数而启动失败。
    1. 添加环境变量：
    shell
    echo 'export HOMEBREW_NEZHA_AGENT_PASSWORD="通信密钥，在服务页面获取"' >> ~/.zshrc
+systemctl enable nezha
    ‼️修改对应信息后‼️
     使用 root 账号执行上述命令即可安装完成。
    在 macOS 中使用 Homebrew 安装 Agent ​
    点击展开/收起
    本节内容改编自 🐿️松鼠收集🌰，改编已获得原作者授权
    WARNING
    请务必先添加环境变量，再通过 Homebrew 安装 nezha-agent！ 因 Homebrew 在软件安装时创建服务所需 plist 文件，若先安装再添加环境变量，会因缺少参数而启动失败。
    1. 添加环境变量：
    shell
    echo 'export HOMEBREW_NEZHA_AGENT_PASSWORD="通信密钥，在服务页面获取"' >> ~/.zshrc
 echo 'export HOMEBREW_NEZHA_AGENT_SERVER="你的服务器和端口，格式 your.domain:5555 "' >> ~/.zshrc
 source ~/.zshrc
    1. 安装 Nezha Agent：
    DANGER
    请注意，此 Homebrew 仓库由第三方维护，与哪吒监控无关。 Nezha 项目组不对该仓库的可用性和安全性等方面作出背书。在使用前，请自行评估风险！
    由于暂未提交到 Homebrew Core 官方库，暂时放在上述博客作者参与维护的 第三方 Homebrew 仓库 中：
    shell
    brew install brewforge/chinese/nezha-agent
    1. 通过 Homebrew 启动 Nezha Agent 服务：
    shell
    brew services start nezha-agent
    1. 检查服务状态：
    shell
    brew services info nezha-agent
    1. 停止服务：
    shell
    brew services stop nezha-agent
    1. 卸载 Nezha Agent：
    shell
    brew rm nezha-agent
    1. 报错时先检查环境变量：
    shell
    echo $HOMEBREW_NEZHA_AGENT_PASSWORD
 echo $HOMEBREW_NEZHA_AGENT_SERVER
    1. 若环境变量配置正确，再尝试重装：
    shell
    brew services stop nezha-agent
@@ -166,8 +88,8 @@
  stop
  sleep 2
  start
-}
    • 运行 chmod +x /etc/init.d/nezha-service 赋予执行权限。
    • 启动服务： /etc/init.d/nezha-service enable && /etc/init.d/nezha-service start
    Agent 有 Docker 镜像吗？ ​
    Agent 目前没有推出 Docker 镜像。
     Agent 的设计思路和 Dashboard 相反，Dashboard 要尽可能不影响宿主机工作，但 Agent 则需要在宿主机中执行监控服务和运行命令。
     将 Agent 放入容器中确实可以继续执行监控任务，但 WebShell 等功能无法正常运行，因此不提供 Docker 镜像。
    
-    
+}

    Agent 有 Docker 镜像吗？ ​

    Agent 目前没有推出 Docker 镜像。
    Agent 的设计思路和 Dashboard 相反，Dashboard 要尽可能不影响宿主机工作，但 Agent 则需要在宿主机中执行监控服务和运行命令。
    将 Agent 放入容器中确实可以继续执行监控任务，但 WebShell 等功能无法正常运行，因此不提供 Docker 镜像。

    + \ No newline at end of file diff --git a/guide/agentq.html b/guide/agentq.html index a77e6ee9..97f8b354 100644 --- a/guide/agentq.html +++ b/guide/agentq.html @@ -12,7 +12,7 @@ - + @@ -22,8 +22,8 @@ -
    哪吒服务器监控

    简体中文

    English

    简体中文

    English

    Appearance

    Agent 常见问题 ​

    后台显示的 IP 和 Agent 实际 IP 不一致？ ​

    请查看 Dashboard 相关-为什么管理面板中显示的 IP 和 Agent 实际 IP 不一致？。在此不再赘述。

    一键脚本安装时出错 ​

    curl: Failed to connect to raw.githubusercontent.com...... ​

    多出现在中国大陆的服务器中，目前一键脚本只从 Github 直接获取安装脚本，您可以多尝试几次，或者手动安装 Agent。另外，也可以自行寻找第三方 Github 加速服务或者镜像，并在一键安装脚本中设置。

    sudo: command not found ​

    请先手动安装 sudo，例如在 Ubuntu 中：

    shell
    apt install sudo
    - +
    哪吒服务器监控

    简体中文

    English

    简体中文

    English

    Appearance

    Agent 常见问题 ​

    后台显示的 IP 和 Agent 实际 IP 不一致？ ​

    请查看 Dashboard 相关-为什么管理面板中显示的 IP 和 Agent 实际 IP 不一致？。在此不再赘述。

    一键脚本安装时出错 ​

    curl: Failed to connect to raw.githubusercontent.com...... ​

    多出现在中国大陆的服务器中，目前一键脚本只从 Github 直接获取安装脚本，您可以多尝试几次，或者手动安装 Agent。另外，也可以自行寻找第三方 Github 加速服务或者镜像，并在一键安装脚本中设置。

    sudo: command not found ​

    请先手动安装 sudo，例如在 Ubuntu 中：

    shell
    apt install sudo
    + \ No newline at end of file diff --git a/guide/api.html b/guide/api.html index 26e9798d..d37ee5f9 100644 --- a/guide/api.html +++ b/guide/api.html @@ -12,7 +12,7 @@ - + @@ -159,8 +159,8 @@ print(f"Memory Used: {server['status']['MemUsed']} bytes") print(f"Disk Used: {server['status']['DiskUsed']} bytes") print(f"Network In Speed: {server['status']['NetInSpeed']} bytes/s") -print(f"Network Out Speed: {server['status']['NetOutSpeed']} bytes/s")

    通过以上示例代码，可以轻松获取和处理服务器的状态信息，从而实现自动化监控和管理。

     - +print(f"Network Out Speed: {server['status']['NetOutSpeed']} bytes/s")

    通过以上示例代码，可以轻松获取和处理服务器的状态信息，从而实现自动化监控和管理。

     + \ No newline at end of file diff --git a/guide/dashboard.html b/guide/dashboard.html index 64443161..454e9be9 100644 --- a/guide/dashboard.html +++ b/guide/dashboard.html @@ -12,7 +12,7 @@ - + @@ -42,8 +42,8 @@ proxy /terminal/* http://ip:8008 { websocket header_upstream -Origin -}

    在宝塔面板中配置 SSL ​

    首先，先暂时关闭反向代理。
    正如在其他网站中配置 SSL 证书一样，进入站点设置中的 “SSL”，你可以选择自动申请 Let´s Encrypt 证书或手动配置已有的证书。
    完成 SSL 的设置后，你需要回到 https://github.com/settings/developers ，编辑之前创建的验证应用程序，将之前我们填入的 "Homepage URL" 和 "Authorization callback URL" 中的域名全部从 http 改为 https，如："https://dashboard.example.com" 和 "https://dashboard.example.com/oauth2/callback" ，不更改此项可能会导致你无法登录面板后台。

    更新 Dashboard ​

    运行脚本 ./nezha.sh ，选择重启面板并更新。

    - +}

    在宝塔面板中配置 SSL ​

    首先，先暂时关闭反向代理。
    正如在其他网站中配置 SSL 证书一样，进入站点设置中的 “SSL”，你可以选择自动申请 Let´s Encrypt 证书或手动配置已有的证书。
    完成 SSL 的设置后，你需要回到 https://github.com/settings/developers ，编辑之前创建的验证应用程序，将之前我们填入的 "Homepage URL" 和 "Authorization callback URL" 中的域名全部从 http 改为 https，如："https://dashboard.example.com" 和 "https://dashboard.example.com/oauth2/callback" ，不更改此项可能会导致你无法登录面板后台。

    更新 Dashboard ​

    运行脚本 ./nezha.sh ，选择重启面板并更新。

    + \ No newline at end of file diff --git a/guide/dashboardq.html b/guide/dashboardq.html index 0e830965..c6273cc4 100644 --- a/guide/dashboardq.html +++ b/guide/dashboardq.html @@ -12,7 +12,7 @@ - + @@ -31,8 +31,8 @@ expires 12h; error_log /dev/null; access_log /dev/null; - }

  • 保存配置，并清空浏览器、Nginx、CDN 中的缓存，此时刷新页面应恢复正常。

    • 面板无法启动：panic: 无法找到配置的 DDNS 提供者... ​

    填入的 DDNS provider 的值有误，目前仅支持 webhook、cloudflare、tencentcloud 和 dummy。

    面板更新 DDNS 崩溃：panic: interface conversion: interface {} is nil, not []interface {} ​

    填入的 DDNS AccessID 或 AccessSecret 有误。

    打开网络监控页显示：server monitor history not found ​

    出现此错误说明没有在服务页中设置 TCP-Ping 和 ICMP-Ping 类型的监控或者监控数据还未生成。
    如已经设置完毕，可以等待一段时间后再查看。

    启用 HTTPS 后 /terminal 或 /ws 不能正常连接 ​

    常常是由于证书不完整造成的，请在 agent 运行参数中添加 -d，若 log 中有 x509:certificate signed by unknown authority，更换完整证书则可解决该问题。

    对面板提供的数据修改/增加功能不满意，想要修改/增加数据 ​

    常见于批量新建 Agent 等需求中，可以直接修改数据库。
    请注意，数据库中并非什么都可以修改，错误的修改会导致数据混乱无法启动 Dashboard，请勿随意修改数据库！

    DANGER

    再重复一遍，请勿随意修改数据库！

    如需要在数据库中修改数据，请先停止面板容器再修改。
    数据库类型是 sqlite3，位于 /opt/nezha/dashboard/data/sqlite.db，修改前请备份。

    Dashboard 会自动更新吗？ ​

    Agent 通常情况下会自动更新，但 Dashboard 并不会，需要手动更新。

    - + }

  • 保存配置，并清空浏览器、Nginx、CDN 中的缓存，此时刷新页面应恢复正常。

    • 面板无法启动：panic: 无法找到配置的 DDNS 提供者... ​

    填入的 DDNS provider 的值有误，目前仅支持 webhook、cloudflare、tencentcloud 和 dummy。

    面板更新 DDNS 崩溃：panic: interface conversion: interface {} is nil, not []interface {} ​

    填入的 DDNS AccessID 或 AccessSecret 有误。

    打开网络监控页显示：server monitor history not found ​

    出现此错误说明没有在服务页中设置 TCP-Ping 和 ICMP-Ping 类型的监控或者监控数据还未生成。
    如已经设置完毕，可以等待一段时间后再查看。

    启用 HTTPS 后 /terminal 或 /ws 不能正常连接 ​

    常常是由于证书不完整造成的，请在 agent 运行参数中添加 -d，若 log 中有 x509:certificate signed by unknown authority，更换完整证书则可解决该问题。

    对面板提供的数据修改/增加功能不满意，想要修改/增加数据 ​

    常见于批量新建 Agent 等需求中，可以直接修改数据库。
    请注意，数据库中并非什么都可以修改，错误的修改会导致数据混乱无法启动 Dashboard，请勿随意修改数据库！

    DANGER

    再重复一遍，请勿随意修改数据库！

    如需要在数据库中修改数据，请先停止面板容器再修改。
    数据库类型是 sqlite3，位于 /opt/nezha/dashboard/data/sqlite.db，修改前请备份。

    Dashboard 会自动更新吗？ ​

    Agent 通常情况下会自动更新，但 Dashboard 并不会，需要手动更新。

    + \ No newline at end of file diff --git a/guide/loginq.html b/guide/loginq.html index 3e7f1a73..a136f60c 100644 --- a/guide/loginq.html +++ b/guide/loginq.html @@ -12,7 +12,7 @@ - + @@ -22,8 +22,8 @@ -
    哪吒服务器监控

    简体中文

    English

    简体中文

    English

    Appearance

    登录常见问题 ​

    登录回调后页面卡住\拒绝连接\响应时间过长 ​

    还有其他一些表现形式，总之登录后浏览器无法正常显示。

    1. 您的服务器无法连接到 Github/Gitee，最常见于国内服务器配置 Github 情况下，可以考虑多尝试几次或者切换到 Cloudflare Access。
    2. 您配置错了回调地址，确保您的回调地址正确且端口与协议均正确！
    3. Dashboard 发生未知错误，您可以使用脚本查看日志。

    TIP

    什么是协议？ 在浏览器中，您的域名以 :// 结尾的字符串即为协议，通常为 http 和 https 两种。由于正常部署情况下面板可能有多种协议+域名+端口组合均可访问，请务必选一个最合适的作为回调。

    如何检查我的回调地址是否错误？ ​

    请确保登录前浏览器显示的协议+域名+端口和登录后跳转到的协议+域名+端口一致。
    请确保您的路径为 /oauth2/callback，全部小写。

    登录后面板报错 ​

    1. 清理 cookies 后重新登录，或换个浏览器。
    2. 检查回调地址，确保您的回调地址正确且端口与协议均正确！发起请求的地址需要和回调地址处于同域，端口、协议和域名(或IP)都需要一致。

    lookup xxx ​

    容器 DNS 解析失败，多数情况下为修改了 iptables 相关配置。
    建议先重启 docker，sudo systemctl restart docker，再使用脚本重启面板。
    仍然出现 lookup 错误建议查看是否有其他控制 iptables 的工具，如宝塔防火墙等。
    这个问题也可能与内核有关系，请尝试更换官方内核。

    授权方式无效，或者登录回调地址无效、过期或已被撤销 ​

    只出现在 Gitee 登录方式中，原因不明，建议更换到 GitHub。

    oauth2: server response missing access_token ​

    可能由多种因素引起，最大可能性是网络问题，建议检查网络后重试。
    无法解决的话建议更换 Github 等。

    该用户不是本站点管理员，无法登录 ​

    您登陆错了账号或者配置错了用户名，注意用户名不是邮箱，可使用脚本修改。
    Cloudflare Access 用户请注意，您的用户名不是邮箱，而是 User ID。

    dial tcp xxx:443 i/o timeout ​

    网络问题，可先重启 Docker，sudo systemctl restart docker，再使用脚本重启面板。
    如为国内服务器配置 Github 登陆方式，则建议切换到 Cloudflare Access 以避免网络干扰。

    net/http: TLS handshake timeout ​

    同上。

    使用 Cloudflare Access 作为 OAuth2 提供方时无法收到邮件验证码 ​

    • 确认在 Policies 中已正确配置了邮件验证策略。
    • 检查您提供的邮箱地址是否正确无误。注意，不在策略白名单中的邮箱地址将不会接收到验证码。
    - +
    哪吒服务器监控

    简体中文

    English

    简体中文

    English

    Appearance

    登录常见问题 ​

    登录回调后页面卡住\拒绝连接\响应时间过长 ​

    还有其他一些表现形式，总之登录后浏览器无法正常显示。

    1. 您的服务器无法连接到 Github/Gitee，最常见于国内服务器配置 Github 情况下，可以考虑多尝试几次或者切换到 Cloudflare Access。
    2. 您配置错了回调地址，确保您的回调地址正确且端口与协议均正确！
    3. Dashboard 发生未知错误，您可以使用脚本查看日志。

    TIP

    什么是协议？ 在浏览器中，您的域名以 :// 结尾的字符串即为协议，通常为 http 和 https 两种。由于正常部署情况下面板可能有多种协议+域名+端口组合均可访问，请务必选一个最合适的作为回调。

    如何检查我的回调地址是否错误？ ​

    请确保登录前浏览器显示的协议+域名+端口和登录后跳转到的协议+域名+端口一致。
    请确保您的路径为 /oauth2/callback，全部小写。

    登录后面板报错 ​

    1. 清理 cookies 后重新登录，或换个浏览器。
    2. 检查回调地址，确保您的回调地址正确且端口与协议均正确！发起请求的地址需要和回调地址处于同域，端口、协议和域名(或IP)都需要一致。

    lookup xxx ​

    容器 DNS 解析失败，多数情况下为修改了 iptables 相关配置。
    建议先重启 docker，sudo systemctl restart docker，再使用脚本重启面板。
    仍然出现 lookup 错误建议查看是否有其他控制 iptables 的工具，如宝塔防火墙等。
    这个问题也可能与内核有关系，请尝试更换官方内核。

    授权方式无效，或者登录回调地址无效、过期或已被撤销 ​

    只出现在 Gitee 登录方式中，原因不明，建议更换到 GitHub。

    oauth2: server response missing access_token ​

    可能由多种因素引起，最大可能性是网络问题，建议检查网络后重试。
    无法解决的话建议更换 Github 等。

    该用户不是本站点管理员，无法登录 ​

    您登陆错了账号或者配置错了用户名，注意用户名不是邮箱，可使用脚本修改。
    Cloudflare Access 用户请注意，您的用户名不是邮箱，而是 User ID。

    dial tcp xxx:443 i/o timeout ​

    网络问题，可先重启 Docker，sudo systemctl restart docker，再使用脚本重启面板。
    如为国内服务器配置 Github 登陆方式，则建议切换到 Cloudflare Access 以避免网络干扰。

    net/http: TLS handshake timeout ​

    同上。

    使用 Cloudflare Access 作为 OAuth2 提供方时无法收到邮件验证码 ​

    • 确认在 Policies 中已正确配置了邮件验证策略。
    • 检查您提供的邮箱地址是否正确无误。注意，不在策略白名单中的邮箱地址将不会接收到验证码。
    + \ No newline at end of file diff --git a/guide/notifications.html b/guide/notifications.html index 6f01eeed..d9fd5b3f 100644 --- a/guide/notifications.html +++ b/guide/notifications.html @@ -12,7 +12,7 @@ - + @@ -49,8 +49,8 @@ "markdown": { "content": "# 哪吒通知消息\n\n\"#NEZHA#\"\n\n> 名称: \"#SERVER.NAME#\"\n> IP: \"#SERVER.IP#\"\n> IPv4: \"#SERVER.IPV4#\"\n> IPv6: \"#SERVER.IPV6#\"\n> CPU: \"#SERVER.CPU#\"\n> 内存: \"#SERVER.MEM#\"\n> 交换分区: \"#SERVER.SWAP#\"\n> 存储: \"#SERVER.DISK#\"\n> 实时上传速度: \"#SERVER.NETINSPEED#\"\n> 实时下载速度: \"#SERVER.NETOUTSPEED#\"\n> 总上传: \"#SERVER.TRANSFERIN#\"\n> 总下载: \"#SERVER.TRANSFEROUT#\"\n> 1分钟内负载: \"#SERVER.LOAD1#\"\n> 5分钟内负载: \"#SERVER.LOAD5#\"\n> 15分钟内负载: \"#SERVER.LOAD15#\"\n> TCP连接数: \"#SERVER.TCPCONNCOUNT\"\n> UDP连接数: \"#SERVER.UDPCONNCOUNT\"\n\n" } -}

    根据需求删减相关内容信息即可。

    通知效果

    飞书群机器人配置 示例 贡献者：@eya46 ​

    点击展开/收起

    URL 参数获取说明 ​

    机器人 URL 通过飞书群 - 群机器人 - 添加机器人 - 自定义机器人(webhook)创建后获取。

    告警规则说明 ​

    基本规则 ​

    完整示例:

    添加一个离线告警：

    添加一个监控 CPU 持续 10 秒超过 50% 且 内存持续 20 秒占用低于 20% 的告警：

    将特定的服务器通知发送到特定的通知分组：

    示例场景：
    有 1、2、3、4 四台服务器和 A、B 两个不同的通知组。
    1、2 这两台服务器掉线十分钟后给通知组 A 发送通知。
    3、4 这两台服务器掉线十分钟后给通知组 B 发送通知。

    首先你需要先设置好 A、B 两个通知组，然后添加两条告警规则：

    规则一：

    规则二：

    灵活使用参数可以让你的告警功能被充分使用

    特殊：任意周期流量告警 ​

    可以用作月流量监控

    示例:

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

    json
    [{"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}}]

    通知触发模式 ​

    设置告警时执行任务 ​

    如果需要在发出告警消息的同时执行某项任务，可以设置此项目。

    - +}

    根据需求删减相关内容信息即可。

    通知效果

    飞书群机器人配置 示例 贡献者：@eya46 ​

    点击展开/收起

    URL 参数获取说明 ​

    机器人 URL 通过飞书群 - 群机器人 - 添加机器人 - 自定义机器人(webhook)创建后获取。

    告警规则说明 ​

    基本规则 ​

    完整示例:

    添加一个离线告警：

    添加一个监控 CPU 持续 10 秒超过 50% 且 内存持续 20 秒占用低于 20% 的告警：

    将特定的服务器通知发送到特定的通知分组：

    示例场景：
    有 1、2、3、4 四台服务器和 A、B 两个不同的通知组。
    1、2 这两台服务器掉线十分钟后给通知组 A 发送通知。
    3、4 这两台服务器掉线十分钟后给通知组 B 发送通知。

    首先你需要先设置好 A、B 两个通知组，然后添加两条告警规则：

    规则一：

    规则二：

    灵活使用参数可以让你的告警功能被充分使用

    特殊：任意周期流量告警 ​

    可以用作月流量监控

    示例:

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

    json
    [{"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}}]

    通知触发模式 ​

    设置告警时执行任务 ​

    如果需要在发出告警消息的同时执行某项任务，可以设置此项目。

    + \ No newline at end of file diff --git a/guide/q1.html b/guide/q1.html index 121553d4..50bc4db7 100644 --- a/guide/q1.html +++ b/guide/q1.html @@ -12,7 +12,7 @@ - + @@ -67,8 +67,8 @@ # CentOS iptables -I INPUT -p tcp --dport 443 -j DROP -iptables -I INPUT -s <serverIp> -p tcp --dport 443 -j ACCEPT

    通过以上配置，可以有效防止未经授权的访问。

     - +iptables -I INPUT -s <serverIp> -p tcp --dport 443 -j ACCEPT

    通过以上配置，可以有效防止未经授权的访问。

     + \ No newline at end of file diff --git a/guide/q2.html b/guide/q2.html index 02132cc7..dfcad90a 100644 --- a/guide/q2.html +++ b/guide/q2.html @@ -12,7 +12,7 @@ - + @@ -22,8 +22,8 @@ -
    哪吒服务器监控

    简体中文

    English

    简体中文

    English

    Appearance

    Agent 启动/上线 问题自检流程 ​

    1. 直接执行 /opt/nezha/agent/nezha-agent -s 面板IP或非CDN域名:面板RPC端口 -p Agent密钥 -d 查看日志是否是因为 DNS、网络不佳导致超时（timeout）
    2. nc -v 域名/IP 面板RPC端口 或者 telnet 域名/IP 面板RPC端口 来检验是否是网络问题，检查本机与面板服务器的出入站防火墙，如果无法判断问题可借助 https://port.ping.pe/ 提供的端口检查工具进行检测。
    3. 如果上面步骤检测正常，Agent 依然没有正常上线，请尝试关闭 SELinux，如何关闭 SELinux？
    - +
    哪吒服务器监控

    简体中文

    English

    简体中文

    English

    Appearance

    Agent 启动/上线 问题自检流程 ​

    1. 直接执行 /opt/nezha/agent/nezha-agent -s 面板IP或非CDN域名:面板RPC端口 -p Agent密钥 -d 查看日志是否是因为 DNS、网络不佳导致超时（timeout）
    2. nc -v 域名/IP 面板RPC端口 或者 telnet 域名/IP 面板RPC端口 来检验是否是网络问题，检查本机与面板服务器的出入站防火墙，如果无法判断问题可借助 https://port.ping.pe/ 提供的端口检查工具进行检测。
    3. 如果上面步骤检测正常，Agent 依然没有正常上线，请尝试关闭 SELinux，如何关闭 SELinux？
    + \ No newline at end of file diff --git a/guide/q3.html b/guide/q3.html index d86be0c5..c3fe4ff2 100644 --- a/guide/q3.html +++ b/guide/q3.html @@ -12,7 +12,7 @@ - + @@ -95,8 +95,8 @@ localhost:~/agent# /opt/nezha/agent/nezha-agent -s nezha.xxx.xxx:443 -p YOUR_KEY --tls -d NEZHA@2023-12-20 05:14:00>> 检查更新： 0.15.14 NEZHA@2023-12-20 05:14:01>> 上报系统信息失败： rpc error: code = Unknown desc = EOF # 需要修改主控端 /opt/nezha/dashboard/data/config.yaml的 GRPCHost 和 TLS 选项 -NEZHA@2023-12-20 05:14:01>> Error to close connection ... - +NEZHA@2023-12-20 05:14:01>> Error to close connection ... + \ No newline at end of file diff --git a/guide/q4.html b/guide/q4.html index 3f238f7c..da141bc7 100644 --- a/guide/q4.html +++ b/guide/q4.html @@ -12,7 +12,7 @@ - + @@ -22,8 +22,8 @@ -
    哪吒服务器监控

    简体中文

    English

    简体中文

    English

    Appearance

    实时通道断开/在线终端连接失败 ​

    • 如果你使用了 CDN，请确认 CDN 服务商提供 WebSocket 服务，并且已开启 WebSocket。
    • 确认你的反代规则中针对 /ws, /terminal 路径的 WebSocket 进行了特别配置，你可以 点击这里 查看反向代理配置。
    - +
    哪吒服务器监控

    简体中文

    English

    简体中文

    English

    Appearance

    实时通道断开/在线终端连接失败 ​

    • 如果你使用了 CDN，请确认 CDN 服务商提供 WebSocket 服务，并且已开启 WebSocket。
    • 确认你的反代规则中针对 /ws, /terminal 路径的 WebSocket 进行了特别配置，你可以 点击这里 查看反向代理配置。
    + \ No newline at end of file diff --git a/guide/q5.html b/guide/q5.html index bd22c4b3..2a4743eb 100644 --- a/guide/q5.html +++ b/guide/q5.html @@ -12,7 +12,7 @@ - + @@ -22,8 +22,8 @@ -
    哪吒服务器监控

    简体中文

    English

    简体中文

    English

    Appearance

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

    1. 先运行一键脚本，选择 停止面板
    2. 在旧服务器中打包 /opt/nezha 文件夹，复制到新服务器相同位置解压
    3. 在新服务器中运行一键脚本，选择 启动面板
    - +
    哪吒服务器监控

    简体中文

    English

    简体中文

    English

    Appearance

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

    1. 先运行一键脚本，选择 停止面板
    2. 在旧服务器中打包 /opt/nezha 文件夹，复制到新服务器相同位置解压
    3. 在新服务器中运行一键脚本，选择 启动面板
    + \ No newline at end of file diff --git a/guide/q6.html b/guide/q6.html index fb43ca8b..537d639d 100644 --- a/guide/q6.html +++ b/guide/q6.html @@ -12,7 +12,7 @@ - + @@ -22,8 +22,8 @@ -
    哪吒服务器监控

    简体中文

    English

    简体中文

    English

    Appearance

    如何每月重置流量统计？ ​

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

    1. 进入管理面板的 告警 页
    2. 参考这篇文档，创建一个月流量告警
    3. 返回主页，在 服务 页中就可以看到月流量统计了，这里的统计数据不会因为服务器重启而重置

    TIP

    此方式可以设置任何周期，包括且不限于每小时/每天/每周/每月/每年重置流量统计，非常灵活！

    - +
    哪吒服务器监控

    简体中文

    English

    简体中文

    English

    Appearance

    如何每月重置流量统计？ ​

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

    1. 进入管理面板的 告警 页
    2. 参考这篇文档，创建一个月流量告警
    3. 返回主页，在 服务 页中就可以看到月流量统计了，这里的统计数据不会因为服务器重启而重置

    TIP

    此方式可以设置任何周期，包括且不限于每小时/每天/每周/每月/每年重置流量统计，非常灵活！

    + \ No newline at end of file diff --git a/guide/q7.html b/guide/q7.html index 9fd0c4e4..6f311824 100644 --- a/guide/q7.html +++ b/guide/q7.html @@ -12,7 +12,7 @@ - + @@ -22,8 +22,8 @@ -
    哪吒服务器监控

    简体中文

    English

    简体中文

    English

    Appearance

    自定义 Agent 监控项目 ​

    自定义监控的网卡和硬盘分区 ​

    执行以下命令来选择网卡和分区，然后重启 Agent 即可生效：

    bash
    /opt/nezha/agent/nezha-agent edit

    其他运行参数 ​

    查看支持的参数 ​

    要查看支持的运行参数，请执行以下命令：

    bash
    ./nezha-agent --help

    配置参数 ​

    如果您通过一键脚本安装了 Agent，可以通过编辑系统服务配置来添加或修改参数。编辑文件 /etc/systemd/system/nezha-agent.service，并在 ExecStart= 行的末尾添加您需要的参数：

    • --report-delay：设置系统信息上报的间隔时间。默认为 1 秒。为了降低系统资源占用，可以设置为 3（有效范围：1-4 秒）。
    • --skip-conn：不监控网络连接数。建议在连接数较多或 CPU 资源占用较高的服务器上使用此参数。
    • --skip-procs：不监控进程数，有助于降低 Agent 的资源占用。
    • --disable-auto-update：禁用 Agent 的自动更新功能，增强安全性。
    • --disable-force-update：禁用 Agent 的强制更新功能，增强安全性。
    • --disable-command-execute：禁止在 Agent 上执行任何定时任务或使用在线终端，增强安全性。
    • --tls：启用 SSL/TLS 加密。当您使用 nginx 反向代理 Agent 的 gRPC 连接且 nginx 配置了 SSL/TLS 时，应启用此配置。
    • --use-ipv6-countrycode：强制使用 IPv6 地址查询国家代码。默认情况下，Agent 使用 IPv4 地址查询国家代码，如果服务器支持 IPv6 且与 IPv4 地址的国家代码不同，可以使用此参数。
    • --gpu：启用 GPU 监控。注意：GPU 使用率监控可能需要安装额外的依赖包，详细信息可以参考文档：启用 GPU 监控。
    • --temperature：启用硬件温度监控。仅支持的硬件有效，部分 VPS 可能无法获取温度信息。
    • --debug：启用调试模式。
    - +
    哪吒服务器监控

    简体中文

    English

    简体中文

    English

    Appearance

    自定义 Agent 监控项目 ​

    自定义监控的网卡和硬盘分区 ​

    执行以下命令来选择网卡和分区，然后重启 Agent 即可生效：

    bash
    /opt/nezha/agent/nezha-agent edit

    其他运行参数 ​

    查看支持的参数 ​

    要查看支持的运行参数，请执行以下命令：

    bash
    ./nezha-agent --help

    配置参数 ​

    如果您通过一键脚本安装了 Agent，可以通过编辑系统服务配置来添加或修改参数。编辑文件 /etc/systemd/system/nezha-agent.service，并在 ExecStart= 行的末尾添加您需要的参数：

    • --report-delay：设置系统信息上报的间隔时间。默认为 1 秒。为了降低系统资源占用，可以设置为 3（有效范围：1-4 秒）。
    • --skip-conn：不监控网络连接数。建议在连接数较多或 CPU 资源占用较高的服务器上使用此参数。
    • --skip-procs：不监控进程数，有助于降低 Agent 的资源占用。
    • --disable-auto-update：禁用 Agent 的自动更新功能，增强安全性。
    • --disable-force-update：禁用 Agent 的强制更新功能，增强安全性。
    • --disable-command-execute：禁止在 Agent 上执行任何定时任务或使用在线终端，增强安全性。
    • --tls：启用 SSL/TLS 加密。当您使用 nginx 反向代理 Agent 的 gRPC 连接且 nginx 配置了 SSL/TLS 时，应启用此配置。
    • --use-ipv6-countrycode：强制使用 IPv6 地址查询国家代码。默认情况下，Agent 使用 IPv4 地址查询国家代码，如果服务器支持 IPv6 且与 IPv4 地址的国家代码不同，可以使用此参数。
    • --gpu：启用 GPU 监控。注意：GPU 使用率监控可能需要安装额外的依赖包，详细信息可以参考文档：启用 GPU 监控。
    • --temperature：启用硬件温度监控。仅支持的硬件有效，部分 VPS 可能无法获取温度信息。
    • -d --debug：启用调试模式。
    • -u --ip-report-period：本地IP更新间隔, 如果这个值小于 --report-delay 设置的值，那么以 --report-delay 的值为准。默认为1800秒（30分钟）。
    • -k --insecure：禁用证书检查，适用于使用自签证书的场景。
    + \ No newline at end of file diff --git a/guide/q8.html b/guide/q8.html index ff004097..f7312862 100644 --- a/guide/q8.html +++ b/guide/q8.html @@ -12,7 +12,7 @@ - + @@ -27,8 +27,8 @@ ClientID: 3516291f53eca9b4901a01337e41be7dc52f565c8657d08a3fddb2178d13c5bf ClientSecret: 0568b67c7b6d0ed51c663e2fe935683007c28f947a27b7bd47a5ad3d8b56fb67 Endpoint: "https://xxxxx.cloudflareaccess.com" - Type: cloudflare

    配置说明： ​

    参数获取方式
    AdminMy Team -> Users -> <具体用户> -> User ID
    ClientID/ClientSecretAccess -> Application -> Add an Application
    -> SaaS -> OIDC
    EndpointAccess -> Application -> Application URL -> 只保留协议+域名的部分，路径不需要

    新建 SaaS-OIDC 应用流程 ​

    前往 Zero Trust Dashboard：https://one.dash.cloudflare.com/，选择或新建一个账户（Account），然后按照以下步骤操作：

    1. My Team -> Users -> 点击<具体用户> -> 获取 User ID 并保存 （如果是第一次使用 Zero Trust，Users 列表会为空，可暂时跳过这一步；你需要完成一次验证后，用户才会出现在 Users 列表中）；
    2. Access -> Applications -> Add an Application;
    3. 选择 SaaS，在 Application 字段中输入自定义的应用名称（例如 nezha），选择 OIDC 后点击 Add application;
    4. Scopes 选择 openid, email, profile, groups;
    5. 在 Redirect URLs 中填写你的 Dashboard Callback 地址，例如 https://dashboard.example.com/oauth2/callback;
    6. 分别记录 Client ID、Client Secret 和 Issuer 地址中的协议与域名部分，例如 https://xxxxx.cloudflareaccess.com;
    7. 编辑 Dashboard 配置文件（通常位于 /opt/nezha/dashboard/data/config.yaml），参照示例配置修改 OAuth2 设置，并重启 Dashboard 服务。

    身份验证策略配置 ​

    在完成 Dashboard 设置后，您还需要在 Zero Trust Dashboard 中配置身份验证策略，路径为：Access -> Applications -> <应用名> -> Policies。您可以选择多种 SSO 验证方式，包括邮件 OTP 验证、硬件密钥验证等，详细配置请参考 Cloudflare Zero Trust 文档。

    策略配置示例（One-time PIN） ​

    默认使用邮件 OTP 验证方式：

    1. Access -> Applications -> <应用名> -> Policies -> Add a policy;
    2. 设置一个 Policy Name，例如 OTP，Action 设置为 Allow;
    3. 在 Configure rules 下新增一条 Include 规则，Selector 选择 Emails，在文本框中输入你的邮箱地址；
    4. 点击 Save policy 保存策略。

    测试策略 ​

    1. 在配置正确的情况下，访问 Dashboard 登录界面，会显示为 使用 Cloudflare 账号登录，点击登录会跳转到 Cloudflare Access 登录页面；
    2. 输入前面配置的 Email 地址，点击 Send me a code，输入收到的验证码，即可登录 Dashboard；
    3. 如果在之前的步骤中，未在 Admin 中未填写 User ID，登录后会提示错误信息：“该用户不是本站点管理员，无法登录”。此时需要在 My Team -> Users 中找到对应的用户，点击用户名获取 User ID 并填写到 Dashboard 配置文件里的 Admin 部分，重启 Dashboard 服务后再次尝试登录。
    - + Type: cloudflare

    配置说明： ​

    参数获取方式
    AdminMy Team -> Users -> <具体用户> -> User ID
    ClientID/ClientSecretAccess -> Application -> Add an Application
    -> SaaS -> OIDC
    EndpointAccess -> Application -> Application URL -> 只保留协议+域名的部分，路径不需要

    新建 SaaS-OIDC 应用流程 ​

    前往 Zero Trust Dashboard：https://one.dash.cloudflare.com/，选择或新建一个账户（Account），然后按照以下步骤操作：

    1. My Team -> Users -> 点击<具体用户> -> 获取 User ID 并保存 （如果是第一次使用 Zero Trust，Users 列表会为空，可暂时跳过这一步；你需要完成一次验证后，用户才会出现在 Users 列表中）；
    2. Access -> Applications -> Add an Application;
    3. 选择 SaaS，在 Application 字段中输入自定义的应用名称（例如 nezha），选择 OIDC 后点击 Add application;
    4. Scopes 选择 openid, email, profile, groups;
    5. 在 Redirect URLs 中填写你的 Dashboard Callback 地址，例如 https://dashboard.example.com/oauth2/callback;
    6. 分别记录 Client ID、Client Secret 和 Issuer 地址中的协议与域名部分，例如 https://xxxxx.cloudflareaccess.com;
    7. 编辑 Dashboard 配置文件（通常位于 /opt/nezha/dashboard/data/config.yaml），参照示例配置修改 OAuth2 设置，并重启 Dashboard 服务。

    身份验证策略配置 ​

    在完成 Dashboard 设置后，您还需要在 Zero Trust Dashboard 中配置身份验证策略，路径为：Access -> Applications -> <应用名> -> Policies。您可以选择多种 SSO 验证方式，包括邮件 OTP 验证、硬件密钥验证等，详细配置请参考 Cloudflare Zero Trust 文档。

    策略配置示例（One-time PIN） ​

    默认使用邮件 OTP 验证方式：

    1. Access -> Applications -> <应用名> -> Policies -> Add a policy;
    2. 设置一个 Policy Name，例如 OTP，Action 设置为 Allow;
    3. 在 Configure rules 下新增一条 Include 规则，Selector 选择 Emails，在文本框中输入你的邮箱地址；
    4. 点击 Save policy 保存策略。

    测试策略 ​

    1. 在配置正确的情况下，访问 Dashboard 登录界面，会显示为 使用 Cloudflare 账号登录，点击登录会跳转到 Cloudflare Access 登录页面；
    2. 输入前面配置的 Email 地址，点击 Send me a code，输入收到的验证码，即可登录 Dashboard；
    3. 如果在之前的步骤中，未在 Admin 中未填写 User ID，登录后会提示错误信息：“该用户不是本站点管理员，无法登录”。此时需要在 My Team -> Users 中找到对应的用户，点击用户名获取 User ID 并填写到 Dashboard 配置文件里的 Admin 部分，重启 Dashboard 服务后再次尝试登录。
    + \ No newline at end of file diff --git a/guide/q9.html b/guide/q9.html index cbc798d3..9a2583b7 100644 --- a/guide/q9.html +++ b/guide/q9.html @@ -12,7 +12,7 @@ - + @@ -22,7 +22,7 @@ -
    哪吒服务器监控

    简体中文

    English

    简体中文

    English

    Appearance

    启用 GPU 监控 ​

    GPU 监控是哪吒监控 v0.17.x 引入的新功能，使用前请检查您的 Dashboard 版本是否为 v0.17.2+ / Agent 版本是否为 v0.17.0+。

    启用 ​

    通过启动参数 ​

    在 Agent 运行参数后添加 --gpu 即可。例如：

    bash
    /opt/nezha/agent/nezha-agent -s example.com:5555 -p example --gpu

    通过配置文件 ​

    执行以下命令修改 Agent 配置文件以启用 GPU 监控：

    bash
    /opt/nezha/agent/nezha-agent edit

    在返回的互动菜单中选择启用 GPU 功能即可。

    打开 GPU 占用率监控支持 ​

    GPU 型号与 GPU 使用率为两个不同的监控项目，使用了不同实现获取。

    其中 Windows 和 macOS 支持无依赖获取 GPU 使用率，并支持多个品牌显卡；

    Linux 平台则仅支持 NVIDIA / AMD 显卡，且需要安装额外依赖。

    以下将介绍如何在 Linux 上为 NVIDIA / AMD 显卡启用 GPU 使用率监控。

    NVIDIA ​

    NVIDIA 显卡获取 GPU 使用率需要用到 nvidia-smi 工具，一般为官方驱动自带。

    如果您使用的是非官方驱动，例如 nouveau，那么将无法获取 GPU 使用率。

    AMD ​

    AMD 显卡获取 GPU 使用率需要安装官方 amdgpu 驱动和 rocm-smi 工具。

    主流系统均已打包 rocm-smi ，以下是部分系统的安装命令：

    bash
    # Arch Linux
+    
    哪吒服务器监控
    简体中文
    English
    简体中文
    English
    Appearance
    启用 GPU 监控 ​
    GPU 监控是哪吒监控 v0.17.x 引入的新功能，使用前请检查您的 Dashboard 版本是否为 v0.17.2+ / Agent 版本是否为 v0.17.0+。
    启用 ​
    通过启动参数 ​
    在 Agent 运行参数后添加 --gpu 即可。例如：
    bash
    /opt/nezha/agent/nezha-agent -s example.com:5555 -p example --gpu
    通过配置文件 ​
    执行以下命令修改 Agent 配置文件以启用 GPU 监控：
    bash
    /opt/nezha/agent/nezha-agent edit
    在返回的互动菜单中选择启用 GPU 功能即可。
    打开 GPU 占用率监控支持 ​
    GPU 型号与 GPU 使用率为两个不同的监控项目，使用了不同实现获取。
    其中 Windows 和 macOS 支持无依赖获取 GPU 使用率，并支持多个品牌显卡；
    Linux 平台则仅支持 NVIDIA / AMD 显卡，且需要安装额外依赖。
    以下将介绍如何在 Linux 上为 NVIDIA / AMD 显卡启用 GPU 使用率监控。
    NVIDIA ​
    NVIDIA 显卡获取 GPU 使用率需要用到 nvidia-smi 工具，一般为官方驱动自带。
    如果您使用的是非官方驱动，例如 nouveau，那么将无法获取 GPU 使用率。
    AMD ​
    AMD 显卡获取 GPU 使用率需要安装 amdgpu 开源驱动和 rocm-smi 工具。
    主流系统均已打包 rocm-smi ，以下是部分系统的安装命令：
    bash
    # Arch Linux
 pacman -Sy rocm-smi-lib
 
 # Debian / Ubuntu
@@ -35,8 +35,8 @@
 cmake ..
 make -j $(nproc)
 # Install library file and header; default location is /opt/rocm
-make install
    
-    
+make install
    + \ No newline at end of file diff --git a/guide/servers.html b/guide/servers.html index 3d6d84c5..ada328ba 100644 --- a/guide/servers.html +++ b/guide/servers.html @@ -12,7 +12,7 @@ - + @@ -47,8 +47,8 @@ WebhookURL: "" WebhookRequestBody: "" WebhookHeaders: ""

    其它选项请参考单配置段。

    Dashboard 配置 ​

    修改配置文件后，还需要在 Dashboard 中修改服务器设置才能使 DDNS 生效。

    DDNS 相关选项说明：

    WARNING

    在 Dashboard 设置中修改配置并保存时，会在 config.yaml 中填入默认配置选项，此时 DDNS 段中会同时存在单配置和多配置。

    查看日志 ​

    在 Dashboard 的日志中，可以看到 DDNS 功能的相关日志，配置正确时，更新 DNS 记录时会有相应的日志记录。

    shell
    dashboard_1  | 2024/03/16 23:16:25 NEZHA>> 正在尝试更新域名(ddns.example.com)DDNS(1/3)
-dashboard_1  | 2024/03/16 23:16:28 NEZHA>> 尝试更新域名(ddns.example.com)DDNS成功
    - +dashboard_1 | 2024/03/16 23:16:28 NEZHA>> 尝试更新域名(ddns.example.com)DDNS成功 + \ No newline at end of file diff --git a/guide/services.html b/guide/services.html index af6273f3..9f845622 100644 --- a/guide/services.html +++ b/guide/services.html @@ -12,7 +12,7 @@ - + @@ -22,8 +22,8 @@ -
    哪吒服务器监控

    简体中文

    English

    简体中文

    English

    Appearance

    服务监控 ​

    服务区域是设置 Agent 监控外部网站或服务器的功能设置区
    设置好的服务监控可以在主页中的“服务”页查看过去 30 天的可用性监控结果

    使用方法 ​

    如需新增一个监控，可以进入管理面板中的“服务”页，点击“添加监控”。

    新增一个服务监控时，你需要设置以下参数：

    • 名称：自定义一个名称。

    • 类型：选择一个监控类型。目前哪吒监控支持三种监控类型，分别是“HTTP-GET”、“ICMP-Ping”和“TCP-Ping”。

    • 目标：根据你选择的类型不同，目标的设置方法也不同：

      • HTTP-GET：选择此类型时，你应输入一个 URL 作为目标，URL 需添加 http:// 或 https://。如果你的目标 URL 是 https://，将会同时监控该 URL 的 SSL 证书，当 SSL 证书到期或发生变更，会触发提醒。例如：https://example.com。
      • ICMP-Ping：选择此类型时，你应输入一个域名或 IP，不含端口号。例如：1.1.1.1 或 example.com。
      • TCP-Ping：选择此类型时，你应输入一个域名或 IP 并包含端口号。例如：1.1.1.1:80 或 example.com:22。

    • 请求间隔：设定 Agent 每次请求目标的时间间隔，以秒为单位。

    • 覆盖范围：选择一条规则来确定要使用哪些 Agent 来请求目标。

    • 特定服务器：配合覆盖范围使用，选择规则内需要排除的 Agent。

    • 通知方式组：选择你已经在“告警”页设置好的通知方式，点击这里了解详情。

    • 启用故障通知：根据需要选择是否接收目标故障通知，默认为不勾选。

    设置完成后，点击“添加”即可。稍等片刻前往主页的“服务”页查看监控结果。

    延迟变化告警 ​

    哪吒监控可以监测并统计 Agent 到目标服务器之间的延迟，在发生较大变化的情况下发送通知。利用此功能可以帮助你监控服务器的线路是否发生了变化。

    • 启用延迟通知：开启时，当 Agent 至目标服务器的延迟大于最高延迟或小于最低延迟时，将会发送告警通知。

    告警时触发任务 ​

    如果你需要在服务监控告警触发时执行一些任务，可以勾选“启用触发任务”，并在“告警时触发任务”和“恢复时触发任务”中选择你已经提前设置好的触发任务。

    网络延迟图表 ​

    在服务页中设置的 TCP-Ping 和 ICMP-Ping 类型的监控都会自动启用监控图表功能。在主页的“网络”页中，你可以查看历史网络延迟监控图表。图表中的数据是根据 Agent 到目标服务器的延迟统计而来，你可以点击 Agent 的名称来切换图表。在图表中，可以取消勾选目标服务器的名称来隐藏或显示对应的数据。

    管理监控 ​

    如需对已有的服务监控进行管理，可以前往管理面板中的“服务”页。选择一条监控配置，点击右侧的图标进行编辑或删除。

    - +
    哪吒服务器监控

    简体中文

    English

    简体中文

    English

    Appearance

    服务监控 ​

    服务区域是设置 Agent 监控外部网站或服务器的功能设置区
    设置好的服务监控可以在主页中的“服务”页查看过去 30 天的可用性监控结果

    使用方法 ​

    如需新增一个监控，可以进入管理面板中的“服务”页，点击“添加监控”。

    新增一个服务监控时，你需要设置以下参数：

    • 名称：自定义一个名称。

    • 类型：选择一个监控类型。目前哪吒监控支持三种监控类型，分别是“HTTP-GET”、“ICMP-Ping”和“TCP-Ping”。

    • 目标：根据你选择的类型不同，目标的设置方法也不同：

      • HTTP-GET：选择此类型时，你应输入一个 URL 作为目标，URL 需添加 http:// 或 https://。如果你的目标 URL 是 https://，将会同时监控该 URL 的 SSL 证书，当 SSL 证书到期或发生变更，会触发提醒。例如：https://example.com。
      • ICMP-Ping：选择此类型时，你应输入一个域名或 IP，不含端口号。例如：1.1.1.1 或 example.com。
      • TCP-Ping：选择此类型时，你应输入一个域名或 IP 并包含端口号。例如：1.1.1.1:80 或 example.com:22。

    • 请求间隔：设定 Agent 每次请求目标的时间间隔，以秒为单位。

    • 覆盖范围：选择一条规则来确定要使用哪些 Agent 来请求目标。

    • 特定服务器：配合覆盖范围使用，选择规则内需要排除的 Agent。

    • 通知方式组：选择你已经在“告警”页设置好的通知方式，点击这里了解详情。

    • 启用故障通知：根据需要选择是否接收目标故障通知，默认为不勾选。

    设置完成后，点击“添加”即可。稍等片刻前往主页的“服务”页查看监控结果。

    延迟变化告警 ​

    哪吒监控可以监测并统计 Agent 到目标服务器之间的延迟，在发生较大变化的情况下发送通知。利用此功能可以帮助你监控服务器的线路是否发生了变化。

    • 启用延迟通知：开启时，当 Agent 至目标服务器的延迟大于最高延迟或小于最低延迟时，将会发送告警通知。

    告警时触发任务 ​

    如果你需要在服务监控告警触发时执行一些任务，可以勾选“启用触发任务”，并在“告警时触发任务”和“恢复时触发任务”中选择你已经提前设置好的触发任务。

    网络延迟图表 ​

    在服务页中设置的 TCP-Ping 和 ICMP-Ping 类型的监控都会自动启用监控图表功能。在主页的“网络”页中，你可以查看历史网络延迟监控图表。图表中的数据是根据 Agent 到目标服务器的延迟统计而来，你可以点击 Agent 的名称来切换图表。在图表中，可以取消勾选目标服务器的名称来隐藏或显示对应的数据。

    管理监控 ​

    如需对已有的服务监控进行管理，可以前往管理面板中的“服务”页。选择一条监控配置，点击右侧的图标进行编辑或删除。

    + \ No newline at end of file diff --git a/guide/settings.html b/guide/settings.html index 2f273fbf..832ea508 100644 --- a/guide/settings.html +++ b/guide/settings.html @@ -12,7 +12,7 @@ - + @@ -330,8 +330,8 @@ .hotaru-cover { background: url(https://s3.ax1x.com/2020/12/08/DzHv6A.jpg) center; } -</style>

    前台查看密码 ​

    如果你不想向游客直接展示你的 Dashboard，可以在这里设置一个查看密码。设置密码后，需要输入密码才可以访问主页。

    未接入 CDN 的面板服务器域名/IP ​

    此项设置是使用一键脚本安装 Agent 的前提，详情请查看这里。

    IP 变更提醒 ​

    如果你希望当某个服务器的 IP 发生变更时收到通知，可以在这里进行设置。

    覆盖范围 ​

    在这里选择一条规则，来确定需要监控哪些服务器，可以根据自己的需求进行选择。

    特定服务器 ​

    配合覆盖范围的设置，在这里设置选定规则的排除项。

    提醒发送至指定的通知分组 ​

    选择通知方式，通知方式请提前在“告警”页内设置。

    WARNING

    设置完成后，勾选启用时，通知生效。

    通知中显示完整 IP 地址 ​

    IP 变更通知默认隐藏完整 IP，如果你不希望隐藏，可以勾选“通知信息中显示完整 IP 地址”。

    禁止主页切换主题 ​

    Dashboard 默认启用允许访客修改显示主题的功能，此功能只会影响单一访客，不会影响管理员在后台设置的启用主题。如果你不希望访客切换主题，可以勾选此项。

    - +</style>

    前台查看密码 ​

    如果你不想向游客直接展示你的 Dashboard，可以在这里设置一个查看密码。设置密码后，需要输入密码才可以访问主页。

    未接入 CDN 的面板服务器域名/IP ​

    此项设置是使用一键脚本安装 Agent 的前提，详情请查看这里。

    IP 变更提醒 ​

    如果你希望当某个服务器的 IP 发生变更时收到通知，可以在这里进行设置。

    覆盖范围 ​

    在这里选择一条规则，来确定需要监控哪些服务器，可以根据自己的需求进行选择。

    特定服务器 ​

    配合覆盖范围的设置，在这里设置选定规则的排除项。

    提醒发送至指定的通知分组 ​

    选择通知方式，通知方式请提前在“告警”页内设置。

    WARNING

    设置完成后，勾选启用时，通知生效。

    通知中显示完整 IP 地址 ​

    IP 变更通知默认隐藏完整 IP，如果你不希望隐藏，可以勾选“通知信息中显示完整 IP 地址”。

    禁止主页切换主题 ​

    Dashboard 默认启用允许访客修改显示主题的功能，此功能只会影响单一访客，不会影响管理员在后台设置的启用主题。如果你不希望访客切换主题，可以勾选此项。

    + \ No newline at end of file diff --git a/guide/tasks.html b/guide/tasks.html index fa468b05..fcbb10ca 100644 --- a/guide/tasks.html +++ b/guide/tasks.html @@ -12,7 +12,7 @@ - + @@ -22,8 +22,8 @@ -
    哪吒服务器监控

    简体中文

    English

    简体中文

    English

    Appearance

    任务管理 ​

    在任务区域中，可以设置计划任务，触发任务，多服务器批量执行任务

    哪吒监控支持推送命令到 Agent 执行，此功能非常灵活。使用此功能可以定期结合 restic、rclone 给服务器备份，定期重启某项服务来重置网络连接。也可以配合告警通知，在触发告警时执行某项任务，例如在 CPU 长时间高占用的情况下运行某个脚本。

    使用方法 ​

    进入管理面板的“任务”页，点击“添加计划任务”。添加计划任务时，你需要填入以下参数：

    • 名称：自定义一个任务名称。

    • 任务类型：选择任务的类型。

      • 计划任务：按下方设置的计划时间，周期性执行任务。
      • 触发任务：仅被 API 或告警规则触发的任务，每次触发执行一次。

    • 计划：设置计划时间（使用触发任务类型时不生效），时间格式为：* * * * * *，分别对应秒 分 时 天 月 星期，详情见计划表达式格式。
      例如：0 0 3 * * * 对应为“每天 3 点”。

    • 命令：设置需要执行的命令，就像写 Shell/Bat 脚本一样，但不推荐换行，多个命令使用 &&/& 连接。
      例如执行定期重启命令，可以在这里输入 reboot。

    • 覆盖范围和特定服务器：选择规则来确定哪些 Agent 执行计划任务，类似于“服务”页中的设置。使用触发任务类型时，可选择“由触发的服务器执行”。

    • 通知方式组：选择你已经在“告警”页设置好的通知方式，点击这里了解详情。

    • 推送成功的消息：勾选此项，任务执行成功后会触发消息通知。

    管理任务 ​

    如需对已有的计划任务进行管理，可以前往管理面板中的“任务”页。选择一条任务配置，右侧的三个图标分别是：

    • 立即执行：点击后将忽略计划时间，立刻执行任务。
    • 编辑：点击可以修改任务配置。
    • 删除：删除这条计划任务。

    常见问题 ​

    1. xxx 命令找不到
      如果运行失败，提示 xxx 命令找不到，可能是 PATH 环境变量的问题。在 Linux 服务器上，可以在命令开头加入 source ~/.bashrc，或者使用绝对路径执行命令。
    - +
    哪吒服务器监控

    简体中文

    English

    简体中文

    English

    Appearance

    任务管理 ​

    在任务区域中，可以设置计划任务，触发任务，多服务器批量执行任务

    哪吒监控支持推送命令到 Agent 执行，此功能非常灵活。使用此功能可以定期结合 restic、rclone 给服务器备份，定期重启某项服务来重置网络连接。也可以配合告警通知，在触发告警时执行某项任务，例如在 CPU 长时间高占用的情况下运行某个脚本。

    使用方法 ​

    进入管理面板的“任务”页，点击“添加计划任务”。添加计划任务时，你需要填入以下参数：

    • 名称：自定义一个任务名称。

    • 任务类型：选择任务的类型。

      • 计划任务：按下方设置的计划时间，周期性执行任务。
      • 触发任务：仅被 API 或告警规则触发的任务，每次触发执行一次。

    • 计划：设置计划时间（使用触发任务类型时不生效），时间格式为：* * * * * *，分别对应秒 分 时 天 月 星期，详情见计划表达式格式。
      例如：0 0 3 * * * 对应为“每天 3 点”。

    • 命令：设置需要执行的命令，就像写 Shell/Bat 脚本一样，但不推荐换行，多个命令使用 &&/& 连接。
      例如执行定期重启命令，可以在这里输入 reboot。

    • 覆盖范围和特定服务器：选择规则来确定哪些 Agent 执行计划任务，类似于“服务”页中的设置。使用触发任务类型时，可选择“由触发的服务器执行”。

    • 通知方式组：选择你已经在“告警”页设置好的通知方式，点击这里了解详情。

    • 推送成功的消息：勾选此项，任务执行成功后会触发消息通知。

    管理任务 ​

    如需对已有的计划任务进行管理，可以前往管理面板中的“任务”页。选择一条任务配置，右侧的三个图标分别是：

    • 立即执行：点击后将忽略计划时间，立刻执行任务。
    • 编辑：点击可以修改任务配置。
    • 删除：删除这条计划任务。

    常见问题 ​

    1. xxx 命令找不到
      如果运行失败，提示 xxx 命令找不到，可能是 PATH 环境变量的问题。在 Linux 服务器上，可以在命令开头加入 source ~/.bashrc，或者使用绝对路径执行命令。
    + \ No newline at end of file diff --git a/hashmap.json b/hashmap.json index 89ef9e1e..268f3f66 100644 --- a/hashmap.json +++ b/hashmap.json @@ -1 +1 @@ -{"en_us_case_case2.md":"e4I5L63c","developer_index.md":"DUiahKCM","case_case5.md":"osZVBcFL","en_us_developer_index.md":"BDrJUsur","en_us_guide_q9.md":"smduIPrj","developer_theme.md":"DwRLCISJ","case_index.md":"4DjBqaIJ","en_us_case_case1.md":"ByY4CFbz","en_us_guide_servers.md":"DVACrWao","en_us_case_case3.md":"CpXzTru0","case_case4.md":"CM7HxnXM","en_us_guide_q6.md":"BA2Mixt2","case_case1.md":"LpPNSlns","developer_l10n.md":"CeCojXbD","guide_tasks.md":"Bi5G2Mf7","index.md":"BGk4-g1D","guide_services.md":"C8QNUzqS","guide_q6.md":"CrQuSOZ7","guide_servers.md":"BKp937FG","guide_q9.md":"CmMyPOr7","guide_q7.md":"fXYFTmHt","case_case2.md":"DocdANBo","en_us_case_case4.md":"BY6h5Lyf","guide_q8.md":"DLb5AhjW","en_us_guide_q7.md":"CEsTx0IJ","en_us_developer_theme.md":"CEA7TVXg","en_us_guide_q2.md":"DKpM-o7X","en_us_guide_q5.md":"DTWM_xSc","guide_q2.md":"htjQAYGX","en_us_guide_agent.md":"QSO76OyE","guide_notifications.md":"BhXbFpT6","case_case3.md":"CjLXeVWH","guide_q1.md":"Mf0l__AA","en_us_guide_q8.md":"CmRXWc2s","en_us_index.md":"5DlTH31p","guide_agentq.md":"CCawlDAk","en_us_guide_loginq.md":"Dw2Asnbl","en_us_developer_l10n.md":"CPk2FH8T","en_us_case_case5.md":"DA6NprQ-","en_us_guide_api.md":"Bk6_Wmwt","en_us_guide_agentq.md":"CQxYnGfY","en_us_guide_q4.md":"aYJ-8xKH","guide_agent.md":"CM_Fo0eC","en_us_guide_notifications.md":"C1ETW-wK","guide_settings.md":"2PNw4VLJ","en_us_guide_settings.md":"BU607WHw","en_us_guide_q3.md":"DLsqDyYo","en_us_guide_services.md":"BBxKQ1c6","guide_q5.md":"BBH3g7xw","guide_loginq.md":"DKJlin4f","guide_dashboard.md":"BNmWtZKa","guide_api.md":"CnBJFfdg","en_us_case_index.md":"BohQDlQR","en_us_guide_dashboard.md":"DRdDzW_7","guide_q3.md":"COlsnPXw","en_us_guide_tasks.md":"DTnzO10E","en_us_guide_dashboardq.md":"B4DEvbIt","guide_dashboardq.md":"CKDV9jtc","guide_q4.md":"U4ZAnBDm"} +{"en_us_guide_loginq.md":"CFelVFsR","en_us_guide_q6.md":"CvNydJBZ","case_case3.md":"BBNQkwC_","case_case4.md":"DJ1ZkmGG","en_us_guide_q5.md":"D5AV9Ebn","en_us_guide_q7.md":"COykhm5h","en_us_guide_q9.md":"ChfrTpfw","case_case2.md":"UW1WkMIc","en_us_guide_servers.md":"CaZtZR7u","en_us_developer_l10n.md":"BRCCxeYb","en_us_guide_dashboard.md":"DeHZrujK","en_us_guide_q3.md":"CTXrmbZ1","en_us_guide_agentq.md":"BCdgnYHv","en_us_guide_q4.md":"DM-tS50B","en_us_case_case3.md":"D2W661N3","developer_index.md":"xxGfpZF3","en_us_guide_services.md":"9UA2YLQo","developer_l10n.md":"BAFYrTMh","guide_servers.md":"RyuWq3Su","en_us_guide_api.md":"C56GHcq2","index.md":"Cap0kWjD","en_us_index.md":"DRjybGgh","guide_q7.md":"BtKX2CnL","en_us_guide_q8.md":"DqrZgNKt","case_case1.md":"DUuX9xR2","en_us_case_case2.md":"A3YJEqVR","guide_tasks.md":"CtyXO3aM","guide_q6.md":"BhRMgnuQ","guide_agentq.md":"DE0EkuCN","guide_agent.md":"bMyf3now","en_us_developer_theme.md":"BX8kubGu","guide_api.md":"VVqowlRg","en_us_developer_index.md":"pRAEvIf8","guide_q8.md":"B9eDC4bk","en_us_guide_q2.md":"CEf8ySiR","guide_services.md":"TLizXtj8","en_us_guide_agent.md":"BuV95h8M","en_us_guide_notifications.md":"BKPemZAi","en_us_case_case5.md":"CvvuNTjh","en_us_case_case4.md":"BNCQiUe2","developer_theme.md":"C0RMjrhD","case_index.md":"CsiPlEOO","guide_loginq.md":"Bf0TfuMn","en_us_case_case1.md":"V6itg62M","guide_dashboardq.md":"DMq2iXGy","guide_q9.md":"Czglfq60","guide_settings.md":"CgknQgrp","guide_q1.md":"DGqes8ej","en_us_case_index.md":"Dx-Wd6dm","guide_q2.md":"UW63mMx2","en_us_guide_tasks.md":"DusKtZTs","en_us_guide_settings.md":"ZIcCtOf-","case_case5.md":"XtRUITLa","en_us_guide_dashboardq.md":"Ch1jJAla","guide_q3.md":"CdIPXjnP","guide_q4.md":"C8MxbCGn","guide_dashboard.md":"cW_QlnlA","guide_q5.md":"BUeVTPjy","guide_notifications.md":"CHN04EOu"} diff --git a/index.html b/index.html index acb182cb..c4838d90 100644 --- a/index.html +++ b/index.html @@ -12,7 +12,7 @@ - + @@ -23,7 +23,7 @@
    哪吒服务器监控

    简体中文

    English

    简体中文

    English

    Appearance

    哪吒监控

    开源、轻量、易用的服务器监控与运维工具

    预览
    开始使用 →

    一键安装

    支持一键安装面板和监控服务，操作便捷。兼容主流系统，包括 Linux、Windows、macOS、OpenWRT 以及群晖。

    实时监控

    支持同时监控多个服务器的状态，提供历史网络状态和延迟图表，监控网页、端口可用性和 SSL 证书状态。支持故障和流量等状态告警，可通过 Telegram、邮件、微信等多种方式提醒。

    轻松运维

    提供 API 获取服务器状态，支持WebSSH、DDNS 和流量监控。可设置定时和触发任务，并批量执行服务器任务。

    - + \ No newline at end of file