diff --git a/404.html b/404.html index e8775e12..14724125 100644 --- a/404.html +++ b/404.html @@ -13,7 +13,7 @@
Skip to content

404

PAGE NOT FOUND

But if you don't change your direction, and if you keep looking, you may end up where you are heading.
- diff --git a/assets/case_case1.md.9636467d.js b/assets/case_case1.md.86f6ebaa.js similarity index 95% rename from assets/case_case1.md.9636467d.js rename to assets/case_case1.md.86f6ebaa.js index c2bd6906..fca7c65f 100644 --- a/assets/case_case1.md.9636467d.js +++ b/assets/case_case1.md.86f6ebaa.js @@ -1 +1 @@ -import{_ as e,o as t,c as a,R as r}from"./chunks/framework.44fd0451.js";const b=JSON.parse('{"title":"自建一个TG机器人来查询服务器信息","description":"","frontmatter":{},"headers":[],"relativePath":"case/case1.md","filePath":"case/case1.md","lastUpdated":1698142262000}'),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 t(),a("div",null,s)}const g=e(o,[["render",i]]);export{b as __pageData,g as default}; +import{_ as e,o as t,c as a,R as r}from"./chunks/framework.44fd0451.js";const b=JSON.parse('{"title":"自建一个TG机器人来查询服务器信息","description":"","frontmatter":{},"headers":[],"relativePath":"case/case1.md","filePath":"case/case1.md","lastUpdated":1698335020000}'),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 t(),a("div",null,s)}const g=e(o,[["render",i]]);export{b as __pageData,g as default}; diff --git a/assets/case_case1.md.9636467d.lean.js b/assets/case_case1.md.86f6ebaa.lean.js similarity index 85% rename from assets/case_case1.md.9636467d.lean.js rename to assets/case_case1.md.86f6ebaa.lean.js index b2fe5ac0..5ba17833 100644 --- a/assets/case_case1.md.9636467d.lean.js +++ b/assets/case_case1.md.86f6ebaa.lean.js @@ -1 +1 @@ -import{_ as e,o as t,c as a,R as r}from"./chunks/framework.44fd0451.js";const b=JSON.parse('{"title":"自建一个TG机器人来查询服务器信息","description":"","frontmatter":{},"headers":[],"relativePath":"case/case1.md","filePath":"case/case1.md","lastUpdated":1698142262000}'),o={name:"case/case1.md"},_=r("",5),s=[_];function i(n,c,p,h,l,d){return t(),a("div",null,s)}const g=e(o,[["render",i]]);export{b as __pageData,g as default}; +import{_ as e,o as t,c as a,R as r}from"./chunks/framework.44fd0451.js";const b=JSON.parse('{"title":"自建一个TG机器人来查询服务器信息","description":"","frontmatter":{},"headers":[],"relativePath":"case/case1.md","filePath":"case/case1.md","lastUpdated":1698335020000}'),o={name:"case/case1.md"},_=r("",5),s=[_];function i(n,c,p,h,l,d){return t(),a("div",null,s)}const g=e(o,[["render",i]]);export{b as __pageData,g as default}; diff --git a/assets/case_case2.md.ddac47f2.js b/assets/case_case2.md.26c353ad.js similarity index 97% rename from assets/case_case2.md.ddac47f2.js rename to assets/case_case2.md.26c353ad.js index 7d8b050b..bab8ac6a 100644 --- a/assets/case_case2.md.ddac47f2.js +++ b/assets/case_case2.md.26c353ad.js @@ -1 +1 @@ -import{_ as a}from"./chunks/qrcode.59c44dde.js";import{_ as e,o as r,c as i,R as t}from"./chunks/framework.44fd0451.js";const b=JSON.parse('{"title":"在iOS/MacOS中使用Siri运行快捷指令查询服务器状态","description":"","frontmatter":{},"headers":[],"relativePath":"case/case2.md","filePath":"case/case2.md","lastUpdated":1698142262000}'),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 r(),i("div",null,s)}const S=e(o,[["render",l]]);export{b as __pageData,S as default}; +import{_ as a}from"./chunks/qrcode.59c44dde.js";import{_ as e,o as r,c as i,R as t}from"./chunks/framework.44fd0451.js";const b=JSON.parse('{"title":"在iOS/MacOS中使用Siri运行快捷指令查询服务器状态","description":"","frontmatter":{},"headers":[],"relativePath":"case/case2.md","filePath":"case/case2.md","lastUpdated":1698335020000}'),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 r(),i("div",null,s)}const S=e(o,[["render",l]]);export{b as __pageData,S as default}; diff --git a/assets/case_case2.md.ddac47f2.lean.js b/assets/case_case2.md.26c353ad.lean.js similarity index 87% rename from assets/case_case2.md.ddac47f2.lean.js rename to assets/case_case2.md.26c353ad.lean.js index bb8cb913..d92cf53a 100644 --- a/assets/case_case2.md.ddac47f2.lean.js +++ b/assets/case_case2.md.26c353ad.lean.js @@ -1 +1 @@ -import{_ as a}from"./chunks/qrcode.59c44dde.js";import{_ as e,o as r,c as i,R as t}from"./chunks/framework.44fd0451.js";const b=JSON.parse('{"title":"在iOS/MacOS中使用Siri运行快捷指令查询服务器状态","description":"","frontmatter":{},"headers":[],"relativePath":"case/case2.md","filePath":"case/case2.md","lastUpdated":1698142262000}'),o={name:"case/case2.md"},c=t("",8),s=[c];function l(d,n,h,_,p,m){return r(),i("div",null,s)}const S=e(o,[["render",l]]);export{b as __pageData,S as default}; +import{_ as a}from"./chunks/qrcode.59c44dde.js";import{_ as e,o as r,c as i,R as t}from"./chunks/framework.44fd0451.js";const b=JSON.parse('{"title":"在iOS/MacOS中使用Siri运行快捷指令查询服务器状态","description":"","frontmatter":{},"headers":[],"relativePath":"case/case2.md","filePath":"case/case2.md","lastUpdated":1698335020000}'),o={name:"case/case2.md"},c=t("",8),s=[c];function l(d,n,h,_,p,m){return r(),i("div",null,s)}const S=e(o,[["render",l]]);export{b as __pageData,S as default}; diff --git a/assets/case_case3.md.ec96e142.js b/assets/case_case3.md.22f9493d.js similarity index 98% rename from assets/case_case3.md.ec96e142.js rename to assets/case_case3.md.22f9493d.js index ae6c1ed7..dc1e5b4e 100644 --- a/assets/case_case3.md.ec96e142.js +++ b/assets/case_case3.md.22f9493d.js @@ -1 +1 @@ -import{_ as t,o as e,c as a,R as r}from"./chunks/framework.44fd0451.js";const f=JSON.parse('{"title":"自建使用 API 来进行查询,且支持多语言的 Telegram 查询机器人","description":"","frontmatter":{},"headers":[],"relativePath":"case/case3.md","filePath":"case/case3.md","lastUpdated":1698142262000}'),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 e(),a("div",null,i)}const b=t(d,[["render",o]]);export{f as __pageData,b as default}; +import{_ as t,o as e,c as a,R as r}from"./chunks/framework.44fd0451.js";const f=JSON.parse('{"title":"自建使用 API 来进行查询,且支持多语言的 Telegram 查询机器人","description":"","frontmatter":{},"headers":[],"relativePath":"case/case3.md","filePath":"case/case3.md","lastUpdated":1698335020000}'),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 e(),a("div",null,i)}const b=t(d,[["render",o]]);export{f as __pageData,b as default}; diff --git a/assets/case_case3.md.ec96e142.lean.js b/assets/case_case3.md.22f9493d.lean.js similarity index 86% rename from assets/case_case3.md.ec96e142.lean.js rename to assets/case_case3.md.22f9493d.lean.js index 9ba9c414..33b36571 100644 --- a/assets/case_case3.md.ec96e142.lean.js +++ b/assets/case_case3.md.22f9493d.lean.js @@ -1 +1 @@ -import{_ as t,o as e,c as a,R as r}from"./chunks/framework.44fd0451.js";const f=JSON.parse('{"title":"自建使用 API 来进行查询,且支持多语言的 Telegram 查询机器人","description":"","frontmatter":{},"headers":[],"relativePath":"case/case3.md","filePath":"case/case3.md","lastUpdated":1698142262000}'),d={name:"case/case3.md"},l=r("",12),i=[l];function o(h,n,c,s,_,m){return e(),a("div",null,i)}const b=t(d,[["render",o]]);export{f as __pageData,b as default}; +import{_ as t,o as e,c as a,R as r}from"./chunks/framework.44fd0451.js";const f=JSON.parse('{"title":"自建使用 API 来进行查询,且支持多语言的 Telegram 查询机器人","description":"","frontmatter":{},"headers":[],"relativePath":"case/case3.md","filePath":"case/case3.md","lastUpdated":1698335020000}'),d={name:"case/case3.md"},l=r("",12),i=[l];function o(h,n,c,s,_,m){return e(),a("div",null,i)}const b=t(d,[["render",o]]);export{f as __pageData,b as default}; diff --git a/assets/case_case4.md.b879d03c.js b/assets/case_case4.md.88e5e1f3.js similarity index 94% rename from assets/case_case4.md.b879d03c.js rename to assets/case_case4.md.88e5e1f3.js index f01022eb..4a315d19 100644 --- a/assets/case_case4.md.b879d03c.js +++ b/assets/case_case4.md.88e5e1f3.js @@ -1 +1 @@ -import{_ as s,o as t,c as e,R as a}from"./chunks/framework.44fd0451.js";const r="/assets/2.38c2ea56.png",n="/assets/5.23139306.png",o="/assets/6.22a61698.png",p="/assets/4.fe6a4e7a.jpg",c="/assets/1.b4b4591f.jpeg",y=JSON.parse('{"title":"重磅推荐!一秒拥有宇宙级算力!让你在人前,不!再!自!卑","description":"","frontmatter":{},"headers":[],"relativePath":"case/case4.md","filePath":"case/case4.md","lastUpdated":1698142262000}'),_={name:"case/case4.md"},i=a('

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



2

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


今天开始!找回自信!

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

镜像备份(非实时更新):Fake Agent

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


男人用了都说好:
6
4



1

',12),l=[i];function g(f,b,h,m,d,k){return t(),e("div",null,l)}const z=s(_,[["render",g]]);export{y as __pageData,z as default}; +import{_ as s,o as t,c as e,R as a}from"./chunks/framework.44fd0451.js";const r="/assets/2.38c2ea56.png",n="/assets/5.23139306.png",o="/assets/6.22a61698.png",p="/assets/4.fe6a4e7a.jpg",c="/assets/1.b4b4591f.jpeg",y=JSON.parse('{"title":"重磅推荐!一秒拥有宇宙级算力!让你在人前,不!再!自!卑","description":"","frontmatter":{},"headers":[],"relativePath":"case/case4.md","filePath":"case/case4.md","lastUpdated":1698335020000}'),_={name:"case/case4.md"},i=a('

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



2

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


今天开始!找回自信!

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

镜像备份(非实时更新):Fake Agent

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


男人用了都说好:
6
4



1

',12),l=[i];function g(f,b,h,m,d,k){return t(),e("div",null,l)}const z=s(_,[["render",g]]);export{y as __pageData,z as default}; diff --git a/assets/case_case4.md.b879d03c.lean.js b/assets/case_case4.md.88e5e1f3.lean.js similarity index 79% rename from assets/case_case4.md.b879d03c.lean.js rename to assets/case_case4.md.88e5e1f3.lean.js index d059b990..0aec60fa 100644 --- a/assets/case_case4.md.b879d03c.lean.js +++ b/assets/case_case4.md.88e5e1f3.lean.js @@ -1 +1 @@ -import{_ as s,o as t,c as e,R as a}from"./chunks/framework.44fd0451.js";const r="/assets/2.38c2ea56.png",n="/assets/5.23139306.png",o="/assets/6.22a61698.png",p="/assets/4.fe6a4e7a.jpg",c="/assets/1.b4b4591f.jpeg",y=JSON.parse('{"title":"重磅推荐!一秒拥有宇宙级算力!让你在人前,不!再!自!卑","description":"","frontmatter":{},"headers":[],"relativePath":"case/case4.md","filePath":"case/case4.md","lastUpdated":1698142262000}'),_={name:"case/case4.md"},i=a("",12),l=[i];function g(f,b,h,m,d,k){return t(),e("div",null,l)}const z=s(_,[["render",g]]);export{y as __pageData,z as default}; +import{_ as s,o as t,c as e,R as a}from"./chunks/framework.44fd0451.js";const r="/assets/2.38c2ea56.png",n="/assets/5.23139306.png",o="/assets/6.22a61698.png",p="/assets/4.fe6a4e7a.jpg",c="/assets/1.b4b4591f.jpeg",y=JSON.parse('{"title":"重磅推荐!一秒拥有宇宙级算力!让你在人前,不!再!自!卑","description":"","frontmatter":{},"headers":[],"relativePath":"case/case4.md","filePath":"case/case4.md","lastUpdated":1698335020000}'),_={name:"case/case4.md"},i=a("",12),l=[i];function g(f,b,h,m,d,k){return t(),e("div",null,l)}const z=s(_,[["render",g]]);export{y as __pageData,z as default}; diff --git a/assets/case_case5.md.7373a3b6.js b/assets/case_case5.md.f67aa872.js similarity index 99% rename from assets/case_case5.md.7373a3b6.js rename to assets/case_case5.md.f67aa872.js index 4280f940..9b74045b 100644 --- a/assets/case_case5.md.7373a3b6.js +++ b/assets/case_case5.md.f67aa872.js @@ -1,4 +1,4 @@ -import{_ as a,o as e,c as s,R as t}from"./chunks/framework.44fd0451.js";const u=JSON.parse('{"title":"使用 Argo 隧道的哪吒服务端","description":"","frontmatter":{},"headers":[],"relativePath":"case/case5.md","filePath":"case/case5.md","lastUpdated":1698142262000}'),n={name:"case/case5.md"},l=t(`

使用 Argo 隧道的哪吒服务端

贡献者:

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

镜像备份(非实时更新):Argo-Nezha-Service-Container


目录


项目特点:

image

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

Argo 隧道认证方式有 json 和 token,使用两个方式其中之一

(方式 1 - Josn):

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

image

到 Cloudflare 官网,在相应的域名 DNS 记录里加上客户端上报数据(tcp)和 ssh(可选)的域名,打开橙色云启用 CDN

imageimage

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

到 cf 官网:https://dash.cloudflare.com/ ,进入 zero trust 里生成 token 隧道和信息。

imageimageimageimageimageimageimage

准备需要用的变量

image

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

imageimageimageimageimage

PaaS 部署实例

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

用到的变量

变量名是否必须备注
GH_USERgithub 的用户名,用于面板管理授权
GH_CLIENTID在 github 上申请
GH_CLIENTSECRET在 github 上申请
GH_BACKUP_USER在 github 上备份哪吒服务端数据库的 github 用户名,不填则与面板管理授权的账户 GH_USER 一致
GH_REPO在 github 上备份哪吒服务端数据库文件的 github 库
GH_EMAILgithub 的邮箱,用于备份的 git 推送到远程库
GH_PATgithub 的 PAT
ARGO_AUTHJson: 从 https://fscarmen.cloudflare.now.cc 获取的 Argo Json
Token: 从 Cloudflare 官网获取
DATA_DOMAIN客户端与服务端的通信 argo 域名
WEB_DOMAIN面板 argo 域名
SSH_DOMAINssh 用的 argo 域名
SSH_PASSWORDssh 的密码,只有在设置 SSH_JSON 后才生效,默认值 password

Koyeb

Deploy to Koyeb

imageimageimageimageimage

VPS 部署实例

docker 部署

docker run -dit \\
+import{_ as a,o as e,c as s,R as t}from"./chunks/framework.44fd0451.js";const u=JSON.parse('{"title":"使用 Argo 隧道的哪吒服务端","description":"","frontmatter":{},"headers":[],"relativePath":"case/case5.md","filePath":"case/case5.md","lastUpdated":1698335020000}'),n={name:"case/case5.md"},l=t(`

使用 Argo 隧道的哪吒服务端

贡献者:

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

镜像备份(非实时更新):Argo-Nezha-Service-Container


目录


项目特点:

  • 适用范围更广 --- 只要能连通网络,就能安装哪吒服务端,如 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

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

Argo 隧道认证方式有 json 和 token,使用两个方式其中之一

(方式 1 - Josn):

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

image

到 Cloudflare 官网,在相应的域名 DNS 记录里加上客户端上报数据(tcp)和 ssh(可选)的域名,打开橙色云启用 CDN

imageimage

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

到 cf 官网:https://dash.cloudflare.com/ ,进入 zero trust 里生成 token 隧道和信息。

imageimageimageimageimageimageimage

准备需要用的变量

  • 到 Cloudflare 官网,选择使用的域名,打开 网络 选项将 gRPC 开关打开
image

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

imageimageimageimageimage

PaaS 部署实例

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

用到的变量

变量名是否必须备注
GH_USERgithub 的用户名,用于面板管理授权
GH_CLIENTID在 github 上申请
GH_CLIENTSECRET在 github 上申请
GH_BACKUP_USER在 github 上备份哪吒服务端数据库的 github 用户名,不填则与面板管理授权的账户 GH_USER 一致
GH_REPO在 github 上备份哪吒服务端数据库文件的 github 库
GH_EMAILgithub 的邮箱,用于备份的 git 推送到远程库
GH_PATgithub 的 PAT
ARGO_AUTHJson: 从 https://fscarmen.cloudflare.now.cc 获取的 Argo Json
Token: 从 Cloudflare 官网获取
DATA_DOMAIN客户端与服务端的通信 argo 域名
WEB_DOMAIN面板 argo 域名
SSH_DOMAINssh 用的 argo 域名
SSH_PASSWORDssh 的密码,只有在设置 SSH_JSON 后才生效,默认值 password

Koyeb

Deploy to Koyeb

imageimageimageimageimage

VPS 部署实例

  • 注意: ARGO_JSON= 后面需要有单引号,不能去掉
  • 如果 VPS 是 IPv6 only 的,请先安装 WARP IPv4 或者双栈: https://github.com/fscarmen/warp
  • 备份目录为当前路径的 dashboard 文件夹

docker 部署

docker run -dit \\
            --name nezha_dashboard \\
            --restart always \\
            -e GH_USER=<填 github 用户名> \\
diff --git a/assets/case_case5.md.7373a3b6.lean.js b/assets/case_case5.md.f67aa872.lean.js
similarity index 85%
rename from assets/case_case5.md.7373a3b6.lean.js
rename to assets/case_case5.md.f67aa872.lean.js
index b8c6858e..460a6182 100644
--- a/assets/case_case5.md.7373a3b6.lean.js
+++ b/assets/case_case5.md.f67aa872.lean.js
@@ -1 +1 @@
-import{_ as a,o as e,c as s,R as t}from"./chunks/framework.44fd0451.js";const u=JSON.parse('{"title":"使用 Argo 隧道的哪吒服务端","description":"","frontmatter":{},"headers":[],"relativePath":"case/case5.md","filePath":"case/case5.md","lastUpdated":1698142262000}'),n={name:"case/case5.md"},l=t("",85),r=[l];function o(c,i,p,h,d,g){return e(),s("div",null,r)}const b=a(n,[["render",o]]);export{u as __pageData,b as default};
+import{_ as a,o as e,c as s,R as t}from"./chunks/framework.44fd0451.js";const u=JSON.parse('{"title":"使用 Argo 隧道的哪吒服务端","description":"","frontmatter":{},"headers":[],"relativePath":"case/case5.md","filePath":"case/case5.md","lastUpdated":1698335020000}'),n={name:"case/case5.md"},l=t("",85),r=[l];function o(c,i,p,h,d,g){return e(),s("div",null,r)}const b=a(n,[["render",o]]);export{u as __pageData,b as default};
diff --git a/assets/case_index.md.349818a1.js b/assets/case_index.md.5872fb68.js
similarity index 88%
rename from assets/case_index.md.349818a1.js
rename to assets/case_index.md.5872fb68.js
index 8dee2710..3b57cd2c 100644
--- a/assets/case_index.md.349818a1.js
+++ b/assets/case_index.md.5872fb68.js
@@ -1 +1 @@
-import{_ as e,o as t,c as a}from"./chunks/framework.44fd0451.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":1698142262000}'),s={name:"case/index.md"};function n(i,r,c,o,d,l){return t(),a("div")}const _=e(s,[["render",n]]);export{p as __pageData,_ as default};
+import{_ as e,o as t,c as a}from"./chunks/framework.44fd0451.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":1698335020000}'),s={name:"case/index.md"};function n(i,r,c,o,d,l){return t(),a("div")}const _=e(s,[["render",n]]);export{p as __pageData,_ as default};
diff --git a/assets/case_index.md.349818a1.lean.js b/assets/case_index.md.5872fb68.lean.js
similarity index 88%
rename from assets/case_index.md.349818a1.lean.js
rename to assets/case_index.md.5872fb68.lean.js
index 8dee2710..3b57cd2c 100644
--- a/assets/case_index.md.349818a1.lean.js
+++ b/assets/case_index.md.5872fb68.lean.js
@@ -1 +1 @@
-import{_ as e,o as t,c as a}from"./chunks/framework.44fd0451.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":1698142262000}'),s={name:"case/index.md"};function n(i,r,c,o,d,l){return t(),a("div")}const _=e(s,[["render",n]]);export{p as __pageData,_ as default};
+import{_ as e,o as t,c as a}from"./chunks/framework.44fd0451.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":1698335020000}'),s={name:"case/index.md"};function n(i,r,c,o,d,l){return t(),a("div")}const _=e(s,[["render",n]]);export{p as __pageData,_ as default};
diff --git a/assets/developer_index.md.6deb69e0.js b/assets/developer_index.md.aa052f9f.js
similarity index 92%
rename from assets/developer_index.md.6deb69e0.js
rename to assets/developer_index.md.aa052f9f.js
index 746e1a65..238e0062 100644
--- a/assets/developer_index.md.6deb69e0.js
+++ b/assets/developer_index.md.aa052f9f.js
@@ -1 +1 @@
-import{_ as e,o as t,c as a}from"./chunks/framework.44fd0451.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":1698142262000}'),r={name:"developer/index.md"};function n(o,s,i,d,l,c){return t(),a("div")}const h=e(r,[["render",n]]);export{m as __pageData,h as default};
+import{_ as e,o as t,c as a}from"./chunks/framework.44fd0451.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":1698335020000}'),r={name:"developer/index.md"};function n(o,s,i,d,l,c){return t(),a("div")}const h=e(r,[["render",n]]);export{m as __pageData,h as default};
diff --git a/assets/developer_index.md.6deb69e0.lean.js b/assets/developer_index.md.aa052f9f.lean.js
similarity index 92%
rename from assets/developer_index.md.6deb69e0.lean.js
rename to assets/developer_index.md.aa052f9f.lean.js
index 746e1a65..238e0062 100644
--- a/assets/developer_index.md.6deb69e0.lean.js
+++ b/assets/developer_index.md.aa052f9f.lean.js
@@ -1 +1 @@
-import{_ as e,o as t,c as a}from"./chunks/framework.44fd0451.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":1698142262000}'),r={name:"developer/index.md"};function n(o,s,i,d,l,c){return t(),a("div")}const h=e(r,[["render",n]]);export{m as __pageData,h as default};
+import{_ as e,o as t,c as a}from"./chunks/framework.44fd0451.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":1698335020000}'),r={name:"developer/index.md"};function n(o,s,i,d,l,c){return t(),a("div")}const h=e(r,[["render",n]]);export{m as __pageData,h as default};
diff --git a/assets/developer_l10n.md.a1c43339.js b/assets/developer_l10n.md.f5974325.js
similarity index 95%
rename from assets/developer_l10n.md.a1c43339.js
rename to assets/developer_l10n.md.f5974325.js
index 4cccd759..4ef6fd27 100644
--- a/assets/developer_l10n.md.a1c43339.js
+++ b/assets/developer_l10n.md.f5974325.js
@@ -1 +1 @@
-import{_ as e,o,c as a,R as t}from"./chunks/framework.44fd0451.js";const u=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"developer/l10n.md","filePath":"developer/l10n.md","lastUpdated":1698142262000}'),l={name:"developer/l10n.md"},r=t('

哪吒监控的 Dashboard 已经添加本地化,支持多个语言,你可以在开发新功能时遵循以下步骤来支持本地化

介绍

  1. 你可以直接使用 /resource/l10n/zh-CN.toml 中已有的文本配置来替换新功能中的文本
  2. 如果新功能中有新增文本,请参考 zh-CN.toml 的配置文本,将新文本拉取到 zh-CN.toml 等其他语言的配置文件中,并添加翻译

新本地化文本的添加

  1. /resource/l10n/ 中添加新的语言文本配置
  2. 在新的语言文本配置中拉取其他语言已有的文本配置
  3. 为新的语言文本配置添加翻译
',5),c=[r];function d(n,i,s,_,h,p){return o(),a("div",null,c)}const f=e(l,[["render",d]]);export{u as __pageData,f as default}; +import{_ as e,o,c as a,R as t}from"./chunks/framework.44fd0451.js";const u=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"developer/l10n.md","filePath":"developer/l10n.md","lastUpdated":1698335020000}'),l={name:"developer/l10n.md"},r=t('

哪吒监控的 Dashboard 已经添加本地化,支持多个语言,你可以在开发新功能时遵循以下步骤来支持本地化

介绍

  1. 你可以直接使用 /resource/l10n/zh-CN.toml 中已有的文本配置来替换新功能中的文本
  2. 如果新功能中有新增文本,请参考 zh-CN.toml 的配置文本,将新文本拉取到 zh-CN.toml 等其他语言的配置文件中,并添加翻译

新本地化文本的添加

  1. /resource/l10n/ 中添加新的语言文本配置
  2. 在新的语言文本配置中拉取其他语言已有的文本配置
  3. 为新的语言文本配置添加翻译
',5),c=[r];function d(n,i,s,_,h,p){return o(),a("div",null,c)}const f=e(l,[["render",d]]);export{u as __pageData,f as default}; diff --git a/assets/developer_l10n.md.a1c43339.lean.js b/assets/developer_l10n.md.f5974325.lean.js similarity index 84% rename from assets/developer_l10n.md.a1c43339.lean.js rename to assets/developer_l10n.md.f5974325.lean.js index 6e055873..54d6bc47 100644 --- a/assets/developer_l10n.md.a1c43339.lean.js +++ b/assets/developer_l10n.md.f5974325.lean.js @@ -1 +1 @@ -import{_ as e,o,c as a,R as t}from"./chunks/framework.44fd0451.js";const u=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"developer/l10n.md","filePath":"developer/l10n.md","lastUpdated":1698142262000}'),l={name:"developer/l10n.md"},r=t("",5),c=[r];function d(n,i,s,_,h,p){return o(),a("div",null,c)}const f=e(l,[["render",d]]);export{u as __pageData,f as default}; +import{_ as e,o,c as a,R as t}from"./chunks/framework.44fd0451.js";const u=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"developer/l10n.md","filePath":"developer/l10n.md","lastUpdated":1698335020000}'),l={name:"developer/l10n.md"},r=t("",5),c=[r];function d(n,i,s,_,h,p){return o(),a("div",null,c)}const f=e(l,[["render",d]]);export{u as __pageData,f as default}; diff --git a/assets/developer_theme.md.7e9c4737.js b/assets/developer_theme.md.2c3f159f.js similarity index 96% rename from assets/developer_theme.md.7e9c4737.js rename to assets/developer_theme.md.2c3f159f.js index 50280970..0eeeb2b3 100644 --- a/assets/developer_theme.md.7e9c4737.js +++ b/assets/developer_theme.md.2c3f159f.js @@ -1 +1 @@ -import{_ as e,o,c as a,R as t}from"./chunks/framework.44fd0451.js";const u=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"developer/theme.md","filePath":"developer/theme.md","lastUpdated":1698142262000}'),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,o,c as a,R as t}from"./chunks/framework.44fd0451.js";const u=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"developer/theme.md","filePath":"developer/theme.md","lastUpdated":1698335020000}'),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.7e9c4737.lean.js b/assets/developer_theme.md.2c3f159f.lean.js similarity index 84% rename from assets/developer_theme.md.7e9c4737.lean.js rename to assets/developer_theme.md.2c3f159f.lean.js index 71971a11..2eb91268 100644 --- a/assets/developer_theme.md.7e9c4737.lean.js +++ b/assets/developer_theme.md.2c3f159f.lean.js @@ -1 +1 @@ -import{_ as e,o,c as a,R as t}from"./chunks/framework.44fd0451.js";const u=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"developer/theme.md","filePath":"developer/theme.md","lastUpdated":1698142262000}'),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,o,c as a,R as t}from"./chunks/framework.44fd0451.js";const u=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"developer/theme.md","filePath":"developer/theme.md","lastUpdated":1698335020000}'),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.bd238d57.js b/assets/en_US_case_case1.md.a91f540d.js similarity index 95% rename from assets/en_US_case_case1.md.bd238d57.js rename to assets/en_US_case_case1.md.a91f540d.js index 0b9ec0fb..2ba5748c 100644 --- a/assets/en_US_case_case1.md.bd238d57.js +++ b/assets/en_US_case_case1.md.a91f540d.js @@ -1 +1 @@ -import{_ as e,o as t,c as r,R as o}from"./chunks/framework.44fd0451.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":1698142262000}'),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 t(),r("div",null,i)}const m=e(a,[["render",s]]);export{d as __pageData,m as default}; +import{_ as e,o as t,c as r,R as o}from"./chunks/framework.44fd0451.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":1698335020000}'),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 t(),r("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.bd238d57.lean.js b/assets/en_US_case_case1.md.a91f540d.lean.js similarity index 86% rename from assets/en_US_case_case1.md.bd238d57.lean.js rename to assets/en_US_case_case1.md.a91f540d.lean.js index 063a7f8b..de2373a6 100644 --- a/assets/en_US_case_case1.md.bd238d57.lean.js +++ b/assets/en_US_case_case1.md.a91f540d.lean.js @@ -1 +1 @@ -import{_ as e,o as t,c as r,R as o}from"./chunks/framework.44fd0451.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":1698142262000}'),a={name:"en_US/case/case1.md"},n=o("",6),i=[n];function s(h,_,l,u,c,p){return t(),r("div",null,i)}const m=e(a,[["render",s]]);export{d as __pageData,m as default}; +import{_ as e,o as t,c as r,R as o}from"./chunks/framework.44fd0451.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":1698335020000}'),a={name:"en_US/case/case1.md"},n=o("",6),i=[n];function s(h,_,l,u,c,p){return t(),r("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.9f71e24b.js b/assets/en_US_case_case2.md.f6dd26ff.js similarity index 97% rename from assets/en_US_case_case2.md.9f71e24b.js rename to assets/en_US_case_case2.md.f6dd26ff.js index 8c3882e0..fa303ad4 100644 --- a/assets/en_US_case_case2.md.9f71e24b.js +++ b/assets/en_US_case_case2.md.f6dd26ff.js @@ -1 +1 @@ -import{_ as e}from"./chunks/qrcode.59c44dde.js";import{_ as t,o as r,c as o,R as s}from"./chunks/framework.44fd0451.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":1698142262000}'),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 r(),o("div",null,i)}const b=t(a,[["render",h]]);export{f as __pageData,b as default}; +import{_ as e}from"./chunks/qrcode.59c44dde.js";import{_ as t,o as r,c as o,R as s}from"./chunks/framework.44fd0451.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":1698335020000}'),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 r(),o("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.9f71e24b.lean.js b/assets/en_US_case_case2.md.f6dd26ff.lean.js similarity index 87% rename from assets/en_US_case_case2.md.9f71e24b.lean.js rename to assets/en_US_case_case2.md.f6dd26ff.lean.js index 97a7e55f..e302e6b6 100644 --- a/assets/en_US_case_case2.md.9f71e24b.lean.js +++ b/assets/en_US_case_case2.md.f6dd26ff.lean.js @@ -1 +1 @@ -import{_ as e}from"./chunks/qrcode.59c44dde.js";import{_ as t,o as r,c as o,R as s}from"./chunks/framework.44fd0451.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":1698142262000}'),a={name:"en_US/case/case2.md"},c=s("",8),i=[c];function h(n,u,l,d,m,_){return r(),o("div",null,i)}const b=t(a,[["render",h]]);export{f as __pageData,b as default}; +import{_ as e}from"./chunks/qrcode.59c44dde.js";import{_ as t,o as r,c as o,R as s}from"./chunks/framework.44fd0451.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":1698335020000}'),a={name:"en_US/case/case2.md"},c=s("",8),i=[c];function h(n,u,l,d,m,_){return r(),o("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.63f1f83e.js b/assets/en_US_case_case3.md.2d18f0db.js similarity index 98% rename from assets/en_US_case_case3.md.63f1f83e.js rename to assets/en_US_case_case3.md.2d18f0db.js index 965f5372..6effb217 100644 --- a/assets/en_US_case_case3.md.63f1f83e.js +++ b/assets/en_US_case_case3.md.2d18f0db.js @@ -1 +1 @@ -import{_ as t,o as e,c as r,R as a}from"./chunks/framework.44fd0451.js";const g=JSON.parse('{"title":"Build your own server status query Telegram bot with multi-language and multi-user support","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/case/case3.md","filePath":"en_US/case/case3.md","lastUpdated":1698142262000}'),d={name:"en_US/case/case3.md"},i=a('

Build your own server status query Telegram bot with multi-language and multi-user support

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),o=[i];function s(l,n,u,h,p,m){return e(),r("div",null,o)}const _=t(d,[["render",s]]);export{g as __pageData,_ as default}; +import{_ as t,o as e,c as r,R as a}from"./chunks/framework.44fd0451.js";const g=JSON.parse('{"title":"Build your own server status query Telegram bot with multi-language and multi-user support","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/case/case3.md","filePath":"en_US/case/case3.md","lastUpdated":1698335020000}'),d={name:"en_US/case/case3.md"},i=a('

Build your own server status query Telegram bot with multi-language and multi-user support

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),o=[i];function s(l,n,u,h,p,m){return e(),r("div",null,o)}const _=t(d,[["render",s]]);export{g as __pageData,_ as default}; diff --git a/assets/en_US_case_case3.md.63f1f83e.lean.js b/assets/en_US_case_case3.md.2d18f0db.lean.js similarity index 87% rename from assets/en_US_case_case3.md.63f1f83e.lean.js rename to assets/en_US_case_case3.md.2d18f0db.lean.js index bd1e2188..1ff82b43 100644 --- a/assets/en_US_case_case3.md.63f1f83e.lean.js +++ b/assets/en_US_case_case3.md.2d18f0db.lean.js @@ -1 +1 @@ -import{_ as t,o as e,c as r,R as a}from"./chunks/framework.44fd0451.js";const g=JSON.parse('{"title":"Build your own server status query Telegram bot with multi-language and multi-user support","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/case/case3.md","filePath":"en_US/case/case3.md","lastUpdated":1698142262000}'),d={name:"en_US/case/case3.md"},i=a("",9),o=[i];function s(l,n,u,h,p,m){return e(),r("div",null,o)}const _=t(d,[["render",s]]);export{g as __pageData,_ as default}; +import{_ as t,o as e,c as r,R as a}from"./chunks/framework.44fd0451.js";const g=JSON.parse('{"title":"Build your own server status query Telegram bot with multi-language and multi-user support","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/case/case3.md","filePath":"en_US/case/case3.md","lastUpdated":1698335020000}'),d={name:"en_US/case/case3.md"},i=a("",9),o=[i];function s(l,n,u,h,p,m){return e(),r("div",null,o)}const _=t(d,[["render",s]]);export{g as __pageData,_ as default}; diff --git a/assets/en_US_case_case4.md.0599b4cb.js b/assets/en_US_case_case4.md.ccb15ad3.js similarity index 94% rename from assets/en_US_case_case4.md.0599b4cb.js rename to assets/en_US_case_case4.md.ccb15ad3.js index 2fa53cdb..3e618ecf 100644 --- a/assets/en_US_case_case4.md.0599b4cb.js +++ b/assets/en_US_case_case4.md.ccb15ad3.js @@ -1 +1 @@ -import{_ as e,o as a,c as t,R as r}from"./chunks/framework.44fd0451.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":1698142262000}'),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 a(),t("div",null,i)}const m=e(n,[["render",s]]);export{g as __pageData,m as default}; +import{_ as e,o as a,c as t,R as r}from"./chunks/framework.44fd0451.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":1698335020000}'),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 a(),t("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.0599b4cb.lean.js b/assets/en_US_case_case4.md.ccb15ad3.lean.js similarity index 85% rename from assets/en_US_case_case4.md.0599b4cb.lean.js rename to assets/en_US_case_case4.md.ccb15ad3.lean.js index 83c05457..997be366 100644 --- a/assets/en_US_case_case4.md.0599b4cb.lean.js +++ b/assets/en_US_case_case4.md.ccb15ad3.lean.js @@ -1 +1 @@ -import{_ as e,o as a,c as t,R as r}from"./chunks/framework.44fd0451.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":1698142262000}'),n={name:"en_US/case/case4.md"},o=r("",5),i=[o];function s(c,h,_,d,f,l){return a(),t("div",null,i)}const m=e(n,[["render",s]]);export{g as __pageData,m as default}; +import{_ as e,o as a,c as t,R as r}from"./chunks/framework.44fd0451.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":1698335020000}'),n={name:"en_US/case/case4.md"},o=r("",5),i=[o];function s(c,h,_,d,f,l){return a(),t("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.75c022d0.js b/assets/en_US_case_case5.md.1dd4e304.js similarity index 99% rename from assets/en_US_case_case5.md.75c022d0.js rename to assets/en_US_case_case5.md.1dd4e304.js index d2375b2f..4df58948 100644 --- a/assets/en_US_case_case5.md.75c022d0.js +++ b/assets/en_US_case_case5.md.1dd4e304.js @@ -1,4 +1,4 @@ -import{_ as e,o as a,c as t,R as n}from"./chunks/framework.44fd0451.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":1698142262000}'),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 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

How to get Argo authentication: json or token

The Argo Tunnel authentication methods are json and token, use one of the two methods.

(Methods 1 - Josn):

Easily get Argo tunnel json information through Cloudflare Json Generation Network: https://fscarmen.cloudflare.now.cc

image

Visit Cloudflare website, add the domain name of the client reporting data (tcp) and ssh (optional) in the DNS record of the corresponding domain, and turn on Orange Cloud to enable CDN.

imageimage

(Methods 2 - Token): Manually generate Argo tunnel token information via Cloudflare website.

Go to the cf website: https://dash.cloudflare.com/ and go to zero trust to generate token tunnels and messages.

imageimageimageimageimageimageimage

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

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
DATA_DOMAINYesClient-server communication argo domain name
WEB_DOMAINYesPanel argo domain
SSH_DOMAINNossh for argo domain
SSH_PASSWORDnopassword for ssh, only works after setting SSH_JSON, default password

Koyeb

Deploy to Koyeb

imageimageimageimageimage

VPS Deployment Example

  • Note: ARGO_JSON= 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,o as a,c as t,R as n}from"./chunks/framework.44fd0451.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":1698335020000}'),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 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

How to get Argo authentication: json or token

The Argo Tunnel authentication methods are json and token, use one of the two methods.

(Methods 1 - Josn):

Easily get Argo tunnel json information through Cloudflare Json Generation Network: https://fscarmen.cloudflare.now.cc

image

Visit Cloudflare website, add the domain name of the client reporting data (tcp) and ssh (optional) in the DNS record of the corresponding domain, and turn on Orange Cloud to enable CDN.

imageimage

(Methods 2 - Token): Manually generate Argo tunnel token information via Cloudflare website.

Go to the cf website: https://dash.cloudflare.com/ and go to zero trust to generate token tunnels and messages.

imageimageimageimageimageimageimage

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

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
DATA_DOMAINYesClient-server communication argo domain name
WEB_DOMAINYesPanel argo domain
SSH_DOMAINNossh for argo domain
SSH_PASSWORDnopassword for ssh, only works after setting SSH_JSON, default password

Koyeb

Deploy to Koyeb

imageimageimageimageimage

VPS Deployment Example

  • Note: ARGO_JSON= 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 \\
            --restart always \\
            -e GH_USER=<fill in github username> \\
diff --git a/assets/en_US_case_case5.md.75c022d0.lean.js b/assets/en_US_case_case5.md.1dd4e304.lean.js
similarity index 85%
rename from assets/en_US_case_case5.md.75c022d0.lean.js
rename to assets/en_US_case_case5.md.1dd4e304.lean.js
index d692a5d7..ea253e74 100644
--- a/assets/en_US_case_case5.md.75c022d0.lean.js
+++ b/assets/en_US_case_case5.md.1dd4e304.lean.js
@@ -1 +1 @@
-import{_ as e,o as a,c as t,R as n}from"./chunks/framework.44fd0451.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":1698142262000}'),s={name:"en_US/case/case5.md"},o=n("",85),r=[o];function l(i,c,h,d,p,m){return a(),t("div",null,r)}const f=e(s,[["render",l]]);export{g as __pageData,f as default};
+import{_ as e,o as a,c as t,R as n}from"./chunks/framework.44fd0451.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":1698335020000}'),s={name:"en_US/case/case5.md"},o=n("",85),r=[o];function l(i,c,h,d,p,m){return a(),t("div",null,r)}const f=e(s,[["render",l]]);export{g as __pageData,f as default};
diff --git a/assets/en_US_case_index.md.e1cdf48e.js b/assets/en_US_case_index.md.a39cc88b.js
similarity index 95%
rename from assets/en_US_case_index.md.e1cdf48e.js
rename to assets/en_US_case_index.md.a39cc88b.js
index adf24d9c..cd70ac04 100644
--- a/assets/en_US_case_index.md.e1cdf48e.js
+++ b/assets/en_US_case_index.md.a39cc88b.js
@@ -1 +1 @@
-import{_ as e,o as t,c as a}from"./chunks/framework.44fd0451.js";const u=JSON.parse('{"title":"Nezha Monitoring","titleTemplate":"Community Project","description":"","frontmatter":{"layout":"home","title":"Nezha Monitoring","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":1698142262000}'),o={name:"en_US/case/index.md"};function i(n,r,s,c,m,l){return t(),a("div")}const h=e(o,[["render",i]]);export{u as __pageData,h as default};
+import{_ as e,o as t,c as a}from"./chunks/framework.44fd0451.js";const u=JSON.parse('{"title":"Nezha Monitoring","titleTemplate":"Community Project","description":"","frontmatter":{"layout":"home","title":"Nezha Monitoring","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":1698335020000}'),o={name:"en_US/case/index.md"};function i(n,r,s,c,m,l){return t(),a("div")}const h=e(o,[["render",i]]);export{u as __pageData,h as default};
diff --git a/assets/en_US_case_index.md.e1cdf48e.lean.js b/assets/en_US_case_index.md.a39cc88b.lean.js
similarity index 95%
rename from assets/en_US_case_index.md.e1cdf48e.lean.js
rename to assets/en_US_case_index.md.a39cc88b.lean.js
index adf24d9c..cd70ac04 100644
--- a/assets/en_US_case_index.md.e1cdf48e.lean.js
+++ b/assets/en_US_case_index.md.a39cc88b.lean.js
@@ -1 +1 @@
-import{_ as e,o as t,c as a}from"./chunks/framework.44fd0451.js";const u=JSON.parse('{"title":"Nezha Monitoring","titleTemplate":"Community Project","description":"","frontmatter":{"layout":"home","title":"Nezha Monitoring","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":1698142262000}'),o={name:"en_US/case/index.md"};function i(n,r,s,c,m,l){return t(),a("div")}const h=e(o,[["render",i]]);export{u as __pageData,h as default};
+import{_ as e,o as t,c as a}from"./chunks/framework.44fd0451.js";const u=JSON.parse('{"title":"Nezha Monitoring","titleTemplate":"Community Project","description":"","frontmatter":{"layout":"home","title":"Nezha Monitoring","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":1698335020000}'),o={name:"en_US/case/index.md"};function i(n,r,s,c,m,l){return t(),a("div")}const h=e(o,[["render",i]]);export{u as __pageData,h as default};
diff --git a/assets/en_US_developer_index.md.7cc3c922.js b/assets/en_US_developer_index.md.bf3e515a.js
similarity index 91%
rename from assets/en_US_developer_index.md.7cc3c922.js
rename to assets/en_US_developer_index.md.bf3e515a.js
index aa29c50f..8eaf578a 100644
--- a/assets/en_US_developer_index.md.7cc3c922.js
+++ b/assets/en_US_developer_index.md.bf3e515a.js
@@ -1 +1 @@
-import{_ as e,o as t,c as a}from"./chunks/framework.44fd0451.js";const c=JSON.parse('{"title":"Nezha Monitoring","titleTemplate":"Development Manual","description":"","frontmatter":{"layout":"home","title":"Nezha Monitoring","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":1698142262000}'),n={name:"en_US/developer/index.md"};function o(r,i,l,s,p,d){return t(),a("div")}const _=e(n,[["render",o]]);export{c as __pageData,_ as default};
+import{_ as e,o as t,c as a}from"./chunks/framework.44fd0451.js";const c=JSON.parse('{"title":"Nezha Monitoring","titleTemplate":"Development Manual","description":"","frontmatter":{"layout":"home","title":"Nezha Monitoring","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":1698335020000}'),n={name:"en_US/developer/index.md"};function o(r,i,l,s,p,d){return t(),a("div")}const _=e(n,[["render",o]]);export{c as __pageData,_ as default};
diff --git a/assets/en_US_developer_index.md.7cc3c922.lean.js b/assets/en_US_developer_index.md.bf3e515a.lean.js
similarity index 91%
rename from assets/en_US_developer_index.md.7cc3c922.lean.js
rename to assets/en_US_developer_index.md.bf3e515a.lean.js
index aa29c50f..8eaf578a 100644
--- a/assets/en_US_developer_index.md.7cc3c922.lean.js
+++ b/assets/en_US_developer_index.md.bf3e515a.lean.js
@@ -1 +1 @@
-import{_ as e,o as t,c as a}from"./chunks/framework.44fd0451.js";const c=JSON.parse('{"title":"Nezha Monitoring","titleTemplate":"Development Manual","description":"","frontmatter":{"layout":"home","title":"Nezha Monitoring","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":1698142262000}'),n={name:"en_US/developer/index.md"};function o(r,i,l,s,p,d){return t(),a("div")}const _=e(n,[["render",o]]);export{c as __pageData,_ as default};
+import{_ as e,o as t,c as a}from"./chunks/framework.44fd0451.js";const c=JSON.parse('{"title":"Nezha Monitoring","titleTemplate":"Development Manual","description":"","frontmatter":{"layout":"home","title":"Nezha Monitoring","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":1698335020000}'),n={name:"en_US/developer/index.md"};function o(r,i,l,s,p,d){return t(),a("div")}const _=e(n,[["render",o]]);export{c as __pageData,_ as default};
diff --git a/assets/en_US_developer_l10n.md.741f9b21.js b/assets/en_US_developer_l10n.md.b9c02869.js
similarity index 96%
rename from assets/en_US_developer_l10n.md.741f9b21.js
rename to assets/en_US_developer_l10n.md.b9c02869.js
index cf2cc948..98c7ec36 100644
--- a/assets/en_US_developer_l10n.md.741f9b21.js
+++ b/assets/en_US_developer_l10n.md.b9c02869.js
@@ -1 +1 @@
-import{_ as e,o as t,c as a,R as n}from"./chunks/framework.44fd0451.js";const g=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/developer/l10n.md","filePath":"en_US/developer/l10n.md","lastUpdated":1698142262000}'),o={name:"en_US/developer/l10n.md"},i=n('

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.
',5),l=[i];function r(d,c,s,u,h,f){return t(),a("div",null,l)}const p=e(o,[["render",r]]);export{g as __pageData,p as default}; +import{_ as e,o as t,c as a,R as n}from"./chunks/framework.44fd0451.js";const g=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/developer/l10n.md","filePath":"en_US/developer/l10n.md","lastUpdated":1698335020000}'),o={name:"en_US/developer/l10n.md"},i=n('

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.
',5),l=[i];function r(d,c,s,u,h,f){return t(),a("div",null,l)}const p=e(o,[["render",r]]);export{g as __pageData,p as default}; diff --git a/assets/en_US_developer_l10n.md.741f9b21.lean.js b/assets/en_US_developer_l10n.md.b9c02869.lean.js similarity index 85% rename from assets/en_US_developer_l10n.md.741f9b21.lean.js rename to assets/en_US_developer_l10n.md.b9c02869.lean.js index 8c009ed6..654ef1c2 100644 --- a/assets/en_US_developer_l10n.md.741f9b21.lean.js +++ b/assets/en_US_developer_l10n.md.b9c02869.lean.js @@ -1 +1 @@ -import{_ as e,o as t,c as a,R as n}from"./chunks/framework.44fd0451.js";const g=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/developer/l10n.md","filePath":"en_US/developer/l10n.md","lastUpdated":1698142262000}'),o={name:"en_US/developer/l10n.md"},i=n("",5),l=[i];function r(d,c,s,u,h,f){return t(),a("div",null,l)}const p=e(o,[["render",r]]);export{g as __pageData,p as default}; +import{_ as e,o as t,c as a,R as n}from"./chunks/framework.44fd0451.js";const g=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/developer/l10n.md","filePath":"en_US/developer/l10n.md","lastUpdated":1698335020000}'),o={name:"en_US/developer/l10n.md"},i=n("",5),l=[i];function r(d,c,s,u,h,f){return t(),a("div",null,l)}const p=e(o,[["render",r]]);export{g as __pageData,p as default}; diff --git a/assets/en_US_developer_theme.md.72c4fa5f.js b/assets/en_US_developer_theme.md.dee4e013.js similarity index 96% rename from assets/en_US_developer_theme.md.72c4fa5f.js rename to assets/en_US_developer_theme.md.dee4e013.js index 723e9780..1a23fd99 100644 --- a/assets/en_US_developer_theme.md.72c4fa5f.js +++ b/assets/en_US_developer_theme.md.dee4e013.js @@ -1 +1 @@ -import{_ as e,o,c as t,R as a}from"./chunks/framework.44fd0451.js";const _=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/developer/theme.md","filePath":"en_US/developer/theme.md","lastUpdated":1698142262000}'),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 o(),t("div",null,r)}const v=e(n,[["render",l]]);export{_ as __pageData,v as default}; +import{_ as e,o,c as t,R as a}from"./chunks/framework.44fd0451.js";const _=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/developer/theme.md","filePath":"en_US/developer/theme.md","lastUpdated":1698335020000}'),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 o(),t("div",null,r)}const v=e(n,[["render",l]]);export{_ as __pageData,v as default}; diff --git a/assets/en_US_developer_theme.md.72c4fa5f.lean.js b/assets/en_US_developer_theme.md.dee4e013.lean.js similarity index 84% rename from assets/en_US_developer_theme.md.72c4fa5f.lean.js rename to assets/en_US_developer_theme.md.dee4e013.lean.js index e15ad011..f8218b02 100644 --- a/assets/en_US_developer_theme.md.72c4fa5f.lean.js +++ b/assets/en_US_developer_theme.md.dee4e013.lean.js @@ -1 +1 @@ -import{_ as e,o,c as t,R as a}from"./chunks/framework.44fd0451.js";const _=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/developer/theme.md","filePath":"en_US/developer/theme.md","lastUpdated":1698142262000}'),n={name:"en_US/developer/theme.md"},c=a("",7),r=[c];function l(i,h,d,s,m,p){return o(),t("div",null,r)}const v=e(n,[["render",l]]);export{_ as __pageData,v as default}; +import{_ as e,o,c as t,R as a}from"./chunks/framework.44fd0451.js";const _=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/developer/theme.md","filePath":"en_US/developer/theme.md","lastUpdated":1698335020000}'),n={name:"en_US/developer/theme.md"},c=a("",7),r=[c];function l(i,h,d,s,m,p){return o(),t("div",null,r)}const v=e(n,[["render",l]]);export{_ as __pageData,v as default}; diff --git a/assets/en_US_guide_agent.md.131ad39b.js b/assets/en_US_guide_agent.md.087eb20d.js similarity index 99% rename from assets/en_US_guide_agent.md.131ad39b.js rename to assets/en_US_guide_agent.md.087eb20d.js index 6786fea5..3ed987b9 100644 --- a/assets/en_US_guide_agent.md.131ad39b.js +++ b/assets/en_US_guide_agent.md.087eb20d.js @@ -1,4 +1,4 @@ -import{_ as s,o as n,c as a,R as l}from"./chunks/framework.44fd0451.js";const h=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/guide/agent.md","filePath":"en_US/guide/agent.md","lastUpdated":1698142262000}'),o={name:"en_US/guide/agent.md"},e=l(`

The service in the monitored server is called Agent. This document will describe how to install the Agent on the monitored server and connect it with Dashboard

TIP

Agent binary repository: https://github.com/nezhahq/agent/releases

Install Agent using one-click script

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

Preparation

First of all, you need to set up the communication domain name in the settings page of the admin panel, this domain name can not connect to the CDN, here is the sample communication domain name "data.example.com" mentioned earlier for demonstration
Enter the administration panel, go to the "Settings" page, in the item "CDN Bypassed Domain/IP ", fill in the communication domain name, and then click "Save"

One-click installation on Linux (Ubuntu, Debian, CentOS)

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

One-click installation on Windows

  • First add a server in the admin panel
  • Click on the green Linux icon button next to the newly added server and copy the one-click installation command
  • Login to Windows Server, open PowerShell, and run the copied installation command in PowerShell
  • If you encounter the prompt "Implement Policy Change" please select Y
  • Wait for the installation to complete and return to the Dashboard home page to see if the server is online



Other ways to install Agent


Installing Agent on Linux (Ubuntu, Debian, CentOS)

  • First add a server in the admin panel
  • In the monitored server, run the script:
bash
curl -L https://raw.githubusercontent.com/naiba/nezha/master/script/install_en.sh  -o nezha.sh && chmod +x nezha.sh && sudo ./nezha.sh
  • Select “Install_agent”

  • Input the communication domain name, e.g. "data.example.com"

  • Input RPC port, default is 5555

  • Input the Agent Secret, which is generated when adding a server in the administration panel and can be found in the " Servers " page of the administration panel

  • Wait for the installation to complete and return to the Dashboard home page to see if the server is online

Installing Agent on other Linux (such as alpine use oprec not systemd)

Contributed by unknown0054

  • Edit SERVER,SECRET,TLS then run it in Shell
shell
cat >/etc/init.d/nezha-agent<< EOF
+import{_ as s,o as n,c as a,R as l}from"./chunks/framework.44fd0451.js";const h=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/guide/agent.md","filePath":"en_US/guide/agent.md","lastUpdated":1698335020000}'),o={name:"en_US/guide/agent.md"},e=l(`

The service in the monitored server is called Agent. This document will describe how to install the Agent on the monitored server and connect it with Dashboard

TIP

Agent binary repository: https://github.com/nezhahq/agent/releases

Install Agent using one-click script

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

Preparation

First of all, you need to set up the communication domain name in the settings page of the admin panel, this domain name can not connect to the CDN, here is the sample communication domain name "data.example.com" mentioned earlier for demonstration
Enter the administration panel, go to the "Settings" page, in the item "CDN Bypassed Domain/IP ", fill in the communication domain name, and then click "Save"

One-click installation on Linux (Ubuntu, Debian, CentOS)

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

One-click installation on Windows

  • First add a server in the admin panel
  • Click on the green Linux icon button next to the newly added server and copy the one-click installation command
  • Login to Windows Server, open PowerShell, and run the copied installation command in PowerShell
  • If you encounter the prompt "Implement Policy Change" please select Y
  • Wait for the installation to complete and return to the Dashboard home page to see if the server is online



Other ways to install Agent


Installing Agent on Linux (Ubuntu, Debian, CentOS)

  • First add a server in the admin panel
  • In the monitored server, run the script:
bash
curl -L https://raw.githubusercontent.com/naiba/nezha/master/script/install_en.sh  -o nezha.sh && chmod +x nezha.sh && sudo ./nezha.sh
  • Select “Install_agent”

  • Input the communication domain name, e.g. "data.example.com"

  • Input RPC port, default is 5555

  • Input the Agent Secret, which is generated when adding a server in the administration panel and can be found in the " Servers " page of the administration panel

  • Wait for the installation to complete and return to the Dashboard home page to see if the server is online

Installing Agent on other Linux (such as alpine use oprec not systemd)

Contributed by unknown0054

  • Edit SERVER,SECRET,TLS then run it in Shell
shell
cat >/etc/init.d/nezha-agent<< EOF
 #!/sbin/openrc-run
 SERVER="" #Dashboard address ip:port
 SECRET="" #SECRET
diff --git a/assets/en_US_guide_agent.md.131ad39b.lean.js b/assets/en_US_guide_agent.md.087eb20d.lean.js
similarity index 84%
rename from assets/en_US_guide_agent.md.131ad39b.lean.js
rename to assets/en_US_guide_agent.md.087eb20d.lean.js
index 427d937b..f384c372 100644
--- a/assets/en_US_guide_agent.md.131ad39b.lean.js
+++ b/assets/en_US_guide_agent.md.087eb20d.lean.js
@@ -1 +1 @@
-import{_ as s,o as n,c as a,R as l}from"./chunks/framework.44fd0451.js";const h=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/guide/agent.md","filePath":"en_US/guide/agent.md","lastUpdated":1698142262000}'),o={name:"en_US/guide/agent.md"},e=l("",53),p=[e];function t(r,c,i,D,y,C){return n(),a("div",null,p)}const u=s(o,[["render",t]]);export{h as __pageData,u as default};
+import{_ as s,o as n,c as a,R as l}from"./chunks/framework.44fd0451.js";const h=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/guide/agent.md","filePath":"en_US/guide/agent.md","lastUpdated":1698335020000}'),o={name:"en_US/guide/agent.md"},e=l("",53),p=[e];function t(r,c,i,D,y,C){return n(),a("div",null,p)}const u=s(o,[["render",t]]);export{h as __pageData,u as default};
diff --git a/assets/en_US_guide_agentq.md.16d0b37a.js b/assets/en_US_guide_agentq.md.30f39c02.js
similarity index 96%
rename from assets/en_US_guide_agentq.md.16d0b37a.js
rename to assets/en_US_guide_agentq.md.30f39c02.js
index 43981d93..2fa66238 100644
--- a/assets/en_US_guide_agentq.md.16d0b37a.js
+++ b/assets/en_US_guide_agentq.md.30f39c02.js
@@ -1 +1 @@
-import{_ as e,o as a,c as t,R as n}from"./chunks/framework.44fd0451.js";const _=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/guide/agentq.md","filePath":"en_US/guide/agentq.md","lastUpdated":1698142262000}'),o={name:"en_US/guide/agentq.md"},i=n('

Why the IP displayed in the admin panel and the actual IP of the Agent are not the same?

Please check Dashboard - Why the IP displayed in the admin panel and the actual IP of the Agent are not the same?

Error on one-click script installation

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

Please check if your server can connect to Github, try again, or check Other ways to install Agent

sudo: command not found

Please install sudo first

',7),r=[i];function c(h,d,l,s,u,p){return a(),t("div",null,r)}const f=e(o,[["render",c]]);export{_ as __pageData,f as default}; +import{_ as e,o as a,c as t,R as n}from"./chunks/framework.44fd0451.js";const _=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/guide/agentq.md","filePath":"en_US/guide/agentq.md","lastUpdated":1698335020000}'),o={name:"en_US/guide/agentq.md"},i=n('

Why the IP displayed in the admin panel and the actual IP of the Agent are not the same?

Please check Dashboard - Why the IP displayed in the admin panel and the actual IP of the Agent are not the same?

Error on one-click script installation

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

Please check if your server can connect to Github, try again, or check Other ways to install Agent

sudo: command not found

Please install sudo first

',7),r=[i];function c(h,d,l,s,u,p){return a(),t("div",null,r)}const f=e(o,[["render",c]]);export{_ as __pageData,f as default}; diff --git a/assets/en_US_guide_agentq.md.16d0b37a.lean.js b/assets/en_US_guide_agentq.md.30f39c02.lean.js similarity index 84% rename from assets/en_US_guide_agentq.md.16d0b37a.lean.js rename to assets/en_US_guide_agentq.md.30f39c02.lean.js index ee4fc823..a86b4137 100644 --- a/assets/en_US_guide_agentq.md.16d0b37a.lean.js +++ b/assets/en_US_guide_agentq.md.30f39c02.lean.js @@ -1 +1 @@ -import{_ as e,o as a,c as t,R as n}from"./chunks/framework.44fd0451.js";const _=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/guide/agentq.md","filePath":"en_US/guide/agentq.md","lastUpdated":1698142262000}'),o={name:"en_US/guide/agentq.md"},i=n("",7),r=[i];function c(h,d,l,s,u,p){return a(),t("div",null,r)}const f=e(o,[["render",c]]);export{_ as __pageData,f as default}; +import{_ as e,o as a,c as t,R as n}from"./chunks/framework.44fd0451.js";const _=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/guide/agentq.md","filePath":"en_US/guide/agentq.md","lastUpdated":1698335020000}'),o={name:"en_US/guide/agentq.md"},i=n("",7),r=[i];function c(h,d,l,s,u,p){return a(),t("div",null,r)}const f=e(o,[["render",c]]);export{_ as __pageData,f as default}; diff --git a/assets/en_US_guide_api.md.a594b6e2.js b/assets/en_US_guide_api.md.b16103f8.js similarity index 99% rename from assets/en_US_guide_api.md.a594b6e2.js rename to assets/en_US_guide_api.md.b16103f8.js index ebc29ab6..98fedd07 100644 --- a/assets/en_US_guide_api.md.a594b6e2.js +++ b/assets/en_US_guide_api.md.b16103f8.js @@ -1,4 +1,4 @@ -import{_ as s,o as n,c as a,R as o}from"./chunks/framework.44fd0451.js";const y=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/guide/api.md","filePath":"en_US/guide/api.md","lastUpdated":1698142262000}'),t={name:"en_US/guide/api.md"},e=o(`

Nezha Monitoring now supports querying the status information of the Agent in the Dashboard using the API

Create Token

API allows Token authentication method and Cookies authentication method
To create a new Token, after entering the admin panel, click on the avatar in the upper right corner and select "API Token" to enter the Token management page
Click "Add Token" and after customizing the notes, click "Add"
To delete a Token, please select the corresponding Token and click the delete icon on the right

WARNING

Token is the authentication tool of API, it is very important for your Dashboard's information security, please don't leak your Token to others

Authentication method

Token authentication method:

Request Headers:  
+import{_ as s,o as n,c as a,R as o}from"./chunks/framework.44fd0451.js";const y=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/guide/api.md","filePath":"en_US/guide/api.md","lastUpdated":1698335020000}'),t={name:"en_US/guide/api.md"},e=o(`

Nezha Monitoring now supports querying the status information of the Agent in the Dashboard using the API

Create Token

API allows Token authentication method and Cookies authentication method
To create a new Token, after entering the admin panel, click on the avatar in the upper right corner and select "API Token" to enter the Token management page
Click "Add Token" and after customizing the notes, click "Add"
To delete a Token, please select the corresponding Token and click the delete icon on the right

WARNING

Token is the authentication tool of API, it is very important for your Dashboard's information security, please don't leak your Token to others

Authentication method

Token authentication method:

Request Headers:  
 Authorization: Token

How to use

WARNING

The negative timestamp in the example below is (0000-00-00)
It is currently used to indicate that the Agent has never reported since the Dashboard went live
However, it is not recommended to use positivity or negativity to determine the status

TIP

The request method is Get and the return format is JSON.

  • Get a list of servers: GET /api/v1/server/list?tag=
    query: tag (ServerTag means the group of servers, if this value is provided, only the servers in this group are queried)

JSON Return Example:

{
     "code": 0,
     "message": "success",
diff --git a/assets/en_US_guide_api.md.a594b6e2.lean.js b/assets/en_US_guide_api.md.b16103f8.lean.js
similarity index 84%
rename from assets/en_US_guide_api.md.a594b6e2.lean.js
rename to assets/en_US_guide_api.md.b16103f8.lean.js
index d0eed179..02e36748 100644
--- a/assets/en_US_guide_api.md.a594b6e2.lean.js
+++ b/assets/en_US_guide_api.md.b16103f8.lean.js
@@ -1 +1 @@
-import{_ as s,o as n,c as a,R as o}from"./chunks/framework.44fd0451.js";const y=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/guide/api.md","filePath":"en_US/guide/api.md","lastUpdated":1698142262000}'),t={name:"en_US/guide/api.md"},e=o("",16),l=[e];function p(u,c,i,r,q,C){return n(),a("div",null,l)}const d=s(t,[["render",p]]);export{y as __pageData,d as default};
+import{_ as s,o as n,c as a,R as o}from"./chunks/framework.44fd0451.js";const y=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/guide/api.md","filePath":"en_US/guide/api.md","lastUpdated":1698335020000}'),t={name:"en_US/guide/api.md"},e=o("",16),l=[e];function p(u,c,i,r,q,C){return n(),a("div",null,l)}const d=s(t,[["render",p]]);export{y as __pageData,d as default};
diff --git a/assets/en_US_guide_dashboard.md.b1edb021.js b/assets/en_US_guide_dashboard.md.3cc0021a.js
similarity index 99%
rename from assets/en_US_guide_dashboard.md.b1edb021.js
rename to assets/en_US_guide_dashboard.md.3cc0021a.js
index 2c151fea..5aceeedc 100644
--- a/assets/en_US_guide_dashboard.md.b1edb021.js
+++ b/assets/en_US_guide_dashboard.md.3cc0021a.js
@@ -1,4 +1,4 @@
-import{_ as e,o as a,c as t,R as o}from"./chunks/framework.44fd0451.js";const y=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/guide/dashboard.md","filePath":"en_US/guide/dashboard.md","lastUpdated":1698142262000}'),s={name:"en_US/guide/dashboard.md"},n=o(`

Preparations

To setup a Nezha monitorning Dashboard, you need these things:

  1. A VPS that can connect to the Internet, firewall and security policies need to open ports 8008 and 5555, otherwise it will be inaccessible and unable to receive data. A 1 core 512MB RAM server is sufficient for most usage scenarios
  2. A domain name that has been set up with an A record that resolves to the Dashboard server IP

TIP

If you want to use CDN, please prepare two domains, one connect to CDN for public access, CDN needs to support WebSocket protocol; the other domain should not connect to CDN, use it as Agent to send data to Dashboard.
This document uses "cdn.example.com" and "data.example.com" domains to demonstrate respectively

  1. A Github or Gitlab account

This document will use the aaPanel as an example, with future versions of the changes, some of the features may change, this document is for reference only

WARNING

This project does not rely on aaPanel, you can choose to use any server panel you like, and if you are capable enough, you can manually install NginX or Caddy to configure SSL and reverse proxy.
If you don't think it's necessary to use port 80 or 443 to access Dashboard, you don't even need to install NginX and you can just use the install script.



Get the Client ID and Client Secret on Github/Gitlab

Nezha Monitor uses a Github account as the login account for the admin panel

  • First we need to create a new authentication application, after logging into Github, open https://github.com/settings/developers and select "OAuth Apps" - "New OAuth App "
    Application name - Fill in as you like
    Homepage URL - Fill in the panel's access domain name, such as: "http://cdn.example.com"
    Authorization callback URL - Fill in the callback address, e.g., "http://cdn.example.com/oauth2/callback"
  • Click on "Registration Application"
  • Remember the Client ID in the page, then click "Generate a new client secret" to create a new Client Secret, the new secret will be displayed only once, please save it properly

  • If you're using Gitlab, you'll need to go to https://gitlab.com/-/profile/applications to create a new application
  • Fill in Redirect URL with the callback address
  • In Scopes, select read_user and read_api
  • Once created, save the Application ID and Secret

Installing Dashboard on the server

  • In the panel server, run the installation script:
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 waiting for the Docker installation to complete, input the following settings:
    OAuth2 provider - Github or Gitlab
    Client ID - Previously saved Client ID
    Client Secret - Previously saved secret
    GitHub/Gitee login name - Github o Gitlab username
    Site title - Custom site title
    Site access port - Public access port, customizable, default 8008
    RPC port - The communication port between Agent and Dashboard, default 5555

  • After the input is complete, wait to pull the mirror
    After the installation, if everything is fine, you can visit the domain + port number, such as "http://cdn.example.com:8008" to view the Dashboard

  • In the future, if you need to run the script again, you can run:

bash
./nezha.sh

to open the management script


Configure reverse proxy

  • Create a new site in the aaPanel, fill in the public access domain name, such as "http://cdn.example.com", then click "Settings" to enter the site settings option, select " Reverse proxy" - "New reverse proxy"

  • Customize a proxy name, fill in http://127.0.0.1 in the "Target URL" and click "Save"

  • Open the " configuration" to the right of the new reverse proxy you just created and replace the configuration file with the following:

nginx
#PROXY-START/
+import{_ as e,o as a,c as t,R as o}from"./chunks/framework.44fd0451.js";const y=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/guide/dashboard.md","filePath":"en_US/guide/dashboard.md","lastUpdated":1698335020000}'),s={name:"en_US/guide/dashboard.md"},n=o(`

Preparations

To setup a Nezha monitorning Dashboard, you need these things:

  1. A VPS that can connect to the Internet, firewall and security policies need to open ports 8008 and 5555, otherwise it will be inaccessible and unable to receive data. A 1 core 512MB RAM server is sufficient for most usage scenarios
  2. A domain name that has been set up with an A record that resolves to the Dashboard server IP

TIP

If you want to use CDN, please prepare two domains, one connect to CDN for public access, CDN needs to support WebSocket protocol; the other domain should not connect to CDN, use it as Agent to send data to Dashboard.
This document uses "cdn.example.com" and "data.example.com" domains to demonstrate respectively

  1. A Github or Gitlab account

This document will use the aaPanel as an example, with future versions of the changes, some of the features may change, this document is for reference only

WARNING

This project does not rely on aaPanel, you can choose to use any server panel you like, and if you are capable enough, you can manually install NginX or Caddy to configure SSL and reverse proxy.
If you don't think it's necessary to use port 80 or 443 to access Dashboard, you don't even need to install NginX and you can just use the install script.



Get the Client ID and Client Secret on Github/Gitlab

Nezha Monitor uses a Github account as the login account for the admin panel

  • First we need to create a new authentication application, after logging into Github, open https://github.com/settings/developers and select "OAuth Apps" - "New OAuth App "
    Application name - Fill in as you like
    Homepage URL - Fill in the panel's access domain name, such as: "http://cdn.example.com"
    Authorization callback URL - Fill in the callback address, e.g., "http://cdn.example.com/oauth2/callback"
  • Click on "Registration Application"
  • Remember the Client ID in the page, then click "Generate a new client secret" to create a new Client Secret, the new secret will be displayed only once, please save it properly

  • If you're using Gitlab, you'll need to go to https://gitlab.com/-/profile/applications to create a new application
  • Fill in Redirect URL with the callback address
  • In Scopes, select read_user and read_api
  • Once created, save the Application ID and Secret

Installing Dashboard on the server

  • In the panel server, run the installation script:
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 waiting for the Docker installation to complete, input the following settings:
    OAuth2 provider - Github or Gitlab
    Client ID - Previously saved Client ID
    Client Secret - Previously saved secret
    GitHub/Gitee login name - Github o Gitlab username
    Site title - Custom site title
    Site access port - Public access port, customizable, default 8008
    RPC port - The communication port between Agent and Dashboard, default 5555

  • After the input is complete, wait to pull the mirror
    After the installation, if everything is fine, you can visit the domain + port number, such as "http://cdn.example.com:8008" to view the Dashboard

  • In the future, if you need to run the script again, you can run:

bash
./nezha.sh

to open the management script


Configure reverse proxy

  • Create a new site in the aaPanel, fill in the public access domain name, such as "http://cdn.example.com", then click "Settings" to enter the site settings option, select " Reverse proxy" - "New reverse proxy"

  • Customize a proxy name, fill in http://127.0.0.1 in the "Target URL" and click "Save"

  • Open the " configuration" to the right of the new reverse proxy you just created and replace the configuration file with the following:

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.b1edb021.lean.js b/assets/en_US_guide_dashboard.md.3cc0021a.lean.js
similarity index 85%
rename from assets/en_US_guide_dashboard.md.b1edb021.lean.js
rename to assets/en_US_guide_dashboard.md.3cc0021a.lean.js
index fc898e4e..b20840da 100644
--- a/assets/en_US_guide_dashboard.md.b1edb021.lean.js
+++ b/assets/en_US_guide_dashboard.md.3cc0021a.lean.js
@@ -1 +1 @@
-import{_ as e,o as a,c as t,R as o}from"./chunks/framework.44fd0451.js";const y=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/guide/dashboard.md","filePath":"en_US/guide/dashboard.md","lastUpdated":1698142262000}'),s={name:"en_US/guide/dashboard.md"},n=o("",41),l=[n];function r(i,p,c,d,h,u){return a(),t("div",null,l)}const m=e(s,[["render",r]]);export{y as __pageData,m as default};
+import{_ as e,o as a,c as t,R as o}from"./chunks/framework.44fd0451.js";const y=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/guide/dashboard.md","filePath":"en_US/guide/dashboard.md","lastUpdated":1698335020000}'),s={name:"en_US/guide/dashboard.md"},n=o("",41),l=[n];function r(i,p,c,d,h,u){return a(),t("div",null,l)}const m=e(s,[["render",r]]);export{y as __pageData,m as default};
diff --git a/assets/en_US_guide_dashboardq.md.f5a177c3.js b/assets/en_US_guide_dashboardq.md.6d0e242b.js
similarity index 98%
rename from assets/en_US_guide_dashboardq.md.f5a177c3.js
rename to assets/en_US_guide_dashboardq.md.6d0e242b.js
index c042e989..9a0422da 100644
--- a/assets/en_US_guide_dashboardq.md.f5a177c3.js
+++ b/assets/en_US_guide_dashboardq.md.6d0e242b.js
@@ -1,4 +1,4 @@
-import{_ as e,o as a,c as s,R as o}from"./chunks/framework.44fd0451.js";const b=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/guide/dashboardq.md","filePath":"en_US/guide/dashboardq.md","lastUpdated":1698142262000}'),t={name:"en_US/guide/dashboardq.md"},n=o(`

Why the IP displayed in the admin panel and the actual IP of the Agent are not the same?

First of all, explain how the IP displayed in the admin panel is gotten: the Agent will request the IP-API every once in a while, get the IP information and report it to the Dashboard, the IP-API currently used can be viewed here: myip.go
If you find that the IP displayed in the admin panel is not the same as the IP provided to you by the service provider, the biggest possibility is that the service provider gave you the entry IP, but the Agent tested out your exit IP. This problem may also occur in BGP servers and Leased line.

TIP

To take a simple and very common example, the service provider to provide you a anti-DDoS server, in order to meet the goals of both DDoS protection and low network disruption rate, the IP provided to you may be the mapped anti-DDoS IP and not the real exit IP of your server

You can also test the exit IP by running the following command in the Agent server:

shell
curl https://ipapi.co/ip/
+import{_ as e,o as a,c as s,R as o}from"./chunks/framework.44fd0451.js";const b=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/guide/dashboardq.md","filePath":"en_US/guide/dashboardq.md","lastUpdated":1698335020000}'),t={name:"en_US/guide/dashboardq.md"},n=o(`

Why the IP displayed in the admin panel and the actual IP of the Agent are not the same?

First of all, explain how the IP displayed in the admin panel is gotten: the Agent will request the IP-API every once in a while, get the IP information and report it to the Dashboard, the IP-API currently used can be viewed here: myip.go
If you find that the IP displayed in the admin panel is not the same as the IP provided to you by the service provider, the biggest possibility is that the service provider gave you the entry IP, but the Agent tested out your exit IP. This problem may also occur in BGP servers and Leased line.

TIP

To take a simple and very common example, the service provider to provide you a anti-DDoS server, in order to meet the goals of both DDoS protection and low network disruption rate, the IP provided to you may be the mapped anti-DDoS IP and not the real exit IP of your server

You can also test the exit IP by running the following command in the Agent server:

shell
curl https://ipapi.co/ip/
 curl ip.sb
 curl ip-api.com

Forgot your access password or deleted your access password

Please view or edit the /opt/nezha/dashboard/data/config.yaml file.
The password is located in the site-viewpassword item.

Dashboard install/restart/update failed: iptables ......

First, try restarting docker and retrying again

shell
systemctl status docker
 systemctl restart docker
diff --git a/assets/en_US_guide_dashboardq.md.f5a177c3.lean.js b/assets/en_US_guide_dashboardq.md.6d0e242b.lean.js
similarity index 70%
rename from assets/en_US_guide_dashboardq.md.f5a177c3.lean.js
rename to assets/en_US_guide_dashboardq.md.6d0e242b.lean.js
index 995dfa6c..8e73d854 100644
--- a/assets/en_US_guide_dashboardq.md.f5a177c3.lean.js
+++ b/assets/en_US_guide_dashboardq.md.6d0e242b.lean.js
@@ -1 +1 @@
-import{_ as e,o as a,c as s,R as o}from"./chunks/framework.44fd0451.js";const b=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/guide/dashboardq.md","filePath":"en_US/guide/dashboardq.md","lastUpdated":1698142262000}'),t={name:"en_US/guide/dashboardq.md"},n=o("",18),l=[n];function r(i,p,c,d,h,y){return a(),s("div",null,l)}const g=e(t,[["render",r]]);export{b as __pageData,g as default};
+import{_ as e,o as a,c as s,R as o}from"./chunks/framework.44fd0451.js";const b=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/guide/dashboardq.md","filePath":"en_US/guide/dashboardq.md","lastUpdated":1698335020000}'),t={name:"en_US/guide/dashboardq.md"},n=o("",18),l=[n];function r(i,p,c,d,h,y){return a(),s("div",null,l)}const g=e(t,[["render",r]]);export{b as __pageData,g as default};
diff --git a/assets/en_US_guide_loginq.md.8c9ac10b.js b/assets/en_US_guide_loginq.md.7cbc69ad.js
similarity index 98%
rename from assets/en_US_guide_loginq.md.8c9ac10b.js
rename to assets/en_US_guide_loginq.md.7cbc69ad.js
index 4e04d878..c0343f9a 100644
--- a/assets/en_US_guide_loginq.md.8c9ac10b.js
+++ b/assets/en_US_guide_loginq.md.7cbc69ad.js
@@ -1 +1 @@
-import{_ as e,o,c as t,R as a}from"./chunks/framework.44fd0451.js";const b=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/guide/loginq.md","filePath":"en_US/guide/loginq.md","lastUpdated":1698142262000}'),r={name:"en_US/guide/loginq.md"},i=a('

Page refuses to connect or timeout after login callback

  1. Your server cannot connect to Github, consider trying several times or switching to Gitlab.
  2. You have configured the wrong callback URL, make sure your callback URL is correct and port and protocol are correct!
  3. An unknown error occurred in Dashboard, you can use the script to check the logs.

TIP

What is a protocol?
In the browser, your domain name ending with :// is the protocol, usually http and https. Since the Dashboard may be accessible by multiple protocols + domain + port combinations under normal deployment, please make sure to choose the most appropriate one as the callback.

How do I check if my callback URL is wrong?

Please make sure the protocol+domain+port displayed by your browser before login and the protocol+domain+port you jump to after login are the same.
Please make sure your path is /oauth2/callback, all lowercase.

Dashboard errors after login

  1. Clear your browser cookies and log in again, or change your browser.
  2. Check the callback address to ensure that your callback address is correct and that both the port and protocol are correct! The address from which the request is initiated needs to be in the same domain as the callback address, and the port, protocol, and domain name (or IP) all need to be consistent.

lookup xxx

DNS resolution failure, in most cases, is due to iptables-related configuration changes.
It is recommended to restart docker first, sudo systemctl restart docker, and then use the script to restart the Dashboard.
If the lookup error still occurs, it is recommended to check whether there are other tools to control iptables, such as Aapanel Firewall.
This problem may also be related to the kernel, please try to change the official kernel.

The authorization method is invalid, or the login callback URL is invalid, expired, or has been revoked

Suggest changing the authentication method to Github/Gitlab.

oauth2: server response missing access_token

It may be caused by a number of factors, the most likely is a network problem, we suggest to check the network and retry.
If you can't solve it, we suggest changing the authentication method to Github/Gitlab.

This user is not the administrator or cannot login

You have logged into the wrong account or configured the wrong username, note that username is not email, you can use a script to modify it.

dial tcp xxx:443 i/o timeout

If the server has network problems, you can restart docker first, sudo systemctl restart docker, and then use the script to restart the Dashboard.
You can also change to another OAuth method if necessary.

net/http: TLS handshake timeout

Same as above.

',20),s=[i];function n(l,c,h,d,u,m){return o(),t("div",null,s)}const k=e(r,[["render",n]]);export{b as __pageData,k as default}; +import{_ as e,o,c as t,R as a}from"./chunks/framework.44fd0451.js";const b=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/guide/loginq.md","filePath":"en_US/guide/loginq.md","lastUpdated":1698335020000}'),r={name:"en_US/guide/loginq.md"},i=a('

Page refuses to connect or timeout after login callback

  1. Your server cannot connect to Github, consider trying several times or switching to Gitlab.
  2. You have configured the wrong callback URL, make sure your callback URL is correct and port and protocol are correct!
  3. An unknown error occurred in Dashboard, you can use the script to check the logs.

TIP

What is a protocol?
In the browser, your domain name ending with :// is the protocol, usually http and https. Since the Dashboard may be accessible by multiple protocols + domain + port combinations under normal deployment, please make sure to choose the most appropriate one as the callback.

How do I check if my callback URL is wrong?

Please make sure the protocol+domain+port displayed by your browser before login and the protocol+domain+port you jump to after login are the same.
Please make sure your path is /oauth2/callback, all lowercase.

Dashboard errors after login

  1. Clear your browser cookies and log in again, or change your browser.
  2. Check the callback address to ensure that your callback address is correct and that both the port and protocol are correct! The address from which the request is initiated needs to be in the same domain as the callback address, and the port, protocol, and domain name (or IP) all need to be consistent.

lookup xxx

DNS resolution failure, in most cases, is due to iptables-related configuration changes.
It is recommended to restart docker first, sudo systemctl restart docker, and then use the script to restart the Dashboard.
If the lookup error still occurs, it is recommended to check whether there are other tools to control iptables, such as Aapanel Firewall.
This problem may also be related to the kernel, please try to change the official kernel.

The authorization method is invalid, or the login callback URL is invalid, expired, or has been revoked

Suggest changing the authentication method to Github/Gitlab.

oauth2: server response missing access_token

It may be caused by a number of factors, the most likely is a network problem, we suggest to check the network and retry.
If you can't solve it, we suggest changing the authentication method to Github/Gitlab.

This user is not the administrator or cannot login

You have logged into the wrong account or configured the wrong username, note that username is not email, you can use a script to modify it.

dial tcp xxx:443 i/o timeout

If the server has network problems, you can restart docker first, sudo systemctl restart docker, and then use the script to restart the Dashboard.
You can also change to another OAuth method if necessary.

net/http: TLS handshake timeout

Same as above.

',20),s=[i];function n(l,c,h,d,u,m){return o(),t("div",null,s)}const k=e(r,[["render",n]]);export{b as __pageData,k as default}; diff --git a/assets/en_US_guide_loginq.md.8c9ac10b.lean.js b/assets/en_US_guide_loginq.md.7cbc69ad.lean.js similarity index 84% rename from assets/en_US_guide_loginq.md.8c9ac10b.lean.js rename to assets/en_US_guide_loginq.md.7cbc69ad.lean.js index c18c5279..85a7af0f 100644 --- a/assets/en_US_guide_loginq.md.8c9ac10b.lean.js +++ b/assets/en_US_guide_loginq.md.7cbc69ad.lean.js @@ -1 +1 @@ -import{_ as e,o,c as t,R as a}from"./chunks/framework.44fd0451.js";const b=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/guide/loginq.md","filePath":"en_US/guide/loginq.md","lastUpdated":1698142262000}'),r={name:"en_US/guide/loginq.md"},i=a("",20),s=[i];function n(l,c,h,d,u,m){return o(),t("div",null,s)}const k=e(r,[["render",n]]);export{b as __pageData,k as default}; +import{_ as e,o,c as t,R as a}from"./chunks/framework.44fd0451.js";const b=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/guide/loginq.md","filePath":"en_US/guide/loginq.md","lastUpdated":1698335020000}'),r={name:"en_US/guide/loginq.md"},i=a("",20),s=[i];function n(l,c,h,d,u,m){return o(),t("div",null,s)}const k=e(r,[["render",n]]);export{b as __pageData,k as default}; diff --git a/assets/en_US_guide_notifications.md.1e3309fc.js b/assets/en_US_guide_notifications.md.545de155.js similarity index 99% rename from assets/en_US_guide_notifications.md.1e3309fc.js rename to assets/en_US_guide_notifications.md.545de155.js index 28f622d9..2956f93d 100644 --- a/assets/en_US_guide_notifications.md.1e3309fc.js +++ b/assets/en_US_guide_notifications.md.545de155.js @@ -1,4 +1,4 @@ -import{_ as o,o as s,c as e,R as n}from"./chunks/framework.44fd0451.js";const F=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/guide/notifications.md","filePath":"en_US/guide/notifications.md","lastUpdated":1698142262000}'),t={name:"en_US/guide/notifications.md"},a=n(`

Nezha Monitoring supports monitoring of server load, CPU, memory, hard disk, data transfer, monthly data transfer, number of processes, number of connections, and sends alarm notifications when one of these items reaches a user-set limit.


Flexible notification methods

In panel messages, the placeholder #DATETIME# represents the timestamp of when an event occurs. When the notification is triggered, the panel automatically replaces #DATETIME# with the actual time of the event.

#NEZHA# is the panel message placeholder, the panel will automatically replace the placeholder with the actual message when it triggers the notification

The content of Body is in JSON format:When the request type is FORM,the value is in the form of key:valuevalue can contain placeholders that will be automatically replaced when notified. When the request type is JSON It will only do string substitution and submit to the URL directly.

Placeholders can also be placed inside the URL, and it will perform a simple string substitution when requested.

Refer to the example below, it is very flexible.

  • Bark Example

    • Name: Bark

    • URL: The first part is the key, followed by three matches/: key/: body or/: key/: title/: body or/: key/: category/: title/: body

    • Request method: GET

    • Request Type: Default

    • Body: null

    • Name: Bark

    • URL:/push

    • Request method: POST

    • Request type: FORM

    • Body: {"title": "#SERVER.NAME#","device_key":"xxxxxxxxx","body":"#NEZHA#","icon":" https://xxxxxxxx/nz.png "}

  • Telegram Example, contributed by @haitau

    • Name:Telegram Robot message notification
    • URL:https://api.telegram.org/botXXXXXX/sendMessage?chat_id=YYYYYY&text=#NEZHA#
    • Request method: GET
    • Request type: default
    • Body: null
    • Notes for this method:The XXXXXX in botXXXXXX is the token provided when you follow the official @Botfather in Telegram and enter /newbot to create a new bot. (In the line after Use this token to access the HTTP API). The 'bot' are essential. After creating a bot, you need to talk to the BOT in Telegram (send a random message) before you can send a message by using API. YYYYYY is Telegram user's ID, you can get it by talking to the bot @userinfobot.
  • Email notification example - Outlook

    json
    {
    +import{_ as o,o as s,c as e,R as n}from"./chunks/framework.44fd0451.js";const F=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/guide/notifications.md","filePath":"en_US/guide/notifications.md","lastUpdated":1698335020000}'),t={name:"en_US/guide/notifications.md"},a=n(`

    Nezha Monitoring supports monitoring of server load, CPU, memory, hard disk, data transfer, monthly data transfer, number of processes, number of connections, and sends alarm notifications when one of these items reaches a user-set limit.


    Flexible notification methods

    In panel messages, the placeholder #DATETIME# represents the timestamp of when an event occurs. When the notification is triggered, the panel automatically replaces #DATETIME# with the actual time of the event.

    #NEZHA# is the panel message placeholder, the panel will automatically replace the placeholder with the actual message when it triggers the notification

    The content of Body is in JSON format:When the request type is FORM,the value is in the form of key:valuevalue can contain placeholders that will be automatically replaced when notified. When the request type is JSON It will only do string substitution and submit to the URL directly.

    Placeholders can also be placed inside the URL, and it will perform a simple string substitution when requested.

    Refer to the example below, it is very flexible.

    • Bark Example

      • Name: Bark

      • URL: The first part is the key, followed by three matches/: key/: body or/: key/: title/: body or/: key/: category/: title/: body

      • Request method: GET

      • Request Type: Default

      • Body: null

      • Name: Bark

      • URL:/push

      • Request method: POST

      • Request type: FORM

      • Body: {"title": "#SERVER.NAME#","device_key":"xxxxxxxxx","body":"#NEZHA#","icon":" https://xxxxxxxx/nz.png "}

    • Telegram Example, contributed by @haitau

      • Name:Telegram Robot message notification
      • URL:https://api.telegram.org/botXXXXXX/sendMessage?chat_id=YYYYYY&text=#NEZHA#
      • Request method: GET
      • Request type: default
      • Body: null
      • Notes for this method:The XXXXXX in botXXXXXX is the token provided when you follow the official @Botfather in Telegram and enter /newbot to create a new bot. (In the line after Use this token to access the HTTP API). The 'bot' are essential. After creating a bot, you need to talk to the BOT in Telegram (send a random message) before you can send a message by using API. YYYYYY is Telegram user's ID, you can get it by talking to the bot @userinfobot.
    • Email notification example - Outlook

      json
      {
           "message": {
               "subject": "Server Status Notification",
               "body": {
      diff --git a/assets/en_US_guide_notifications.md.1e3309fc.lean.js b/assets/en_US_guide_notifications.md.545de155.lean.js
      similarity index 85%
      rename from assets/en_US_guide_notifications.md.1e3309fc.lean.js
      rename to assets/en_US_guide_notifications.md.545de155.lean.js
      index f78394ff..f065b18d 100644
      --- a/assets/en_US_guide_notifications.md.1e3309fc.lean.js
      +++ b/assets/en_US_guide_notifications.md.545de155.lean.js
      @@ -1 +1 @@
      -import{_ as o,o as s,c as e,R as n}from"./chunks/framework.44fd0451.js";const F=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/guide/notifications.md","filePath":"en_US/guide/notifications.md","lastUpdated":1698142262000}'),t={name:"en_US/guide/notifications.md"},a=n("",28),l=[a];function p(r,c,i,u,D,y){return s(),e("div",null,l)}const C=o(t,[["render",p]]);export{F as __pageData,C as default};
      +import{_ as o,o as s,c as e,R as n}from"./chunks/framework.44fd0451.js";const F=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/guide/notifications.md","filePath":"en_US/guide/notifications.md","lastUpdated":1698335020000}'),t={name:"en_US/guide/notifications.md"},a=n("",28),l=[a];function p(r,c,i,u,D,y){return s(),e("div",null,l)}const C=o(t,[["render",p]]);export{F as __pageData,C as default};
      diff --git a/assets/en_US_guide_q2.md.62f0a52b.js b/assets/en_US_guide_q2.md.e1dab069.js
      similarity index 96%
      rename from assets/en_US_guide_q2.md.62f0a52b.js
      rename to assets/en_US_guide_q2.md.e1dab069.js
      index 9d22b4bc..c1f8c296 100644
      --- a/assets/en_US_guide_q2.md.62f0a52b.js
      +++ b/assets/en_US_guide_q2.md.e1dab069.js
      @@ -1 +1 @@
      -import{_ as e,o as t,c as o,R as n}from"./chunks/framework.44fd0451.js";const m=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/guide/q2.md","filePath":"en_US/guide/q2.md","lastUpdated":1698142262000}'),r={name:"en_US/guide/q2.md"},a=n('

      Let the Agent start/on-line, and the self-test process of the problem

      1. Run //opt/nezha/agent/nezha-agent -s IP/Domin(Panel IP or Domain not connected to CDN):port(Panel RPC port) -p secret(Agent Secret) -d Check the logs to see if the timeout is due to a DNS problem or poor network
      2. nc -v domain/IP port(Panel RPC port) or telnet domain/IP port(Panel RPC port) to check if it' s a network problem, check the inbound and outbound firewall between the local machine and the panel server, if you can' t determine the problem you can check it with the port checking tool provided by https://port.ping.pe/
      3. If the above steps work and the Agent is online, please try to turn off SELinux on the panel server. How to close SELinux?
      ',2),s=[a];function l(i,c,h,p,d,_){return t(),o("div",null,s)}const u=e(r,[["render",l]]);export{m as __pageData,u as default}; +import{_ as e,o as t,c as o,R as n}from"./chunks/framework.44fd0451.js";const m=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/guide/q2.md","filePath":"en_US/guide/q2.md","lastUpdated":1698335020000}'),r={name:"en_US/guide/q2.md"},a=n('

      Let the Agent start/on-line, and the self-test process of the problem

      1. Run //opt/nezha/agent/nezha-agent -s IP/Domin(Panel IP or Domain not connected to CDN):port(Panel RPC port) -p secret(Agent Secret) -d Check the logs to see if the timeout is due to a DNS problem or poor network
      2. nc -v domain/IP port(Panel RPC port) or telnet domain/IP port(Panel RPC port) to check if it' s a network problem, check the inbound and outbound firewall between the local machine and the panel server, if you can' t determine the problem you can check it with the port checking tool provided by https://port.ping.pe/
      3. If the above steps work and the Agent is online, please try to turn off SELinux on the panel server. How to close SELinux?
      ',2),s=[a];function l(i,c,h,p,d,_){return t(),o("div",null,s)}const u=e(r,[["render",l]]);export{m as __pageData,u as default}; diff --git a/assets/en_US_guide_q2.md.62f0a52b.lean.js b/assets/en_US_guide_q2.md.e1dab069.lean.js similarity index 84% rename from assets/en_US_guide_q2.md.62f0a52b.lean.js rename to assets/en_US_guide_q2.md.e1dab069.lean.js index f00b8c2c..a64b35ad 100644 --- a/assets/en_US_guide_q2.md.62f0a52b.lean.js +++ b/assets/en_US_guide_q2.md.e1dab069.lean.js @@ -1 +1 @@ -import{_ as e,o as t,c as o,R as n}from"./chunks/framework.44fd0451.js";const m=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/guide/q2.md","filePath":"en_US/guide/q2.md","lastUpdated":1698142262000}'),r={name:"en_US/guide/q2.md"},a=n("",2),s=[a];function l(i,c,h,p,d,_){return t(),o("div",null,s)}const u=e(r,[["render",l]]);export{m as __pageData,u as default}; +import{_ as e,o as t,c as o,R as n}from"./chunks/framework.44fd0451.js";const m=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/guide/q2.md","filePath":"en_US/guide/q2.md","lastUpdated":1698335020000}'),r={name:"en_US/guide/q2.md"},a=n("",2),s=[a];function l(i,c,h,p,d,_){return t(),o("div",null,s)}const u=e(r,[["render",l]]);export{m as __pageData,u as default}; diff --git a/assets/en_US_guide_q3.md.0cfdd667.js b/assets/en_US_guide_q3.md.41a969d2.js similarity index 99% rename from assets/en_US_guide_q3.md.0cfdd667.js rename to assets/en_US_guide_q3.md.41a969d2.js index d92e5c60..d463d909 100644 --- a/assets/en_US_guide_q3.md.0cfdd667.js +++ b/assets/en_US_guide_q3.md.41a969d2.js @@ -1,4 +1,4 @@ -import{_ as s,o as n,c as a,R as e}from"./chunks/framework.44fd0451.js";const d=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/guide/q3.md","filePath":"en_US/guide/q3.md","lastUpdated":1698142262000}'),l={name:"en_US/guide/q3.md"},o=e(`

      Reverse Proxy gRPC Port (support Cloudflare CDN)

      Use Nginx or Caddy to reverse proxy gRPC

      • Nginx configuration files
      nginx
      server {
      +import{_ as s,o as n,c as a,R as e}from"./chunks/framework.44fd0451.js";const d=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/guide/q3.md","filePath":"en_US/guide/q3.md","lastUpdated":1698335020000}'),l={name:"en_US/guide/q3.md"},o=e(`

      Reverse Proxy gRPC Port (support Cloudflare CDN)

      Use Nginx or Caddy to reverse proxy gRPC

      • Nginx configuration files
      nginx
      server {
           listen 443 ssl http2;
           listen [::]:443 ssl http2;
           server_name data.example.com; # The domain name where the Agent connects to Dashboard
      diff --git a/assets/en_US_guide_q3.md.0cfdd667.lean.js b/assets/en_US_guide_q3.md.41a969d2.lean.js
      similarity index 84%
      rename from assets/en_US_guide_q3.md.0cfdd667.lean.js
      rename to assets/en_US_guide_q3.md.41a969d2.lean.js
      index c1506d03..40442453 100644
      --- a/assets/en_US_guide_q3.md.0cfdd667.lean.js
      +++ b/assets/en_US_guide_q3.md.41a969d2.lean.js
      @@ -1 +1 @@
      -import{_ as s,o as n,c as a,R as e}from"./chunks/framework.44fd0451.js";const d=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/guide/q3.md","filePath":"en_US/guide/q3.md","lastUpdated":1698142262000}'),l={name:"en_US/guide/q3.md"},o=e("",13),p=[o];function t(c,r,i,C,D,y){return n(),a("div",null,p)}const h=s(l,[["render",t]]);export{d as __pageData,h as default};
      +import{_ as s,o as n,c as a,R as e}from"./chunks/framework.44fd0451.js";const d=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/guide/q3.md","filePath":"en_US/guide/q3.md","lastUpdated":1698335020000}'),l={name:"en_US/guide/q3.md"},o=e("",13),p=[o];function t(c,r,i,C,D,y){return n(),a("div",null,p)}const h=s(l,[["render",t]]);export{d as __pageData,h as default};
      diff --git a/assets/en_US_guide_q4.md.eb1310a0.js b/assets/en_US_guide_q4.md.67db2cbd.js
      similarity index 94%
      rename from assets/en_US_guide_q4.md.eb1310a0.js
      rename to assets/en_US_guide_q4.md.67db2cbd.js
      index 1e94b67b..b9a24085 100644
      --- a/assets/en_US_guide_q4.md.eb1310a0.js
      +++ b/assets/en_US_guide_q4.md.67db2cbd.js
      @@ -1 +1 @@
      -import{_ as a,o as t,c as o,z as e,a as n}from"./chunks/framework.44fd0451.js";const g=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/guide/q4.md","filePath":"en_US/guide/q4.md","lastUpdated":1698142262000}'),i={name:"en_US/guide/q4.md"},r=e("h4",{id:"real-time-channel-disconnection-online-terminal-connection-failure",tabindex:"-1"},[n("Real-time channel disconnection/online terminal connection failure "),e("a",{class:"header-anchor",href:"#real-time-channel-disconnection-online-terminal-connection-failure","aria-label":'Permalink to "Real-time channel disconnection/online terminal connection failure"'},"​")],-1),c=e("ul",null,[e("li",null,"If you are using a CDN, please make sure that the CDN provider provides WebSocket service and that WebSocket is enabled"),e("li",null,[n("Confirm that you are using a reverse proxy requires special configuration of the WebSocket for the "),e("code",null,"/ws"),n(" and "),e("code",null,"/terminal"),n(" paths, you can "),e("a",{href:"/en_US/guide/dashboard.html#configure-reverse-proxy"},"click here"),n(" to see the reverse proxy configuration")])],-1),l=[r,c];function s(d,u,h,m,f,_){return t(),o("div",null,l)}const k=a(i,[["render",s]]);export{g as __pageData,k as default};
      +import{_ as a,o as t,c as o,z as e,a as n}from"./chunks/framework.44fd0451.js";const g=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/guide/q4.md","filePath":"en_US/guide/q4.md","lastUpdated":1698335020000}'),i={name:"en_US/guide/q4.md"},r=e("h4",{id:"real-time-channel-disconnection-online-terminal-connection-failure",tabindex:"-1"},[n("Real-time channel disconnection/online terminal connection failure "),e("a",{class:"header-anchor",href:"#real-time-channel-disconnection-online-terminal-connection-failure","aria-label":'Permalink to "Real-time channel disconnection/online terminal connection failure"'},"​")],-1),c=e("ul",null,[e("li",null,"If you are using a CDN, please make sure that the CDN provider provides WebSocket service and that WebSocket is enabled"),e("li",null,[n("Confirm that you are using a reverse proxy requires special configuration of the WebSocket for the "),e("code",null,"/ws"),n(" and "),e("code",null,"/terminal"),n(" paths, you can "),e("a",{href:"/en_US/guide/dashboard.html#configure-reverse-proxy"},"click here"),n(" to see the reverse proxy configuration")])],-1),l=[r,c];function s(d,u,h,m,f,_){return t(),o("div",null,l)}const k=a(i,[["render",s]]);export{g as __pageData,k as default};
      diff --git a/assets/en_US_guide_q4.md.eb1310a0.lean.js b/assets/en_US_guide_q4.md.67db2cbd.lean.js
      similarity index 94%
      rename from assets/en_US_guide_q4.md.eb1310a0.lean.js
      rename to assets/en_US_guide_q4.md.67db2cbd.lean.js
      index 1e94b67b..b9a24085 100644
      --- a/assets/en_US_guide_q4.md.eb1310a0.lean.js
      +++ b/assets/en_US_guide_q4.md.67db2cbd.lean.js
      @@ -1 +1 @@
      -import{_ as a,o as t,c as o,z as e,a as n}from"./chunks/framework.44fd0451.js";const g=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/guide/q4.md","filePath":"en_US/guide/q4.md","lastUpdated":1698142262000}'),i={name:"en_US/guide/q4.md"},r=e("h4",{id:"real-time-channel-disconnection-online-terminal-connection-failure",tabindex:"-1"},[n("Real-time channel disconnection/online terminal connection failure "),e("a",{class:"header-anchor",href:"#real-time-channel-disconnection-online-terminal-connection-failure","aria-label":'Permalink to "Real-time channel disconnection/online terminal connection failure"'},"​")],-1),c=e("ul",null,[e("li",null,"If you are using a CDN, please make sure that the CDN provider provides WebSocket service and that WebSocket is enabled"),e("li",null,[n("Confirm that you are using a reverse proxy requires special configuration of the WebSocket for the "),e("code",null,"/ws"),n(" and "),e("code",null,"/terminal"),n(" paths, you can "),e("a",{href:"/en_US/guide/dashboard.html#configure-reverse-proxy"},"click here"),n(" to see the reverse proxy configuration")])],-1),l=[r,c];function s(d,u,h,m,f,_){return t(),o("div",null,l)}const k=a(i,[["render",s]]);export{g as __pageData,k as default};
      +import{_ as a,o as t,c as o,z as e,a as n}from"./chunks/framework.44fd0451.js";const g=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/guide/q4.md","filePath":"en_US/guide/q4.md","lastUpdated":1698335020000}'),i={name:"en_US/guide/q4.md"},r=e("h4",{id:"real-time-channel-disconnection-online-terminal-connection-failure",tabindex:"-1"},[n("Real-time channel disconnection/online terminal connection failure "),e("a",{class:"header-anchor",href:"#real-time-channel-disconnection-online-terminal-connection-failure","aria-label":'Permalink to "Real-time channel disconnection/online terminal connection failure"'},"​")],-1),c=e("ul",null,[e("li",null,"If you are using a CDN, please make sure that the CDN provider provides WebSocket service and that WebSocket is enabled"),e("li",null,[n("Confirm that you are using a reverse proxy requires special configuration of the WebSocket for the "),e("code",null,"/ws"),n(" and "),e("code",null,"/terminal"),n(" paths, you can "),e("a",{href:"/en_US/guide/dashboard.html#configure-reverse-proxy"},"click here"),n(" to see the reverse proxy configuration")])],-1),l=[r,c];function s(d,u,h,m,f,_){return t(),o("div",null,l)}const k=a(i,[["render",s]]);export{g as __pageData,k as default};
      diff --git a/assets/en_US_guide_q5.md.a7f4e653.js b/assets/en_US_guide_q5.md.7f6e04d4.js
      similarity index 94%
      rename from assets/en_US_guide_q5.md.a7f4e653.js
      rename to assets/en_US_guide_q5.md.7f6e04d4.js
      index 10a76978..84265693 100644
      --- a/assets/en_US_guide_q5.md.a7f4e653.js
      +++ b/assets/en_US_guide_q5.md.7f6e04d4.js
      @@ -1 +1 @@
      -import{_ as a,o,c as r,z as e,a as t}from"./chunks/framework.44fd0451.js";const w=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/guide/q5.md","filePath":"en_US/guide/q5.md","lastUpdated":1698142262000}'),s={name:"en_US/guide/q5.md"},n=e("h4",{id:"how-do-i-migrate-my-data-to-the-new-server-and-restore-my-backups",tabindex:"-1"},[t("How do I migrate my data to the new server and restore my backups? "),e("a",{class:"header-anchor",href:"#how-do-i-migrate-my-data-to-the-new-server-and-restore-my-backups","aria-label":'Permalink to "How do I migrate my data to the new server and restore my backups?"'},"​")],-1),d=e("ol",null,[e("li",null,[t("First use the one-click script and select "),e("code",null,"Stop Panel")]),e("li",null,[t("Compress the "),e("code",null,"/opt/nezha"),t(" folder to the same path as the new server")]),e("li",null,[t("Run the one-click script in the new server, select "),e("code",null,"Launch Panel")])],-1),l=[n,d];function c(i,h,m,p,u,_){return o(),r("div",null,l)}const k=a(s,[["render",c]]);export{w as __pageData,k as default};
      +import{_ as a,o,c as r,z as e,a as t}from"./chunks/framework.44fd0451.js";const w=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/guide/q5.md","filePath":"en_US/guide/q5.md","lastUpdated":1698335020000}'),s={name:"en_US/guide/q5.md"},n=e("h4",{id:"how-do-i-migrate-my-data-to-the-new-server-and-restore-my-backups",tabindex:"-1"},[t("How do I migrate my data to the new server and restore my backups? "),e("a",{class:"header-anchor",href:"#how-do-i-migrate-my-data-to-the-new-server-and-restore-my-backups","aria-label":'Permalink to "How do I migrate my data to the new server and restore my backups?"'},"​")],-1),d=e("ol",null,[e("li",null,[t("First use the one-click script and select "),e("code",null,"Stop Panel")]),e("li",null,[t("Compress the "),e("code",null,"/opt/nezha"),t(" folder to the same path as the new server")]),e("li",null,[t("Run the one-click script in the new server, select "),e("code",null,"Launch Panel")])],-1),l=[n,d];function c(i,h,m,p,u,_){return o(),r("div",null,l)}const k=a(s,[["render",c]]);export{w as __pageData,k as default};
      diff --git a/assets/en_US_guide_q5.md.a7f4e653.lean.js b/assets/en_US_guide_q5.md.7f6e04d4.lean.js
      similarity index 94%
      rename from assets/en_US_guide_q5.md.a7f4e653.lean.js
      rename to assets/en_US_guide_q5.md.7f6e04d4.lean.js
      index 10a76978..84265693 100644
      --- a/assets/en_US_guide_q5.md.a7f4e653.lean.js
      +++ b/assets/en_US_guide_q5.md.7f6e04d4.lean.js
      @@ -1 +1 @@
      -import{_ as a,o,c as r,z as e,a as t}from"./chunks/framework.44fd0451.js";const w=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/guide/q5.md","filePath":"en_US/guide/q5.md","lastUpdated":1698142262000}'),s={name:"en_US/guide/q5.md"},n=e("h4",{id:"how-do-i-migrate-my-data-to-the-new-server-and-restore-my-backups",tabindex:"-1"},[t("How do I migrate my data to the new server and restore my backups? "),e("a",{class:"header-anchor",href:"#how-do-i-migrate-my-data-to-the-new-server-and-restore-my-backups","aria-label":'Permalink to "How do I migrate my data to the new server and restore my backups?"'},"​")],-1),d=e("ol",null,[e("li",null,[t("First use the one-click script and select "),e("code",null,"Stop Panel")]),e("li",null,[t("Compress the "),e("code",null,"/opt/nezha"),t(" folder to the same path as the new server")]),e("li",null,[t("Run the one-click script in the new server, select "),e("code",null,"Launch Panel")])],-1),l=[n,d];function c(i,h,m,p,u,_){return o(),r("div",null,l)}const k=a(s,[["render",c]]);export{w as __pageData,k as default};
      +import{_ as a,o,c as r,z as e,a as t}from"./chunks/framework.44fd0451.js";const w=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/guide/q5.md","filePath":"en_US/guide/q5.md","lastUpdated":1698335020000}'),s={name:"en_US/guide/q5.md"},n=e("h4",{id:"how-do-i-migrate-my-data-to-the-new-server-and-restore-my-backups",tabindex:"-1"},[t("How do I migrate my data to the new server and restore my backups? "),e("a",{class:"header-anchor",href:"#how-do-i-migrate-my-data-to-the-new-server-and-restore-my-backups","aria-label":'Permalink to "How do I migrate my data to the new server and restore my backups?"'},"​")],-1),d=e("ol",null,[e("li",null,[t("First use the one-click script and select "),e("code",null,"Stop Panel")]),e("li",null,[t("Compress the "),e("code",null,"/opt/nezha"),t(" folder to the same path as the new server")]),e("li",null,[t("Run the one-click script in the new server, select "),e("code",null,"Launch Panel")])],-1),l=[n,d];function c(i,h,m,p,u,_){return o(),r("div",null,l)}const k=a(s,[["render",c]]);export{w as __pageData,k as default};
      diff --git a/assets/en_US_guide_q6.md.81b709fc.js b/assets/en_US_guide_q6.md.dba5267a.js
      similarity index 95%
      rename from assets/en_US_guide_q6.md.81b709fc.js
      rename to assets/en_US_guide_q6.md.dba5267a.js
      index 45b94cbf..ddd6b967 100644
      --- a/assets/en_US_guide_q6.md.81b709fc.js
      +++ b/assets/en_US_guide_q6.md.dba5267a.js
      @@ -1 +1 @@
      -import{_ as t,o as e,c as s,R as a}from"./chunks/framework.44fd0451.js";const m=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/guide/q6.md","filePath":"en_US/guide/q6.md","lastUpdated":1698142262000}'),o={name:"en_US/guide/q6.md"},i=a('

      How to set up a monthly reset of transfer statistics?

      In the home page, the traffic statistics will be reset when the server is restarted.
      If you want to set the traffic statistics to be reset once a month, you can do it like this:

      1. Go to the Notification page of the admin panel
      2. Refer to this document to create a monthly transfer statistics notification
      3. Return to the home page and you can see the monthly transfer statistics in the Service page, where the statistics will not be reset when the server is restarted

      TIP

      This method can be set to any period, including and not limited to hourly/daily/weekly/monthly/yearly reset transfer statistics, very flexible!

      ',4),n=[i];function r(c,l,h,d,f,_){return e(),s("div",null,n)}const u=t(o,[["render",r]]);export{m as __pageData,u as default}; +import{_ as t,o as e,c as s,R as a}from"./chunks/framework.44fd0451.js";const m=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/guide/q6.md","filePath":"en_US/guide/q6.md","lastUpdated":1698335020000}'),o={name:"en_US/guide/q6.md"},i=a('

      How to set up a monthly reset of transfer statistics?

      In the home page, the traffic statistics will be reset when the server is restarted.
      If you want to set the traffic statistics to be reset once a month, you can do it like this:

      1. Go to the Notification page of the admin panel
      2. Refer to this document to create a monthly transfer statistics notification
      3. Return to the home page and you can see the monthly transfer statistics in the Service page, where the statistics will not be reset when the server is restarted

      TIP

      This method can be set to any period, including and not limited to hourly/daily/weekly/monthly/yearly reset transfer statistics, very flexible!

      ',4),n=[i];function r(c,l,h,d,f,_){return e(),s("div",null,n)}const u=t(o,[["render",r]]);export{m as __pageData,u as default}; diff --git a/assets/en_US_guide_q6.md.81b709fc.lean.js b/assets/en_US_guide_q6.md.dba5267a.lean.js similarity index 84% rename from assets/en_US_guide_q6.md.81b709fc.lean.js rename to assets/en_US_guide_q6.md.dba5267a.lean.js index a35865d0..1dd4b396 100644 --- a/assets/en_US_guide_q6.md.81b709fc.lean.js +++ b/assets/en_US_guide_q6.md.dba5267a.lean.js @@ -1 +1 @@ -import{_ as t,o as e,c as s,R as a}from"./chunks/framework.44fd0451.js";const m=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/guide/q6.md","filePath":"en_US/guide/q6.md","lastUpdated":1698142262000}'),o={name:"en_US/guide/q6.md"},i=a("",4),n=[i];function r(c,l,h,d,f,_){return e(),s("div",null,n)}const u=t(o,[["render",r]]);export{m as __pageData,u as default}; +import{_ as t,o as e,c as s,R as a}from"./chunks/framework.44fd0451.js";const m=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/guide/q6.md","filePath":"en_US/guide/q6.md","lastUpdated":1698335020000}'),o={name:"en_US/guide/q6.md"},i=a("",4),n=[i];function r(c,l,h,d,f,_){return e(),s("div",null,n)}const u=t(o,[["render",r]]);export{m as __pageData,u as default}; diff --git a/assets/en_US_guide_q7.md.5e98f929.js b/assets/en_US_guide_q7.md.e61c0a23.js similarity index 97% rename from assets/en_US_guide_q7.md.5e98f929.js rename to assets/en_US_guide_q7.md.e61c0a23.js index a345e0d4..86400438 100644 --- a/assets/en_US_guide_q7.md.5e98f929.js +++ b/assets/en_US_guide_q7.md.e61c0a23.js @@ -1 +1 @@ -import{_ as e,o as t,c as o,R as a}from"./chunks/framework.44fd0451.js";const p=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/guide/q7.md","filePath":"en_US/guide/q7.md","lastUpdated":1698142262000}'),i={name:"en_US/guide/q7.md"},n=a('

      Customize Agent

      Customize the NIC and hard drive partitions to be monitored

      • Run /opt/nezha/agent/nezha-agent --edit-agent-config to select a custom NIC and partition, and then restart Agent

      Other Flags

      Run ./nezha-agent --help to view supported flags,if you are already using the one-click script, you can edit /etc/systemd/system/nezha-agent.service,at the end of this line ExecStart= add:

      • --report-delay System information reporting interval, default is 1 second, can be set to 3 to reduce the system resource usage on the agent side (configuration range 1-4)
      • --skip-conn Not monitoring the number of connections, if it is a server with a large number of connections, the CPU usage will be high. It is recommended to set this to reduce CPU usage
      • --skip-procs Disable monitoring the number of processes can also reduce CPU and memory usage
      • --disable-auto-update Disable Automatic Update Agent (security feature)
      • --disable-force-update Disable Forced Update Agent (security feature)
      • --disable-command-execute Disable execution of scheduled tasks, disallow WebShell (security feature)
      • --tls Enable SSL/TLS encryption (If you are using nginx to reverse proxy Agent´s grpc connections, and if nginx has SSL/TLS enabled, you need to enable this configuration)
      ',6),s=[n];function r(d,c,l,u,h,g){return t(),o("div",null,s)}const f=e(i,[["render",r]]);export{p as __pageData,f as default}; +import{_ as e,o as t,c as o,R as a}from"./chunks/framework.44fd0451.js";const p=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/guide/q7.md","filePath":"en_US/guide/q7.md","lastUpdated":1698335020000}'),i={name:"en_US/guide/q7.md"},n=a('

      Customize Agent

      Customize the NIC and hard drive partitions to be monitored

      • Run /opt/nezha/agent/nezha-agent --edit-agent-config to select a custom NIC and partition, and then restart Agent

      Other Flags

      Run ./nezha-agent --help to view supported flags,if you are already using the one-click script, you can edit /etc/systemd/system/nezha-agent.service,at the end of this line ExecStart= add:

      • --report-delay System information reporting interval, default is 1 second, can be set to 3 to reduce the system resource usage on the agent side (configuration range 1-4)
      • --skip-conn Not monitoring the number of connections, if it is a server with a large number of connections, the CPU usage will be high. It is recommended to set this to reduce CPU usage
      • --skip-procs Disable monitoring the number of processes can also reduce CPU and memory usage
      • --disable-auto-update Disable Automatic Update Agent (security feature)
      • --disable-force-update Disable Forced Update Agent (security feature)
      • --disable-command-execute Disable execution of scheduled tasks, disallow WebShell (security feature)
      • --tls Enable SSL/TLS encryption (If you are using nginx to reverse proxy Agent´s grpc connections, and if nginx has SSL/TLS enabled, you need to enable this configuration)
      ',6),s=[n];function r(d,c,l,u,h,g){return t(),o("div",null,s)}const f=e(i,[["render",r]]);export{p as __pageData,f as default}; diff --git a/assets/en_US_guide_q7.md.5e98f929.lean.js b/assets/en_US_guide_q7.md.e61c0a23.lean.js similarity index 84% rename from assets/en_US_guide_q7.md.5e98f929.lean.js rename to assets/en_US_guide_q7.md.e61c0a23.lean.js index d0a64cc4..723d1723 100644 --- a/assets/en_US_guide_q7.md.5e98f929.lean.js +++ b/assets/en_US_guide_q7.md.e61c0a23.lean.js @@ -1 +1 @@ -import{_ as e,o as t,c as o,R as a}from"./chunks/framework.44fd0451.js";const p=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/guide/q7.md","filePath":"en_US/guide/q7.md","lastUpdated":1698142262000}'),i={name:"en_US/guide/q7.md"},n=a("",6),s=[n];function r(d,c,l,u,h,g){return t(),o("div",null,s)}const f=e(i,[["render",r]]);export{p as __pageData,f as default}; +import{_ as e,o as t,c as o,R as a}from"./chunks/framework.44fd0451.js";const p=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/guide/q7.md","filePath":"en_US/guide/q7.md","lastUpdated":1698335020000}'),i={name:"en_US/guide/q7.md"},n=a("",6),s=[n];function r(d,c,l,u,h,g){return t(),o("div",null,s)}const f=e(i,[["render",r]]);export{p as __pageData,f as default}; diff --git a/assets/en_US_guide_servers.md.abbee449.js b/assets/en_US_guide_servers.md.c6bbe82d.js similarity index 96% rename from assets/en_US_guide_servers.md.abbee449.js rename to assets/en_US_guide_servers.md.c6bbe82d.js index fe1f3f36..e1c9002f 100644 --- a/assets/en_US_guide_servers.md.abbee449.js +++ b/assets/en_US_guide_servers.md.c6bbe82d.js @@ -1 +1 @@ -import{_ as e,o as t,c as a,R as n}from"./chunks/framework.44fd0451.js";const m=JSON.parse('{"title":"Servers","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/guide/servers.md","filePath":"en_US/guide/servers.md","lastUpdated":1698142262000}'),r={name:"en_US/guide/servers.md"},o=n('

      Servers

      Introduction

      The Servers area is responsible for managing the Agent, the most basic area in Nezha Monitoring, and the basis for other functions.

      Add a server

      The first step is to add a servers, which can be customized with names, groups, display index and notes.
      Servers in the same group will be displayed in groups in supported themes, and notes will only be displayed in the admin panel, no need to worry about leaking information.

      Install Agent

      Please refer to the previous article: Install Agent
      We recommend using one-click installation, that is, after configuring the communication domain name, click the button on the column one-click installation and copy it to the monitored servers for installation.

      Forced Updates

      The flags related to the update of the Agent are: --disable-auto-update and --disable-force-update. Please refer to Customize Agent
      By default, the Agent is updated automatically, but when the user turns off automatic updates, the specified servers can also be selected for forced updates.
      This feature does not take effect when -disable-force-update is turned on.

      Data List

      • Version number: Record the current version of Agent
      • Secret: Used when configuring the Agent
      • One-Click Installation: A more convenient way to install Agent
      • Manage: WebShell on the left, Edit in the middle, Delete on the right

      Webshell

      This feature does not take effect when disable-command-execute is turned on.
      Both Linux and Windows are available and can be pasted using Ctrl+Shift+V.
      For connection failure, please refer to Real-time channel disconnection/online terminal connection failure.
      Note that in theWebShell function, the Agent also connects to the Domain names for public access via WebSocket, not via grpc.

      ',13),i=[o];function s(l,d,c,h,u,f){return t(),a("div",null,i)}const b=e(r,[["render",s]]);export{m as __pageData,b as default}; +import{_ as e,o as t,c as a,R as n}from"./chunks/framework.44fd0451.js";const m=JSON.parse('{"title":"Servers","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/guide/servers.md","filePath":"en_US/guide/servers.md","lastUpdated":1698335020000}'),r={name:"en_US/guide/servers.md"},o=n('

      Servers

      Introduction

      The Servers area is responsible for managing the Agent, the most basic area in Nezha Monitoring, and the basis for other functions.

      Add a server

      The first step is to add a servers, which can be customized with names, groups, display index and notes.
      Servers in the same group will be displayed in groups in supported themes, and notes will only be displayed in the admin panel, no need to worry about leaking information.

      Install Agent

      Please refer to the previous article: Install Agent
      We recommend using one-click installation, that is, after configuring the communication domain name, click the button on the column one-click installation and copy it to the monitored servers for installation.

      Forced Updates

      The flags related to the update of the Agent are: --disable-auto-update and --disable-force-update. Please refer to Customize Agent
      By default, the Agent is updated automatically, but when the user turns off automatic updates, the specified servers can also be selected for forced updates.
      This feature does not take effect when -disable-force-update is turned on.

      Data List

      • Version number: Record the current version of Agent
      • Secret: Used when configuring the Agent
      • One-Click Installation: A more convenient way to install Agent
      • Manage: WebShell on the left, Edit in the middle, Delete on the right

      Webshell

      This feature does not take effect when disable-command-execute is turned on.
      Both Linux and Windows are available and can be pasted using Ctrl+Shift+V.
      For connection failure, please refer to Real-time channel disconnection/online terminal connection failure.
      Note that in theWebShell function, the Agent also connects to the Domain names for public access via WebSocket, not via grpc.

      ',13),i=[o];function s(l,d,c,h,u,f){return t(),a("div",null,i)}const b=e(r,[["render",s]]);export{m as __pageData,b as default}; diff --git a/assets/en_US_guide_servers.md.abbee449.lean.js b/assets/en_US_guide_servers.md.c6bbe82d.lean.js similarity index 70% rename from assets/en_US_guide_servers.md.abbee449.lean.js rename to assets/en_US_guide_servers.md.c6bbe82d.lean.js index 47578fa9..c7413c48 100644 --- a/assets/en_US_guide_servers.md.abbee449.lean.js +++ b/assets/en_US_guide_servers.md.c6bbe82d.lean.js @@ -1 +1 @@ -import{_ as e,o as t,c as a,R as n}from"./chunks/framework.44fd0451.js";const m=JSON.parse('{"title":"Servers","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/guide/servers.md","filePath":"en_US/guide/servers.md","lastUpdated":1698142262000}'),r={name:"en_US/guide/servers.md"},o=n("",13),i=[o];function s(l,d,c,h,u,f){return t(),a("div",null,i)}const b=e(r,[["render",s]]);export{m as __pageData,b as default}; +import{_ as e,o as t,c as a,R as n}from"./chunks/framework.44fd0451.js";const m=JSON.parse('{"title":"Servers","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/guide/servers.md","filePath":"en_US/guide/servers.md","lastUpdated":1698335020000}'),r={name:"en_US/guide/servers.md"},o=n("",13),i=[o];function s(l,d,c,h,u,f){return t(),a("div",null,i)}const b=e(r,[["render",s]]);export{m as __pageData,b as default}; diff --git a/assets/en_US_guide_services.md.a60b7cbd.js b/assets/en_US_guide_services.md.6fec2f3d.js similarity index 98% rename from assets/en_US_guide_services.md.a60b7cbd.js rename to assets/en_US_guide_services.md.6fec2f3d.js index fad6756c..41ce3e10 100644 --- a/assets/en_US_guide_services.md.a60b7cbd.js +++ b/assets/en_US_guide_services.md.6fec2f3d.js @@ -1 +1 @@ -import{_ as e,o as t,c as o,R as i}from"./chunks/framework.44fd0451.js";const m=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/guide/services.md","filePath":"en_US/guide/services.md","lastUpdated":1698142262000}'),n={name:"en_US/guide/services.md"},a=i('

      Service area is a function setting area for setting up Agents to monitor external websites or servers
      The monitoring results can be viewed on the "Services" page in the home page

      How to use

      To add a new monitor, you can go to the "Services" page in the administration panel and click "Add Service Monitor".

      To add a service monitor, you need to complete the following settings:

      • Name - Customize a name

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

      • Target - Depending on the type you choose, the target is set in different ways

      • HTTP-GET: Selecting this type, you should enter a URL as the target, the URL should be added with http:// or https:// If your target URL is https://, it will also monitor the SSL certificate of that URL and trigger a notification when the SSL certificate expires or changes.
        For example: https://example.com
      • ICMP-Ping: When selecting this type, you should enter a domain name or IP without a port number
        For example: 1.1.1.1 or example.com
      • TCP-Ping: When selecting this type, you should enter a domain name or IP and include the port number
        For example: 1.1.1.1:80 or example.com:22
      • Interval: Sets the time interval in seconds between each time Agent sends requests to the target

      • Coverage: Select a rule to determine which Agents to use to send requests to the target

      • Specific Servers: Use with coverage to select the Agent to be excluded from the rule

      • Notification Group: Select the notification method you have set up on the "Notification" page. Click here for more information

      • Enable Failure Notification: Select whether to receive target failure notifications as needed, default is inactive

      After setting, click "Add" and you are done.
      Wait for a moment to go to the "Services" page on the home page to view the monitoring results

      Notification of delay changes

      Nezha Monitoring monitors and statistics the delay between the Agent and the target server, and sends notifications in case of significant changes
      Use this feature to help you monitor your server's routes for changes

      • Enable delay notifications:When enabled, notifications will be sent when the Agent to target server delay is higher than the Max delay or lower than the Min delay

      Management Monitor

      To manage existing service monitoring, you can go to the "Services" page in the administration panel
      Select a monitoring configuration and click the icon on the right to edit or delete it

      ',15),r=[a];function c(s,l,d,h,u,p){return t(),o("div",null,r)}const f=e(n,[["render",c]]);export{m as __pageData,f as default}; +import{_ as e,o as t,c as o,R as i}from"./chunks/framework.44fd0451.js";const m=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/guide/services.md","filePath":"en_US/guide/services.md","lastUpdated":1698335020000}'),n={name:"en_US/guide/services.md"},a=i('

      Service area is a function setting area for setting up Agents to monitor external websites or servers
      The monitoring results can be viewed on the "Services" page in the home page

      How to use

      To add a new monitor, you can go to the "Services" page in the administration panel and click "Add Service Monitor".

      To add a service monitor, you need to complete the following settings:

      • Name - Customize a name

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

      • Target - Depending on the type you choose, the target is set in different ways

      • HTTP-GET: Selecting this type, you should enter a URL as the target, the URL should be added with http:// or https:// If your target URL is https://, it will also monitor the SSL certificate of that URL and trigger a notification when the SSL certificate expires or changes.
        For example: https://example.com
      • ICMP-Ping: When selecting this type, you should enter a domain name or IP without a port number
        For example: 1.1.1.1 or example.com
      • TCP-Ping: When selecting this type, you should enter a domain name or IP and include the port number
        For example: 1.1.1.1:80 or example.com:22
      • Interval: Sets the time interval in seconds between each time Agent sends requests to the target

      • Coverage: Select a rule to determine which Agents to use to send requests to the target

      • Specific Servers: Use with coverage to select the Agent to be excluded from the rule

      • Notification Group: Select the notification method you have set up on the "Notification" page. Click here for more information

      • Enable Failure Notification: Select whether to receive target failure notifications as needed, default is inactive

      After setting, click "Add" and you are done.
      Wait for a moment to go to the "Services" page on the home page to view the monitoring results

      Notification of delay changes

      Nezha Monitoring monitors and statistics the delay between the Agent and the target server, and sends notifications in case of significant changes
      Use this feature to help you monitor your server's routes for changes

      • Enable delay notifications:When enabled, notifications will be sent when the Agent to target server delay is higher than the Max delay or lower than the Min delay

      Management Monitor

      To manage existing service monitoring, you can go to the "Services" page in the administration panel
      Select a monitoring configuration and click the icon on the right to edit or delete it

      ',15),r=[a];function c(s,l,d,h,u,p){return t(),o("div",null,r)}const f=e(n,[["render",c]]);export{m as __pageData,f as default}; diff --git a/assets/en_US_guide_services.md.a60b7cbd.lean.js b/assets/en_US_guide_services.md.6fec2f3d.lean.js similarity index 85% rename from assets/en_US_guide_services.md.a60b7cbd.lean.js rename to assets/en_US_guide_services.md.6fec2f3d.lean.js index 2dc867f9..a19387e9 100644 --- a/assets/en_US_guide_services.md.a60b7cbd.lean.js +++ b/assets/en_US_guide_services.md.6fec2f3d.lean.js @@ -1 +1 @@ -import{_ as e,o as t,c as o,R as i}from"./chunks/framework.44fd0451.js";const m=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/guide/services.md","filePath":"en_US/guide/services.md","lastUpdated":1698142262000}'),n={name:"en_US/guide/services.md"},a=i("",15),r=[a];function c(s,l,d,h,u,p){return t(),o("div",null,r)}const f=e(n,[["render",c]]);export{m as __pageData,f as default}; +import{_ as e,o as t,c as o,R as i}from"./chunks/framework.44fd0451.js";const m=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/guide/services.md","filePath":"en_US/guide/services.md","lastUpdated":1698335020000}'),n={name:"en_US/guide/services.md"},a=i("",15),r=[a];function c(s,l,d,h,u,p){return t(),o("div",null,r)}const f=e(n,[["render",c]]);export{m as __pageData,f as default}; diff --git a/assets/en_US_guide_settings.md.0f8102b9.js b/assets/en_US_guide_settings.md.215bc7fd.js similarity index 99% rename from assets/en_US_guide_settings.md.0f8102b9.js rename to assets/en_US_guide_settings.md.215bc7fd.js index a90fa827..d476eefc 100644 --- a/assets/en_US_guide_settings.md.0f8102b9.js +++ b/assets/en_US_guide_settings.md.215bc7fd.js @@ -1,4 +1,4 @@ -import{_ as s,o as a,c as n,R as o}from"./chunks/framework.44fd0451.js";const d=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/guide/settings.md","filePath":"en_US/guide/settings.md","lastUpdated":1698142262000}'),e={name:"en_US/guide/settings.md"},l=o(`

      Site Title

      You can customize your site title here

      Admin List

      • If you have changed your Github, Gitlab, Jihulab, Gitee username, you can change it in this item, otherwise you can't log in, please separate multiple users with commas: user1,user2

      • To change your administrator account, please go to /opt/nezha/dashboard/data/config.yaml to set the new administrator Client ID and Client Secret.

      Theme

      Select the home page theme here, and update the panel if there is not an existing theme in the options

      Language

      Nezha Monitoring currently supports the following languages:

      • 简体中文
      • English
      • Español

      Crowdin
      We welcome corrections to translations and contributions of additional languages

      Custom code (style, script)

      Change logo, change color tone, add statistics code, etc.

      WARNING

      The custom code only takes effect in the visitor's home page, not in the admin panel.
      Since the code of different themes is different, if you really need to modify the content of the admin panel, please enter Docker to changes it by yourself.


      Example of changing the default theme progress bar color

      html
      <style>
      +import{_ as s,o as a,c as n,R as o}from"./chunks/framework.44fd0451.js";const d=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/guide/settings.md","filePath":"en_US/guide/settings.md","lastUpdated":1698335020000}'),e={name:"en_US/guide/settings.md"},l=o(`

      Site Title

      You can customize your site title here

      Admin List

      • If you have changed your Github, Gitlab, Jihulab, Gitee username, you can change it in this item, otherwise you can't log in, please separate multiple users with commas: user1,user2

      • To change your administrator account, please go to /opt/nezha/dashboard/data/config.yaml to set the new administrator Client ID and Client Secret.

      Theme

      Select the home page theme here, and update the panel if there is not an existing theme in the options

      Language

      Nezha Monitoring currently supports the following languages:

      • 简体中文
      • English
      • Español

      Crowdin
      We welcome corrections to translations and contributions of additional languages

      Custom code (style, script)

      Change logo, change color tone, add statistics code, etc.

      WARNING

      The custom code only takes effect in the visitor's home page, not in the admin panel.
      Since the code of different themes is different, if you really need to modify the content of the admin panel, please enter Docker to changes it by yourself.


      Example of changing the default theme progress bar color

      html
      <style>
       .ui.fine.progress> .bar {
           background-color: pink !important;
       }
      diff --git a/assets/en_US_guide_settings.md.0f8102b9.lean.js b/assets/en_US_guide_settings.md.215bc7fd.lean.js
      similarity index 85%
      rename from assets/en_US_guide_settings.md.0f8102b9.lean.js
      rename to assets/en_US_guide_settings.md.215bc7fd.lean.js
      index 41107f48..73cdc155 100644
      --- a/assets/en_US_guide_settings.md.0f8102b9.lean.js
      +++ b/assets/en_US_guide_settings.md.215bc7fd.lean.js
      @@ -1 +1 @@
      -import{_ as s,o as a,c as n,R as o}from"./chunks/framework.44fd0451.js";const d=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/guide/settings.md","filePath":"en_US/guide/settings.md","lastUpdated":1698142262000}'),e={name:"en_US/guide/settings.md"},l=o("",37),t=[l];function p(r,c,i,y,D,F){return a(),n("div",null,t)}const u=s(e,[["render",p]]);export{d as __pageData,u as default};
      +import{_ as s,o as a,c as n,R as o}from"./chunks/framework.44fd0451.js";const d=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/guide/settings.md","filePath":"en_US/guide/settings.md","lastUpdated":1698335020000}'),e={name:"en_US/guide/settings.md"},l=o("",37),t=[l];function p(r,c,i,y,D,F){return a(),n("div",null,t)}const u=s(e,[["render",p]]);export{d as __pageData,u as default};
      diff --git a/assets/en_US_guide_tasks.md.67055555.js b/assets/en_US_guide_tasks.md.1ea501e8.js
      similarity index 98%
      rename from assets/en_US_guide_tasks.md.67055555.js
      rename to assets/en_US_guide_tasks.md.1ea501e8.js
      index 45347b76..090ca06b 100644
      --- a/assets/en_US_guide_tasks.md.67055555.js
      +++ b/assets/en_US_guide_tasks.md.1ea501e8.js
      @@ -1 +1 @@
      -import{_ as e,o as t,c as o,R as a}from"./chunks/framework.44fd0451.js";const g=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/guide/tasks.md","filePath":"en_US/guide/tasks.md","lastUpdated":1698142262000}'),i={name:"en_US/guide/tasks.md"},s=a('

      In the task area, you can set up scheduled tasks, Trigger tasks, and multi-server batch execution tasks

      Nezha monitoring supports pushing commands to the Agent for execution, so this feature is very flexible and can be used to periodically back up the server in conjunction with restic, rclone. Periodically restart a service to reset the network connection. It can also be used with notifications to perform a task when a notification is triggered, such as running a script when the CPU is at high occupancy for a long period of time.

      How to use

      Go to the "Tasks" page of the admin panel and click "Add Scheduled Task"
      To add a scheduled task you need to make the following settings:

      • Name - Customize a task name

      • Task Type - select the type of task
        Scheduled Tasks - Tasks are executed periodically at the scheduled time set below
        Trigger Tasks - Tasks that are triggered only by API or notification rules and are executed once per trigger

      • Cron Expression - (Not valid when using the trigger task type) Set schedule time, the Cron Expression is like:: * * * * * * sec min hour day month week, see details in CRON Expression Format
        For example: 0 0 3 * * * is Every day at 3 o'clock

      • Command - Just like writing shell/bat scripts, but line wrap is not recommended, Multiple Commands should be connected with &&/&
        For example, to execute a periodic reboot command, you can type reboot here

      • Coverage and Specific Servers - Similar to the settings on the Services page, select rules to determine which Agents need to execute scheduled tasks
        When using the trigger task type, you can select Only servers that are included in the notification rule

      • Notification Group - Select the notification method you have set up on the "Notification" page. Click here for more information

      • Send Success Notification - When this item is activated, a message notification will be triggered when the task is successfully executed

      Manage tasks

      To manage existing scheduled tasks, you can go to the "Tasks" page in the administration panel
      Select a task configuration and the three icons on the right, which are:

      • Execute Now - When clicked, the scheduled time will be ignored and the task will be executed immediately
      • Edit - Click to modify the task configuration
      • Delete - Delete this scheduled task

      FAQ

      1. Command not found
        Command not found may cause by missing PATH environment variable, for Linux Server, you may try adding source ~/.bashrc at beginning of your command or execute by absolute path.
      ',10),n=[s];function r(c,d,l,h,u,p){return t(),o("div",null,n)}const k=e(i,[["render",r]]);export{g as __pageData,k as default}; +import{_ as e,o as t,c as o,R as a}from"./chunks/framework.44fd0451.js";const g=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/guide/tasks.md","filePath":"en_US/guide/tasks.md","lastUpdated":1698335020000}'),i={name:"en_US/guide/tasks.md"},s=a('

      In the task area, you can set up scheduled tasks, Trigger tasks, and multi-server batch execution tasks

      Nezha monitoring supports pushing commands to the Agent for execution, so this feature is very flexible and can be used to periodically back up the server in conjunction with restic, rclone. Periodically restart a service to reset the network connection. It can also be used with notifications to perform a task when a notification is triggered, such as running a script when the CPU is at high occupancy for a long period of time.

      How to use

      Go to the "Tasks" page of the admin panel and click "Add Scheduled Task"
      To add a scheduled task you need to make the following settings:

      • Name - Customize a task name

      • Task Type - select the type of task
        Scheduled Tasks - Tasks are executed periodically at the scheduled time set below
        Trigger Tasks - Tasks that are triggered only by API or notification rules and are executed once per trigger

      • Cron Expression - (Not valid when using the trigger task type) Set schedule time, the Cron Expression is like:: * * * * * * sec min hour day month week, see details in CRON Expression Format
        For example: 0 0 3 * * * is Every day at 3 o'clock

      • Command - Just like writing shell/bat scripts, but line wrap is not recommended, Multiple Commands should be connected with &&/&
        For example, to execute a periodic reboot command, you can type reboot here

      • Coverage and Specific Servers - Similar to the settings on the Services page, select rules to determine which Agents need to execute scheduled tasks
        When using the trigger task type, you can select Only servers that are included in the notification rule

      • Notification Group - Select the notification method you have set up on the "Notification" page. Click here for more information

      • Send Success Notification - When this item is activated, a message notification will be triggered when the task is successfully executed

      Manage tasks

      To manage existing scheduled tasks, you can go to the "Tasks" page in the administration panel
      Select a task configuration and the three icons on the right, which are:

      • Execute Now - When clicked, the scheduled time will be ignored and the task will be executed immediately
      • Edit - Click to modify the task configuration
      • Delete - Delete this scheduled task

      FAQ

      1. Command not found
        Command not found may cause by missing PATH environment variable, for Linux Server, you may try adding source ~/.bashrc at beginning of your command or execute by absolute path.
      ',10),n=[s];function r(c,d,l,h,u,p){return t(),o("div",null,n)}const k=e(i,[["render",r]]);export{g as __pageData,k as default}; diff --git a/assets/en_US_guide_tasks.md.67055555.lean.js b/assets/en_US_guide_tasks.md.1ea501e8.lean.js similarity index 84% rename from assets/en_US_guide_tasks.md.67055555.lean.js rename to assets/en_US_guide_tasks.md.1ea501e8.lean.js index 9dc9db97..bb6a8106 100644 --- a/assets/en_US_guide_tasks.md.67055555.lean.js +++ b/assets/en_US_guide_tasks.md.1ea501e8.lean.js @@ -1 +1 @@ -import{_ as e,o as t,c as o,R as a}from"./chunks/framework.44fd0451.js";const g=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/guide/tasks.md","filePath":"en_US/guide/tasks.md","lastUpdated":1698142262000}'),i={name:"en_US/guide/tasks.md"},s=a("",10),n=[s];function r(c,d,l,h,u,p){return t(),o("div",null,n)}const k=e(i,[["render",r]]);export{g as __pageData,k as default}; +import{_ as e,o as t,c as o,R as a}from"./chunks/framework.44fd0451.js";const g=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"en_US/guide/tasks.md","filePath":"en_US/guide/tasks.md","lastUpdated":1698335020000}'),i={name:"en_US/guide/tasks.md"},s=a("",10),n=[s];function r(c,d,l,h,u,p){return t(),o("div",null,n)}const k=e(i,[["render",r]]);export{g as __pageData,k as default}; diff --git a/assets/en_US_index.md.0b5605cb.js b/assets/en_US_index.md.0b5605cb.js deleted file mode 100644 index 7a9ab76f..00000000 --- a/assets/en_US_index.md.0b5605cb.js +++ /dev/null @@ -1 +0,0 @@ -import{_ as e,o as t,c as a}from"./chunks/framework.44fd0451.js";const u=JSON.parse('{"title":"Nezha Monitoring","titleTemplate":"User Manual","description":"","frontmatter":{"layout":"home","title":"Nezha Monitoring","titleTemplate":"User Manual","hero":{"name":"Nezha Monitoring","text":"A open source, lightweight server and website monitoring and O&M tool","image":"https://raw.githubusercontent.com/naiba/nezha/master/resource/static/brand.svg","actions":[{"theme":"brand","text":"Learn More →","link":"/en_US/guide/dashboard"}]},"features":[{"title":"One-Click Installation","details":"Support one-click script installation Dashboard and Agent services for easy use; mainstream systems such as Linux, Windows, MacOS, OpenWRT, etc. are all supported."},{"title":"Real-time monitoring","details":"Supports monitoring the system status of multiple servers simultaneously, including monitoring the status of web pages, ports, and SSL certificates. It also supports sending notifications when there are failures or when data reaches the limit. Multiple notification methods are supported, such as Telegram, email, and WeChat."},{"title":"Easy O&M","details":"Support WebSSH, support data monitoring, support setting scheduled tasks, and support batch execution of tasks on servers."}]},"headers":[],"relativePath":"en_US/index.md","filePath":"en_US/index.md","lastUpdated":1698142262000}'),s={name:"en_US/index.md"};function n(i,o,r,l,d,p){return t(),a("div")}const m=e(s,[["render",n]]);export{u as __pageData,m as default}; diff --git a/assets/en_US_index.md.0b5605cb.lean.js b/assets/en_US_index.md.0b5605cb.lean.js deleted file mode 100644 index 7a9ab76f..00000000 --- a/assets/en_US_index.md.0b5605cb.lean.js +++ /dev/null @@ -1 +0,0 @@ -import{_ as e,o as t,c as a}from"./chunks/framework.44fd0451.js";const u=JSON.parse('{"title":"Nezha Monitoring","titleTemplate":"User Manual","description":"","frontmatter":{"layout":"home","title":"Nezha Monitoring","titleTemplate":"User Manual","hero":{"name":"Nezha Monitoring","text":"A open source, lightweight server and website monitoring and O&M tool","image":"https://raw.githubusercontent.com/naiba/nezha/master/resource/static/brand.svg","actions":[{"theme":"brand","text":"Learn More →","link":"/en_US/guide/dashboard"}]},"features":[{"title":"One-Click Installation","details":"Support one-click script installation Dashboard and Agent services for easy use; mainstream systems such as Linux, Windows, MacOS, OpenWRT, etc. are all supported."},{"title":"Real-time monitoring","details":"Supports monitoring the system status of multiple servers simultaneously, including monitoring the status of web pages, ports, and SSL certificates. It also supports sending notifications when there are failures or when data reaches the limit. Multiple notification methods are supported, such as Telegram, email, and WeChat."},{"title":"Easy O&M","details":"Support WebSSH, support data monitoring, support setting scheduled tasks, and support batch execution of tasks on servers."}]},"headers":[],"relativePath":"en_US/index.md","filePath":"en_US/index.md","lastUpdated":1698142262000}'),s={name:"en_US/index.md"};function n(i,o,r,l,d,p){return t(),a("div")}const m=e(s,[["render",n]]);export{u as __pageData,m as default}; diff --git a/assets/en_US_index.md.f9a5bc13.js b/assets/en_US_index.md.f9a5bc13.js new file mode 100644 index 00000000..3c101798 --- /dev/null +++ b/assets/en_US_index.md.f9a5bc13.js @@ -0,0 +1 @@ +import{_ as e,o as t,c as a}from"./chunks/framework.44fd0451.js";const u=JSON.parse('{"title":"Nezha Monitoring","titleTemplate":"User Manual","description":"","frontmatter":{"layout":"home","title":"Nezha Monitoring","titleTemplate":"User Manual","hero":{"name":"Nezha Monitoring","text":"A open source, lightweight server and website monitoring and O&M tool","image":"https://raw.githubusercontent.com/naiba/nezha/master/resource/static/brand.svg","actions":[{"theme":"brand","text":"Preview","link":"https://ops.naibahq.com"},{"theme":"alt","text":"Learn More →","link":"/en_US/guide/dashboard"}]},"features":[{"title":"One-Click Installation","details":"Support one-click script installation Dashboard and Agent services for easy use; mainstream systems such as Linux, Windows, MacOS, OpenWRT, etc. are all supported."},{"title":"Real-time monitoring","details":"Supports monitoring the system status of multiple servers simultaneously, including monitoring the status of web pages, ports, and SSL certificates. It also supports sending notifications when there are failures or when data reaches the limit. Multiple notification methods are supported, such as Telegram, email, and WeChat."},{"title":"Easy O&M","details":"Support WebSSH, support data monitoring, support setting scheduled tasks, and support batch execution of tasks on servers."}]},"headers":[],"relativePath":"en_US/index.md","filePath":"en_US/index.md","lastUpdated":1698335020000}'),s={name:"en_US/index.md"};function n(i,o,r,l,p,d){return t(),a("div")}const m=e(s,[["render",n]]);export{u as __pageData,m as default}; diff --git a/assets/en_US_index.md.f9a5bc13.lean.js b/assets/en_US_index.md.f9a5bc13.lean.js new file mode 100644 index 00000000..3c101798 --- /dev/null +++ b/assets/en_US_index.md.f9a5bc13.lean.js @@ -0,0 +1 @@ +import{_ as e,o as t,c as a}from"./chunks/framework.44fd0451.js";const u=JSON.parse('{"title":"Nezha Monitoring","titleTemplate":"User Manual","description":"","frontmatter":{"layout":"home","title":"Nezha Monitoring","titleTemplate":"User Manual","hero":{"name":"Nezha Monitoring","text":"A open source, lightweight server and website monitoring and O&M tool","image":"https://raw.githubusercontent.com/naiba/nezha/master/resource/static/brand.svg","actions":[{"theme":"brand","text":"Preview","link":"https://ops.naibahq.com"},{"theme":"alt","text":"Learn More →","link":"/en_US/guide/dashboard"}]},"features":[{"title":"One-Click Installation","details":"Support one-click script installation Dashboard and Agent services for easy use; mainstream systems such as Linux, Windows, MacOS, OpenWRT, etc. are all supported."},{"title":"Real-time monitoring","details":"Supports monitoring the system status of multiple servers simultaneously, including monitoring the status of web pages, ports, and SSL certificates. It also supports sending notifications when there are failures or when data reaches the limit. Multiple notification methods are supported, such as Telegram, email, and WeChat."},{"title":"Easy O&M","details":"Support WebSSH, support data monitoring, support setting scheduled tasks, and support batch execution of tasks on servers."}]},"headers":[],"relativePath":"en_US/index.md","filePath":"en_US/index.md","lastUpdated":1698335020000}'),s={name:"en_US/index.md"};function n(i,o,r,l,p,d){return t(),a("div")}const m=e(s,[["render",n]]);export{u as __pageData,m as default}; diff --git a/assets/guide_agent.md.1039f270.js b/assets/guide_agent.md.f52833ad.js similarity index 94% rename from assets/guide_agent.md.1039f270.js rename to assets/guide_agent.md.f52833ad.js index 85bca681..bf1d2e40 100644 --- a/assets/guide_agent.md.1039f270.js +++ b/assets/guide_agent.md.f52833ad.js @@ -1,4 +1,4 @@ -import{_ as s,o as n,c as a,R as l}from"./chunks/framework.44fd0451.js";const A=JSON.parse('{"title":"","description":"","frontmatter":{"outline":"deep"},"headers":[],"relativePath":"guide/agent.md","filePath":"guide/agent.md","lastUpdated":1698142262000}'),p={name:"guide/agent.md"},o=l(`

      哪吒监控的被控端服务被称为 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)

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

      在 Windows 中一键安装

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



      其他方式安装 Agent

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

      • 首先在管理面板中添加一台服务器
      • 在被控服务器中,运行脚本(位于中国大陆的服务器请使用镜像):
      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://cdn.jsdelivr.net/gh/naiba/nezha@master/script/install.sh -o nezha.sh && chmod +x nezha.sh && sudo CN=true ./nezha.sh
      • 选择“安装监控 Agent”
      • 输入通信域名,如:”data.example.com“
      • 输入面板通信端口(RPC端口),默认为 5555
      • 输入 Agent 密钥,Agent 密钥在管理面板中添加服务器时生成,可以在管理面板中的“主机”页中找到
      • 等待安装完成后返回 Dashboard 主页查看服务器是否上线

      在 其他 Linux 如 Alpine 使用 Openrc 的发行版 安装 Agent

      本节内容由 unknown0054 贡献

      • 修改 SERVER、SECRET、TLS 然后在 shell 中执行
      shell
      cat >/etc/init.d/nezha-agent<< EOF
      +import{_ as s,o as a,c as n,R as l}from"./chunks/framework.44fd0451.js";const A=JSON.parse('{"title":"","description":"","frontmatter":{"outline":"deep"},"headers":[],"relativePath":"guide/agent.md","filePath":"guide/agent.md","lastUpdated":1698335020000}'),p={name:"guide/agent.md"},o=l(`

      哪吒监控的被控端服务被称为 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)

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

      在 Windows 中一键安装

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



      其他方式安装 Agent

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

      • 首先在管理面板中添加一台服务器
      • 在被控服务器中,运行脚本(位于中国大陆的服务器请使用镜像):
      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://jihulab.com/nezha/dashboard/-/raw/master/script/install.sh -o nezha.sh && chmod +x nezha.sh && sudo CN=true ./nezha.sh
      • 选择“安装监控 Agent”
      • 输入通信域名,如:”data.example.com“
      • 输入面板通信端口(RPC端口),默认为 5555
      • 输入 Agent 密钥,Agent 密钥在管理面板中添加服务器时生成,可以在管理面板中的“主机”页中找到
      • 等待安装完成后返回 Dashboard 主页查看服务器是否上线

      在 其他 Linux 如 Alpine 使用 Openrc 的发行版 安装 Agent

      本节内容由 unknown0054 贡献

      • 修改 SERVER、SECRET、TLS 然后在 shell 中执行
      shell
      cat >/etc/init.d/nezha-agent<< EOF
       #!/sbin/openrc-run
       SERVER="" #Dashboard 地址 ip:port
       SECRET="" #SECRET
      @@ -135,4 +135,4 @@ import{_ as s,o as n,c as a,R as l}from"./chunks/framework.44fd0451.js";const A=
        stop
        sleep 2
        start
      -}
      • 运行 chmod +x /etc/init.d/nezha-service 赋予执行权限
      • 启动服务: /etc/init.d/nezha-service enable && /etc/init.d/nezha-service start



      FAQ

      Agent 有 Docker 镜像吗?

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

      `,54),e=[o];function t(c,r,D,y,C,F){return n(),a("div",null,e)}const u=s(p,[["render",t]]);export{A as __pageData,u as default}; +}
      • 运行 chmod +x /etc/init.d/nezha-service 赋予执行权限
      • 启动服务: /etc/init.d/nezha-service enable && /etc/init.d/nezha-service start



      FAQ

      Agent 有 Docker 镜像吗?

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

      `,54),e=[o];function t(c,r,D,y,C,F){return a(),n("div",null,e)}const u=s(p,[["render",t]]);export{A as __pageData,u as default}; diff --git a/assets/guide_agent.md.1039f270.lean.js b/assets/guide_agent.md.f52833ad.lean.js similarity index 54% rename from assets/guide_agent.md.1039f270.lean.js rename to assets/guide_agent.md.f52833ad.lean.js index d03fda9c..6fbdf1f9 100644 --- a/assets/guide_agent.md.1039f270.lean.js +++ b/assets/guide_agent.md.f52833ad.lean.js @@ -1 +1 @@ -import{_ as s,o as n,c as a,R as l}from"./chunks/framework.44fd0451.js";const A=JSON.parse('{"title":"","description":"","frontmatter":{"outline":"deep"},"headers":[],"relativePath":"guide/agent.md","filePath":"guide/agent.md","lastUpdated":1698142262000}'),p={name:"guide/agent.md"},o=l("",54),e=[o];function t(c,r,D,y,C,F){return n(),a("div",null,e)}const u=s(p,[["render",t]]);export{A as __pageData,u as default}; +import{_ as s,o as a,c as n,R as l}from"./chunks/framework.44fd0451.js";const A=JSON.parse('{"title":"","description":"","frontmatter":{"outline":"deep"},"headers":[],"relativePath":"guide/agent.md","filePath":"guide/agent.md","lastUpdated":1698335020000}'),p={name:"guide/agent.md"},o=l("",54),e=[o];function t(c,r,D,y,C,F){return a(),n("div",null,e)}const u=s(p,[["render",t]]);export{A as __pageData,u as default}; diff --git a/assets/guide_agentq.md.1adcb3de.js b/assets/guide_agentq.md.9be55476.js similarity index 96% rename from assets/guide_agentq.md.1adcb3de.js rename to assets/guide_agentq.md.9be55476.js index cd59eb8f..38814405 100644 --- a/assets/guide_agentq.md.1adcb3de.js +++ b/assets/guide_agentq.md.9be55476.js @@ -1 +1 @@ -import{_ as e,o as t,c as a,R as o}from"./chunks/framework.44fd0451.js";const p=JSON.parse('{"title":"","description":"","frontmatter":{"outline":"deep"},"headers":[],"relativePath":"guide/agentq.md","filePath":"guide/agentq.md","lastUpdated":1698142262000}'),n={name:"guide/agentq.md"},r=o('

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

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

      一键脚本安装时出错

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

      多出现在国内主机中,目前一键脚本只从 Github 直接获取安装脚本,您可以多尝试几次,或者手动安装 Agent,别忘了使用镜像。

      sudo: command not found

      请先手动安装 sudo。

      ',7),d=[r];function c(i,s,u,h,l,m){return t(),a("div",null,d)}const g=e(n,[["render",c]]);export{p as __pageData,g as default}; +import{_ as e,o as t,c as a,R as o}from"./chunks/framework.44fd0451.js";const p=JSON.parse('{"title":"","description":"","frontmatter":{"outline":"deep"},"headers":[],"relativePath":"guide/agentq.md","filePath":"guide/agentq.md","lastUpdated":1698335020000}'),n={name:"guide/agentq.md"},r=o('

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

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

      一键脚本安装时出错

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

      多出现在国内主机中,目前一键脚本只从 Github 直接获取安装脚本,您可以多尝试几次,或者手动安装 Agent,别忘了使用镜像。

      sudo: command not found

      请先手动安装 sudo。

      ',7),d=[r];function c(i,s,u,h,l,m){return t(),a("div",null,d)}const g=e(n,[["render",c]]);export{p as __pageData,g as default}; diff --git a/assets/guide_agentq.md.1adcb3de.lean.js b/assets/guide_agentq.md.9be55476.lean.js similarity index 84% rename from assets/guide_agentq.md.1adcb3de.lean.js rename to assets/guide_agentq.md.9be55476.lean.js index 4f21a02b..449ddf0a 100644 --- a/assets/guide_agentq.md.1adcb3de.lean.js +++ b/assets/guide_agentq.md.9be55476.lean.js @@ -1 +1 @@ -import{_ as e,o as t,c as a,R as o}from"./chunks/framework.44fd0451.js";const p=JSON.parse('{"title":"","description":"","frontmatter":{"outline":"deep"},"headers":[],"relativePath":"guide/agentq.md","filePath":"guide/agentq.md","lastUpdated":1698142262000}'),n={name:"guide/agentq.md"},r=o("",7),d=[r];function c(i,s,u,h,l,m){return t(),a("div",null,d)}const g=e(n,[["render",c]]);export{p as __pageData,g as default}; +import{_ as e,o as t,c as a,R as o}from"./chunks/framework.44fd0451.js";const p=JSON.parse('{"title":"","description":"","frontmatter":{"outline":"deep"},"headers":[],"relativePath":"guide/agentq.md","filePath":"guide/agentq.md","lastUpdated":1698335020000}'),n={name:"guide/agentq.md"},r=o("",7),d=[r];function c(i,s,u,h,l,m){return t(),a("div",null,d)}const g=e(n,[["render",c]]);export{p as __pageData,g as default}; diff --git a/assets/guide_api.md.e60064a2.js b/assets/guide_api.md.7a222ed7.js similarity index 99% rename from assets/guide_api.md.e60064a2.js rename to assets/guide_api.md.7a222ed7.js index b457208f..1fbb93f9 100644 --- a/assets/guide_api.md.e60064a2.js +++ b/assets/guide_api.md.7a222ed7.js @@ -1,4 +1,4 @@ -import{_ as s,o as n,c as a,R as o}from"./chunks/framework.44fd0451.js";const y=JSON.parse('{"title":"","description":"","frontmatter":{"outline":"deep"},"headers":[],"relativePath":"guide/api.md","filePath":"guide/api.md","lastUpdated":1698142262000}'),l={name:"guide/api.md"},p=o(`

      哪吒面板现在已经支持使用 API 接口查询面板中 Agent 的状态信息

      创建 Token

      哪吒面板的 API 接口允许使用 Token 认证与 Cookies 认证
      要新建一个 Token,在进入管理面板后,点击右上角的头像,选择 “API Token”,进入 Token 管理页面
      点击 “添加 Token”,自定义备注后,点击 “添加”
      如需删除一个 Token,请选择相应的 Token,点击右侧的删除图标

      WARNING

      Token 是 API 接口的鉴权工具,它对你的面板的信息安全非常重要,请不要泄漏你的 Token 给他人

      认证方式

      Token 认证方式:

      Request Headers:  
      +import{_ as s,o as n,c as a,R as o}from"./chunks/framework.44fd0451.js";const y=JSON.parse('{"title":"","description":"","frontmatter":{"outline":"deep"},"headers":[],"relativePath":"guide/api.md","filePath":"guide/api.md","lastUpdated":1698335020000}'),l={name:"guide/api.md"},p=o(`

      哪吒面板现在已经支持使用 API 接口查询面板中 Agent 的状态信息

      创建 Token

      哪吒面板的 API 接口允许使用 Token 认证与 Cookies 认证
      要新建一个 Token,在进入管理面板后,点击右上角的头像,选择 “API Token”,进入 Token 管理页面
      点击 “添加 Token”,自定义备注后,点击 “添加”
      如需删除一个 Token,请选择相应的 Token,点击右侧的删除图标

      WARNING

      Token 是 API 接口的鉴权工具,它对你的面板的信息安全非常重要,请不要泄漏你的 Token 给他人

      认证方式

      Token 认证方式:

      Request Headers:  
       Authorization: Token

      使用说明

      WARNING

      下面示例中的负数时间戳为(0000-00-00)
      目前表示 Dashboard 上线后该 Agent 从未汇报过
      但不建议用正负性判断状态

      TIP

      请求方式为 Get,返回格式为 JSON

      • 获取服务器列表:GET /api/v1/server/list?tag=
        query: tag (ServerTag 是服务器的分组,提供此参数则仅查询该分组中的服务器)

      JSON 返回示例:

      {
           "code": 0,
           "message": "success",
      diff --git a/assets/guide_api.md.e60064a2.lean.js b/assets/guide_api.md.7a222ed7.lean.js
      similarity index 84%
      rename from assets/guide_api.md.e60064a2.lean.js
      rename to assets/guide_api.md.7a222ed7.lean.js
      index d43e5e86..07519c8a 100644
      --- a/assets/guide_api.md.e60064a2.lean.js
      +++ b/assets/guide_api.md.7a222ed7.lean.js
      @@ -1 +1 @@
      -import{_ as s,o as n,c as a,R as o}from"./chunks/framework.44fd0451.js";const y=JSON.parse('{"title":"","description":"","frontmatter":{"outline":"deep"},"headers":[],"relativePath":"guide/api.md","filePath":"guide/api.md","lastUpdated":1698142262000}'),l={name:"guide/api.md"},p=o("",16),t=[p];function e(c,u,q,C,A,i){return n(),a("div",null,t)}const D=s(l,[["render",e]]);export{y as __pageData,D as default};
      +import{_ as s,o as n,c as a,R as o}from"./chunks/framework.44fd0451.js";const y=JSON.parse('{"title":"","description":"","frontmatter":{"outline":"deep"},"headers":[],"relativePath":"guide/api.md","filePath":"guide/api.md","lastUpdated":1698335020000}'),l={name:"guide/api.md"},p=o("",16),t=[p];function e(c,u,q,C,A,i){return n(),a("div",null,t)}const D=s(l,[["render",e]]);export{y as __pageData,D as default};
      diff --git a/assets/guide_dashboard.md.53a64459.js b/assets/guide_dashboard.md.2972db90.js
      similarity index 79%
      rename from assets/guide_dashboard.md.53a64459.js
      rename to assets/guide_dashboard.md.2972db90.js
      index 3c4c539e..685c5924 100644
      --- a/assets/guide_dashboard.md.53a64459.js
      +++ b/assets/guide_dashboard.md.2972db90.js
      @@ -1,4 +1,4 @@
      -import{_ as a,o as s,c as e,R as l}from"./chunks/framework.44fd0451.js";const b=JSON.parse('{"title":"","description":"","frontmatter":{"outline":"deep"},"headers":[],"relativePath":"guide/dashboard.md","filePath":"guide/dashboard.md","lastUpdated":1698142262000}'),n={name:"guide/dashboard.md"},o=l(`

      准备工作

      搭建一个哪吒监控,你需要:

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

      TIP

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

      1. 一个 Github 账号(或:Gitlab、Jihulab、Gitee)

      TIP

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

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

      WARNING

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



      获取 Github/Jihulab 的 Client ID 和密钥

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

      • 首先我们需要新建一个验证应用,以 Github 为例,登录 Github 后,打开 https://github.com/settings/developers ,依次选择“OAuth Apps” - “New OAuth App”
        Application name - 随意填写
        Homepage URL - 填写面板的访问域名,如:"http://cdn.example.com"
        Authorization callback URL - 填写回调地址,如:"http://cdn.example.com/oauth2/callback"
      • 点击 “Register application”
      • 保存页面中的 Client ID,然后点击 “Generate a new client secret“,创建一个新的 Client Secret,新建的密钥仅会显示一次,请妥善保存

      • JihuLab 的应用创建入口为:https://jihulab.com/-/profile/applications
      • Redirect URL 中应填入回调地址
      • 在下方范围中勾选 read_userread_api
      • 创建完成后,保存好应用程序 ID 和密码

      在服务器中安装 Dashboard

      • 在面板服务器中,运行安装脚本:
      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://cdn.jsdelivr.net/gh/naiba/nezha@master/script/install.sh -o nezha.sh && chmod +x nezha.sh && sudo CN=true ./nezha.sh
      • 等待Docker安装完毕后,分别输入以下值:
        OAuth提供商 - Github,Gitlab,Jihulab,Gitee 中选择一个
        Client ID - 之前保存的 Client ID
        Client Secret - 之前保存的密钥
        用户名 - OAuth 提供商中的用户名
        站点标题 - 自定义站点标题
        访问端口 - 公开访问端口,可自定义,默认 8008
        Agent的通信端口 - Agent与Dashboard的通信端口,默认 5555

      • 输入完成后,等待拉取镜像
        安装结束后,如果一切正常,此时你可以访问域名+端口号,如 “http://cdn.example.com:8008” 来查看面板

      • 将来如果需要再次运行脚本,可以运行:

      bash
      ./nezha.sh

      来打开管理脚本


      配置反向代理

      • 在宝塔面板中新建一个站点,域名填写公开访问域名,如 “http://cdn.example.com“ ,然后点击“设置”进入站点设置选项,选择“反向代理” - “新建反向代理”

      • 自定义一个代理名称,在下方“目标 URL”中填入 http://127.0.0.1 然后点击“保存”

      • 打开刚刚新建的反向代理右边的“配置文件”,将配置文件替换为以下内容:

      nginx
      #PROXY-START/
      +import{_ as a,o as s,c as e,R as l}from"./chunks/framework.44fd0451.js";const b=JSON.parse('{"title":"","description":"","frontmatter":{"outline":"deep"},"headers":[],"relativePath":"guide/dashboard.md","filePath":"guide/dashboard.md","lastUpdated":1698335020000}'),o={name:"guide/dashboard.md"},n=l(`

      准备工作

      搭建一个哪吒监控,你需要:

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

      TIP

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

      1. 一个 Github 账号(或:Gitlab、Jihulab、Gitee)

      TIP

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

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

      WARNING

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



      获取 Github/Jihulab 的 Client ID 和密钥

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

      • 首先我们需要新建一个验证应用,以 Github 为例,登录 Github 后,打开 https://github.com/settings/developers ,依次选择“OAuth Apps” - “New OAuth App”
        Application name - 随意填写
        Homepage URL - 填写面板的访问域名,如:"http://cdn.example.com"
        Authorization callback URL - 填写回调地址,如:"http://cdn.example.com/oauth2/callback"
      • 点击 “Register application”
      • 保存页面中的 Client ID,然后点击 “Generate a new client secret“,创建一个新的 Client Secret,新建的密钥仅会显示一次,请妥善保存

      • JihuLab 的应用创建入口为:https://jihulab.com/-/profile/applications
      • Redirect URL 中应填入回调地址
      • 在下方范围中勾选 read_userread_api
      • 创建完成后,保存好应用程序 ID 和密码

      在服务器中安装 Dashboard

      • 在面板服务器中,运行安装脚本:
      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://jihulab.com/nezha/dashboard/-/raw/master/script/install.sh -o nezha.sh && chmod +x nezha.sh && sudo CN=true ./nezha.sh
      • 等待Docker安装完毕后,分别输入以下值:
        OAuth提供商 - Github,Gitlab,Jihulab,Gitee 中选择一个
        Client ID - 之前保存的 Client ID
        Client Secret - 之前保存的密钥
        用户名 - OAuth 提供商中的用户名
        站点标题 - 自定义站点标题
        访问端口 - 公开访问端口,可自定义,默认 8008
        Agent的通信端口 - Agent与Dashboard的通信端口,默认 5555

      • 输入完成后,等待拉取镜像
        安装结束后,如果一切正常,此时你可以访问域名+端口号,如 “http://cdn.example.com:8008” 来查看面板

      • 将来如果需要再次运行脚本,可以运行:

      bash
      ./nezha.sh

      来打开管理脚本


      配置反向代理

      • 在宝塔面板中新建一个站点,域名填写公开访问域名,如 “http://cdn.example.com“ ,然后点击“设置”进入站点设置选项,选择“反向代理” - “新建反向代理”

      • 自定义一个代理名称,在下方“目标 URL”中填入 http://127.0.0.1 然后点击“保存”

      • 打开刚刚新建的反向代理右边的“配置文件”,将配置文件替换为以下内容:

      nginx
      #PROXY-START/
       location / {
           proxy_pass http://127.0.0.1:8008;
           proxy_set_header Host $http_host;
      @@ -18,4 +18,4 @@ import{_ as a,o as s,c as e,R as l}from"./chunks/framework.44fd0451.js";const b=
       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://cdn.example.com" 和 "https://cdn.example.com/oauth2/callback" ,不更改此项可能会导致你无法登录面板后台

    FAQ

    启用HTTPS后/terminal或/ws不能正常连接怎么办?

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

    我对面板提供的数据修改/增加功能不满意,我想要自己修改/增加数据怎么办?

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

    DANGER

    再重复一遍,请勿随意修改数据库!

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

    数据库中各表/列是什么意思?

    文档不提供数据库解释,有能力修改数据库的稍加分析应该就足以看懂。

    Dashboard 会自动更新吗?

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

    如何更新 Dashboard?

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

    `,44),t=[o];function p(r,c,i,h,d,C){return s(),e("div",null,t)}const A=a(n,[["render",p]]);export{b as __pageData,A as default}; +}


在宝塔面板中配置 SSL

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

FAQ

启用HTTPS后/terminal或/ws不能正常连接怎么办?

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

我对面板提供的数据修改/增加功能不满意,我想要自己修改/增加数据怎么办?

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

DANGER

再重复一遍,请勿随意修改数据库!

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

数据库中各表/列是什么意思?

文档不提供数据库解释,有能力修改数据库的稍加分析应该就足以看懂。

Dashboard 会自动更新吗?

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

如何更新 Dashboard?

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

`,44),t=[n];function p(r,c,i,h,d,C){return s(),e("div",null,t)}const A=a(o,[["render",p]]);export{b as __pageData,A as default}; diff --git a/assets/guide_dashboard.md.53a64459.lean.js b/assets/guide_dashboard.md.2972db90.lean.js similarity index 55% rename from assets/guide_dashboard.md.53a64459.lean.js rename to assets/guide_dashboard.md.2972db90.lean.js index ffdcf71c..9ef7a071 100644 --- a/assets/guide_dashboard.md.53a64459.lean.js +++ b/assets/guide_dashboard.md.2972db90.lean.js @@ -1 +1 @@ -import{_ as a,o as s,c as e,R as l}from"./chunks/framework.44fd0451.js";const b=JSON.parse('{"title":"","description":"","frontmatter":{"outline":"deep"},"headers":[],"relativePath":"guide/dashboard.md","filePath":"guide/dashboard.md","lastUpdated":1698142262000}'),n={name:"guide/dashboard.md"},o=l("",44),t=[o];function p(r,c,i,h,d,C){return s(),e("div",null,t)}const A=a(n,[["render",p]]);export{b as __pageData,A as default}; +import{_ as a,o as s,c as e,R as l}from"./chunks/framework.44fd0451.js";const b=JSON.parse('{"title":"","description":"","frontmatter":{"outline":"deep"},"headers":[],"relativePath":"guide/dashboard.md","filePath":"guide/dashboard.md","lastUpdated":1698335020000}'),o={name:"guide/dashboard.md"},n=l("",44),t=[n];function p(r,c,i,h,d,C){return s(),e("div",null,t)}const A=a(o,[["render",p]]);export{b as __pageData,A as default}; diff --git a/assets/guide_dashboardq.md.cc10e28e.js b/assets/guide_dashboardq.md.74dfbf6e.js similarity index 98% rename from assets/guide_dashboardq.md.cc10e28e.js rename to assets/guide_dashboardq.md.74dfbf6e.js index 2a66061f..cd45742b 100644 --- a/assets/guide_dashboardq.md.cc10e28e.js +++ b/assets/guide_dashboardq.md.74dfbf6e.js @@ -1,4 +1,4 @@ -import{_ as s,o as a,c as n,R as o}from"./chunks/framework.44fd0451.js";const b=JSON.parse('{"title":"","description":"","frontmatter":{"outline":"deep"},"headers":[],"relativePath":"guide/dashboardq.md","filePath":"guide/dashboardq.md","lastUpdated":1698142262000}'),l={name:"guide/dashboardq.md"},e=o(`

为什么管理面板中显示的 IP 和 Agent 实际 IP 不一致?

首先解释管理面板中显示的IP是怎么得到的:Agent 会每隔一段时间请求一遍 IP-API,获取到 IP 信息后上报到 Dashboard,目前使用的 IP-API 可在此查看:myip.go
如您发现管理面板中显示的 IP 和服务商提供给您的 IP 不一致,最大的可能是服务商给您的是入口 IP,但Agent测试的是您的出口 IP。这个问题也可能会出现在多线服务器和 IPLC 专线中。

TIP

举个简单也十分常见的例子,服务商给您提供的是一台高防服务器,为了同时满足高防和低网络中断率的目标,提供给您的 IP 可能是经过映射后的高防 IP 而并非您服务器的真实出口 IP

您也可以在 Agent 服务器中运行以下命令测试出口IP:

shell
curl https://ipapi.co/ip/
+import{_ as s,o as a,c as n,R as o}from"./chunks/framework.44fd0451.js";const b=JSON.parse('{"title":"","description":"","frontmatter":{"outline":"deep"},"headers":[],"relativePath":"guide/dashboardq.md","filePath":"guide/dashboardq.md","lastUpdated":1698335020000}'),l={name:"guide/dashboardq.md"},e=o(`

为什么管理面板中显示的 IP 和 Agent 实际 IP 不一致?

首先解释管理面板中显示的IP是怎么得到的:Agent 会每隔一段时间请求一遍 IP-API,获取到 IP 信息后上报到 Dashboard,目前使用的 IP-API 可在此查看:myip.go
如您发现管理面板中显示的 IP 和服务商提供给您的 IP 不一致,最大的可能是服务商给您的是入口 IP,但Agent测试的是您的出口 IP。这个问题也可能会出现在多线服务器和 IPLC 专线中。

TIP

举个简单也十分常见的例子,服务商给您提供的是一台高防服务器,为了同时满足高防和低网络中断率的目标,提供给您的 IP 可能是经过映射后的高防 IP 而并非您服务器的真实出口 IP

您也可以在 Agent 服务器中运行以下命令测试出口IP:

shell
curl https://ipapi.co/ip/
 curl ip.sb
 curl ip-api.com

忘记查看密码\\删除查看密码

请查看或编辑 /opt/nezha/dashboard/data/config.yaml 文件。
密码位于 site-viewpassword 项中。

面板安装/重启/更新失败: iptables ......

首先尝试重启 Docker 再操作

shell
systemctl status docker
 systemctl restart docker
diff --git a/assets/guide_dashboardq.md.cc10e28e.lean.js b/assets/guide_dashboardq.md.74dfbf6e.lean.js
similarity index 70%
rename from assets/guide_dashboardq.md.cc10e28e.lean.js
rename to assets/guide_dashboardq.md.74dfbf6e.lean.js
index 9adff352..310dc7d0 100644
--- a/assets/guide_dashboardq.md.cc10e28e.lean.js
+++ b/assets/guide_dashboardq.md.74dfbf6e.lean.js
@@ -1 +1 @@
-import{_ as s,o as a,c as n,R as o}from"./chunks/framework.44fd0451.js";const b=JSON.parse('{"title":"","description":"","frontmatter":{"outline":"deep"},"headers":[],"relativePath":"guide/dashboardq.md","filePath":"guide/dashboardq.md","lastUpdated":1698142262000}'),l={name:"guide/dashboardq.md"},e=o("",18),p=[e];function t(r,c,i,d,h,y){return a(),n("div",null,p)}const D=s(l,[["render",t]]);export{b as __pageData,D as default};
+import{_ as s,o as a,c as n,R as o}from"./chunks/framework.44fd0451.js";const b=JSON.parse('{"title":"","description":"","frontmatter":{"outline":"deep"},"headers":[],"relativePath":"guide/dashboardq.md","filePath":"guide/dashboardq.md","lastUpdated":1698335020000}'),l={name:"guide/dashboardq.md"},e=o("",18),p=[e];function t(r,c,i,d,h,y){return a(),n("div",null,p)}const D=s(l,[["render",t]]);export{b as __pageData,D as default};
diff --git a/assets/guide_loginq.md.bd9f6604.js b/assets/guide_loginq.md.2906d3ff.js
similarity index 98%
rename from assets/guide_loginq.md.bd9f6604.js
rename to assets/guide_loginq.md.2906d3ff.js
index 7b355fb8..010656ed 100644
--- a/assets/guide_loginq.md.bd9f6604.js
+++ b/assets/guide_loginq.md.2906d3ff.js
@@ -1 +1 @@
-import{_ as e,o as t,c as a,R as o}from"./chunks/framework.44fd0451.js";const m=JSON.parse('{"title":"","description":"","frontmatter":{"outline":"deep"},"headers":[],"relativePath":"guide/loginq.md","filePath":"guide/loginq.md","lastUpdated":1698142262000}'),i={name:"guide/loginq.md"},r=o('

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

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

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

TIP

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

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

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

登录后面板报错

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

lookup xxx

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

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

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

oauth2: server response missing access_token

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

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

您登陆错了账号或者配置错了用户名,注意用户名不是邮箱,可使用脚本修改。

dial tcp xxx:443 i/o timeout

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

net/http: TLS handshake timeout

同上。

',21),s=[r];function l(n,h,c,d,p,u){return t(),a("div",null,s)}const k=e(i,[["render",l]]);export{m as __pageData,k as default}; +import{_ as e,o as t,c as a,R as o}from"./chunks/framework.44fd0451.js";const m=JSON.parse('{"title":"","description":"","frontmatter":{"outline":"deep"},"headers":[],"relativePath":"guide/loginq.md","filePath":"guide/loginq.md","lastUpdated":1698335020000}'),i={name:"guide/loginq.md"},r=o('

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

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

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

TIP

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

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

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

登录后面板报错

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

lookup xxx

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

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

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

oauth2: server response missing access_token

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

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

您登陆错了账号或者配置错了用户名,注意用户名不是邮箱,可使用脚本修改。

dial tcp xxx:443 i/o timeout

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

net/http: TLS handshake timeout

同上。

',21),s=[r];function l(n,h,c,d,p,u){return t(),a("div",null,s)}const k=e(i,[["render",l]]);export{m as __pageData,k as default}; diff --git a/assets/guide_loginq.md.bd9f6604.lean.js b/assets/guide_loginq.md.2906d3ff.lean.js similarity index 84% rename from assets/guide_loginq.md.bd9f6604.lean.js rename to assets/guide_loginq.md.2906d3ff.lean.js index 2f017682..81e1e680 100644 --- a/assets/guide_loginq.md.bd9f6604.lean.js +++ b/assets/guide_loginq.md.2906d3ff.lean.js @@ -1 +1 @@ -import{_ as e,o as t,c as a,R as o}from"./chunks/framework.44fd0451.js";const m=JSON.parse('{"title":"","description":"","frontmatter":{"outline":"deep"},"headers":[],"relativePath":"guide/loginq.md","filePath":"guide/loginq.md","lastUpdated":1698142262000}'),i={name:"guide/loginq.md"},r=o("",21),s=[r];function l(n,h,c,d,p,u){return t(),a("div",null,s)}const k=e(i,[["render",l]]);export{m as __pageData,k as default}; +import{_ as e,o as t,c as a,R as o}from"./chunks/framework.44fd0451.js";const m=JSON.parse('{"title":"","description":"","frontmatter":{"outline":"deep"},"headers":[],"relativePath":"guide/loginq.md","filePath":"guide/loginq.md","lastUpdated":1698335020000}'),i={name:"guide/loginq.md"},r=o("",21),s=[r];function l(n,h,c,d,p,u){return t(),a("div",null,s)}const k=e(i,[["render",l]]);export{m as __pageData,k as default}; diff --git a/assets/guide_notifications.md.81d5e210.js b/assets/guide_notifications.md.0d1686ff.js similarity index 99% rename from assets/guide_notifications.md.81d5e210.js rename to assets/guide_notifications.md.0d1686ff.js index 1b1235bf..986be8c0 100644 --- a/assets/guide_notifications.md.81d5e210.js +++ b/assets/guide_notifications.md.0d1686ff.js @@ -1,4 +1,4 @@ -import{_ as o,o as s,c as l,R as n}from"./chunks/framework.44fd0451.js";const q=JSON.parse('{"title":"","description":"","frontmatter":{"outline":"deep"},"headers":[],"relativePath":"guide/notifications.md","filePath":"guide/notifications.md","lastUpdated":1698142262000}'),a={name:"guide/notifications.md"},t=n(`

哪吒监控支持对服务器的负载、CPU、内存、硬盘、流量、月流量、进程数、连接数进行监控,并在其中某项达到用户设定值时发送报警通知

灵活的通知方式

在面板消息中,占位符 #DATETIME# 代表事件发生的时间戳。当通知被触发时,面板会自动将 #DATETIME# 替换为事件的实际时间。

#NEZHA# 是面板消息占位符,面板触发通知时会自动用实际消息替换占位符

Body 内容是JSON 格式的:当请求类型为 FORM 时,值为 key:value 的形式,value 里面可放置占位符,通知时会自动替换。当请求类型为 JSON 时 只会简单进行字符串替换后直接提交到URL

URL 里面也可放置占位符,请求时会进行简单的字符串替换。

你可以参考以下的通知方式示例,也可以根据自己的需求灵活设置推送方式

- diff --git a/case/index.html b/case/index.html index 19556405..dec5b41a 100644 --- a/case/index.html +++ b/case/index.html @@ -10,13 +10,13 @@ - +
Skip to content

哪吒监控社区项目

社区贡献的相关项目

为哪吒监控提供了更多扩展

提交项目

我们欢迎您提交自己的项目,请加入TG群联系管理员了解相关事宜

注意事项

所有项目均由社区成员贡献,请您知悉哪吒监控团队无法为社区项目承担包括且不限于:保修、可用性、安全性等责任

- diff --git a/developer/index.html b/developer/index.html index 18ebcec2..e0f3c39f 100644 --- a/developer/index.html +++ b/developer/index.html @@ -10,13 +10,13 @@ - +
Skip to content

开发手册

哪吒监控开发手册

我们欢迎你提出高质量的Pull Request,帮助哪吒监控变得更好!

- diff --git a/developer/l10n.html b/developer/l10n.html index 81e1be2c..90e8e700 100644 --- a/developer/l10n.html +++ b/developer/l10n.html @@ -10,13 +10,13 @@ - + -
Skip to content
On this page

哪吒监控的 Dashboard 已经添加本地化,支持多个语言,你可以在开发新功能时遵循以下步骤来支持本地化

介绍

  1. 你可以直接使用 /resource/l10n/zh-CN.toml 中已有的文本配置来替换新功能中的文本
  2. 如果新功能中有新增文本,请参考 zh-CN.toml 的配置文本,将新文本拉取到 zh-CN.toml 等其他语言的配置文件中,并添加翻译

新本地化文本的添加

  1. /resource/l10n/ 中添加新的语言文本配置
  2. 在新的语言文本配置中拉取其他语言已有的文本配置
  3. 为新的语言文本配置添加翻译
- diff --git a/developer/theme.html b/developer/theme.html index 5214d855..85a4dc18 100644 --- a/developer/theme.html +++ b/developer/theme.html @@ -10,13 +10,13 @@ - + -
Skip to content
On this page

哪吒主题开发环境

哪吒面板提供了主题开发环境,你可以使用它来创建新的哪吒监控主题

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 中修改配置。
- diff --git a/en_US/case/case1.html b/en_US/case/case1.html index e196b22c..78798635 100644 --- a/en_US/case/case1.html +++ b/en_US/case/case1.html @@ -10,13 +10,13 @@ - + -
Skip to content
On this page

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.

- diff --git a/en_US/case/case2.html b/en_US/case/case2.html index cb86e78f..bd445947 100644 --- a/en_US/case/case2.html +++ b/en_US/case/case2.html @@ -11,13 +11,13 @@ - + -
Skip to content
On this page

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.

- diff --git a/en_US/case/case3.html b/en_US/case/case3.html index b255cbd4..0e48c134 100644 --- a/en_US/case/case3.html +++ b/en_US/case/case3.html @@ -10,13 +10,13 @@ - + -
Skip to content
On this page

Build your own server status query Telegram bot with multi-language and multi-user support

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)
- diff --git a/en_US/case/case4.html b/en_US/case/case4.html index 65f88bf3..76393995 100644 --- a/en_US/case/case4.html +++ b/en_US/case/case4.html @@ -10,13 +10,13 @@ - + - - diff --git a/en_US/case/case5.html b/en_US/case/case5.html index c85ed6f8..5e596c70 100644 --- a/en_US/case/case5.html +++ b/en_US/case/case5.html @@ -10,7 +10,7 @@ - + @@ -67,8 +67,8 @@ | |-- grpcwebproxy # gRPC reverse proxy main program. | `-- nezha-agent # Nezha client, used to monitor the localhost. |-- dbfile # Record the name of the latest restore or backup file -`-- version # Record the current panel app version

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.
- diff --git a/en_US/case/index.html b/en_US/case/index.html index d2599057..f6852eca 100644 --- a/en_US/case/index.html +++ b/en_US/case/index.html @@ -10,13 +10,13 @@ - +
Skip to content

Nezha Monitoring

Community Project

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

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.

- diff --git a/en_US/developer/index.html b/en_US/developer/index.html index d95dd24d..54ba91ea 100644 --- a/en_US/developer/index.html +++ b/en_US/developer/index.html @@ -10,13 +10,13 @@ - + - diff --git a/en_US/developer/l10n.html b/en_US/developer/l10n.html index 257778bb..eb65886c 100644 --- a/en_US/developer/l10n.html +++ b/en_US/developer/l10n.html @@ -10,13 +10,13 @@ - + -
Skip to content
On this page

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.
- diff --git a/en_US/developer/theme.html b/en_US/developer/theme.html index f638cba3..68550bfd 100644 --- a/en_US/developer/theme.html +++ b/en_US/developer/theme.html @@ -10,13 +10,13 @@ - + -
Skip to content
On this page

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.
- diff --git a/en_US/guide/agent.html b/en_US/guide/agent.html index b6da4dfe..390478f3 100644 --- a/en_US/guide/agent.html +++ b/en_US/guide/agent.html @@ -10,7 +10,7 @@ - + @@ -148,8 +148,8 @@ stop sleep 2 start -}

FAQ

Is there a Docker image for Agent?

There is currently no Docker image for Agent.
The Agent is designed to be the opposite of the Dashboard, in that the Dashboard is designed to work without affecting the server as much as possible, while the Agent needs to execute monitoring services and run commands in the server.
Putting the Agent in a container does continue to execute monitoring services, but features such as WebShell do not work, so we do not provide Docker image of the Agent.

- diff --git a/en_US/guide/agentq.html b/en_US/guide/agentq.html index 82fb52f3..ad02deca 100644 --- a/en_US/guide/agentq.html +++ b/en_US/guide/agentq.html @@ -10,13 +10,13 @@ - + -
Skip to content
On this page

Why the IP displayed in the admin panel and the actual IP of the Agent are not the same?

Please check Dashboard - Why the IP displayed in the admin panel and the actual IP of the Agent are not the same?

Error on one-click script installation

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

Please check if your server can connect to Github, try again, or check Other ways to install Agent

sudo: command not found

Please install sudo first

- diff --git a/en_US/guide/api.html b/en_US/guide/api.html index 7c7a82e0..2505bb73 100644 --- a/en_US/guide/api.html +++ b/en_US/guide/api.html @@ -10,7 +10,7 @@ - + @@ -124,8 +124,8 @@ } } ] -} - diff --git a/en_US/guide/dashboard.html b/en_US/guide/dashboard.html index 0b4d2b1a..0869ca55 100644 --- a/en_US/guide/dashboard.html +++ b/en_US/guide/dashboard.html @@ -10,7 +10,7 @@ - + @@ -35,8 +35,8 @@ proxy /terminal/* http://ip:8008 { websocket header_upstream -Origin -}

Configuring SSL in the aaPanel

First, temporarily disable the reverse proxy
As with other websites, you can choose to automatically apply for a Let´s Encrypt certificate or manually configure an existing certificate by going to "SSL" in the site settings
After you finish setting up SSL, you need to go back to https://github.com/settings/developers and edit the authentication application you created before, change all the domain names in the "Homepage URL" and "Authorization callback URL" you filled in before from http to https, such as: "https://cdn.example.com" and "https://cdn.example.com/oauth2/callback", If you don't change these links, you may not be able to log into the admin panel

FAQ

What should I do if /terminal or /ws cannot be connected after HTTPS is enabled?

It is often caused by incomplete certificates. Please add -d to the agent running parameters. If there is x509: certificate signed by unknown authority in the log, replacing the complete certificate can solve the problem 100%.

I am not satisfied with the data modification or addition function provided by the Dashboard, what if I want to modify or add data myself?

Commonly used in requirements such as batch installation of Agents, where you can modify the database directly.
Please note that not everything can be modified in the database, wrong modification will lead to data confusion and failure to start Dashboard, please do not modify the database at will!

DANGER

Again, please do not modify the database at will!

If you need to modify the data in the database, please stop the Dashboard container before modifying it.
The database type is sqlite3, located in /opt/nezha/dashboard/data/sqlite.db, please backup before modifying the data

What are each table or column in the database?

The documentation does not provide an explanation of the database. If you have the ability to modify the database, you should be able to read it with a little thinking.

Does Dashboard update automatically?

The Agent normally updates automatically, but the Dashboard does not and needs to be updated manually.

How do I update the Dashboard?

Run the script . /nezha.sh and select restart Dashboard and update

- diff --git a/en_US/guide/dashboardq.html b/en_US/guide/dashboardq.html index 0d31b610..f0bb5815 100644 --- a/en_US/guide/dashboardq.html +++ b/en_US/guide/dashboardq.html @@ -10,7 +10,7 @@ - + @@ -24,8 +24,8 @@ expires 12h; error_log /dev/null; access_log /dev/null; - }
  1. Save the configuration and clear the cache in the browser, NginX, and CDN, then refresh the page and it should return to normal.
- diff --git a/en_US/guide/loginq.html b/en_US/guide/loginq.html index cb409a01..0bad093d 100644 --- a/en_US/guide/loginq.html +++ b/en_US/guide/loginq.html @@ -10,13 +10,13 @@ - + -
Skip to content
On this page

Page refuses to connect or timeout after login callback

  1. Your server cannot connect to Github, consider trying several times or switching to Gitlab.
  2. You have configured the wrong callback URL, make sure your callback URL is correct and port and protocol are correct!
  3. An unknown error occurred in Dashboard, you can use the script to check the logs.

TIP

What is a protocol?
In the browser, your domain name ending with :// is the protocol, usually http and https. Since the Dashboard may be accessible by multiple protocols + domain + port combinations under normal deployment, please make sure to choose the most appropriate one as the callback.

How do I check if my callback URL is wrong?

Please make sure the protocol+domain+port displayed by your browser before login and the protocol+domain+port you jump to after login are the same.
Please make sure your path is /oauth2/callback, all lowercase.

Dashboard errors after login

  1. Clear your browser cookies and log in again, or change your browser.
  2. Check the callback address to ensure that your callback address is correct and that both the port and protocol are correct! The address from which the request is initiated needs to be in the same domain as the callback address, and the port, protocol, and domain name (or IP) all need to be consistent.

lookup xxx

DNS resolution failure, in most cases, is due to iptables-related configuration changes.
It is recommended to restart docker first, sudo systemctl restart docker, and then use the script to restart the Dashboard.
If the lookup error still occurs, it is recommended to check whether there are other tools to control iptables, such as Aapanel Firewall.
This problem may also be related to the kernel, please try to change the official kernel.

The authorization method is invalid, or the login callback URL is invalid, expired, or has been revoked

Suggest changing the authentication method to Github/Gitlab.

oauth2: server response missing access_token

It may be caused by a number of factors, the most likely is a network problem, we suggest to check the network and retry.
If you can't solve it, we suggest changing the authentication method to Github/Gitlab.

This user is not the administrator or cannot login

You have logged into the wrong account or configured the wrong username, note that username is not email, you can use a script to modify it.

dial tcp xxx:443 i/o timeout

If the server has network problems, you can restart docker first, sudo systemctl restart docker, and then use the script to restart the Dashboard.
You can also change to another OAuth method if necessary.

net/http: TLS handshake timeout

Same as above.

- diff --git a/en_US/guide/notifications.html b/en_US/guide/notifications.html index cafc11e7..f44bd121 100644 --- a/en_US/guide/notifications.html +++ b/en_US/guide/notifications.html @@ -10,7 +10,7 @@ - + @@ -54,8 +54,8 @@ "markdown": { "content": "# Nezha Notification\n\n\"#NEZHA#\"\n\n> ServerName: \"#SERVER.NAME#\"\n> IP: \"#SERVER.IP#\"\n> IPv4: \"#SERVER.IPV4#\"\n> IPv6: \"#SERVER.IPV6#\"\n> CPU: \"#SERVER.CPU#\"\n> Memory: \"#SERVER.MEM#\"\n> SWAP: \"#SERVER.SWAP#\"\n> Storage: \"#SERVER.DISK#\"\n> Real-time Upload: \"#SERVER.NETINSPEED#\"\n> Real-time Download: \"#SERVER.NETOUTSPEED#\"\n> Total Upload: \"#SERVER.TRANSFERIN#\"\n> Total Download: \"#SERVER.TRANSFEROUT#\"\n> 1m Load: \"#SERVER.LOAD1#\"\n> 5m Load: \"#SERVER.LOAD5#\"\n> 15m Load: \"#SERVER.LOAD15#\"\n> TCP Connections: \"#SERVER.TCPCONNCOUNT\"\n> UDP Connections: \"#SERVER.UDPCONNCOUNT\"\n\n" } -}

Delete relevant content information as needed

Notice Picture



Description of notification rules

Basic Rules

Complete examples:

Add an offline notification

Add an notification when the CPU exceeds 50% for 10s but the memory usage is below 20% for 20s

Send specific server notifications to specific notification groups

Case:
You have four servers, 1, 2, 3, 4, and two different notification groups, A and B
1, 2 The two servers are down for 10 minutes and send a notification to Notification Group A
3, 4 These two servers are down for ten minutes and then send a notification to Notification Group B

First you need to set up two notification groups, A and B, and then add two alarm rules:

Rule I:

Rule II:

Using these rules flexibly will help you to make full use of the notification function


Special: Any-cycle transfer notification

Can be used as monthly transfer notificatin

Example:

The servers with ID 3 and 4 (defined in the ignore) are counted on the 1st of each month, and a notification is triggered when the monthly outbound transfer reaches 1TB during the cycle.

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

Description of mode of triggering notification

Set the task to be executed when notification

If you need to perform a task while sending a notification message, you can set those items

- diff --git a/en_US/guide/q2.html b/en_US/guide/q2.html index 59e60289..0d611775 100644 --- a/en_US/guide/q2.html +++ b/en_US/guide/q2.html @@ -10,13 +10,13 @@ - + -
Skip to content
On this page

Let the Agent start/on-line, and the self-test process of the problem

  1. Run //opt/nezha/agent/nezha-agent -s IP/Domin(Panel IP or Domain not connected to CDN):port(Panel RPC port) -p secret(Agent Secret) -d Check the logs to see if the timeout is due to a DNS problem or poor network
  2. nc -v domain/IP port(Panel RPC port) or telnet domain/IP port(Panel RPC port) to check if it' s a network problem, check the inbound and outbound firewall between the local machine and the panel server, if you can' t determine the problem you can check it with the port checking tool provided by https://port.ping.pe/
  3. If the above steps work and the Agent is online, please try to turn off SELinux on the panel server. How to close SELinux?
- diff --git a/en_US/guide/q3.html b/en_US/guide/q3.html index aaa43442..83e76614 100644 --- a/en_US/guide/q3.html +++ b/en_US/guide/q3.html @@ -10,7 +10,7 @@ - + @@ -51,8 +51,8 @@ versions h2c 2 } } -}

Dashboard Configuration

Agent Configuration

Enable Cloudflare CDN (optional)

According to Cloudflare gRPC requirements: gRPC services must listen on port 443 and must support TLS and HTTP/2. So if you need to enable CDN, you must use port 443 when configuring Nginx or Caddy reverse proxy gRPC and configure the certificate (Caddy will automatically apply and configure the certificate).

- diff --git a/en_US/guide/q4.html b/en_US/guide/q4.html index d49f81a9..d1f4b6fb 100644 --- a/en_US/guide/q4.html +++ b/en_US/guide/q4.html @@ -10,13 +10,13 @@ - + -
Skip to content
On this page

Real-time channel disconnection/online terminal connection failure

  • If you are using a CDN, please make sure that the CDN provider provides WebSocket service and that WebSocket is enabled
  • Confirm that you are using a reverse proxy requires special configuration of the WebSocket for the /ws and /terminal paths, you can click here to see the reverse proxy configuration
- diff --git a/en_US/guide/q5.html b/en_US/guide/q5.html index 5a8fd0eb..184b5fba 100644 --- a/en_US/guide/q5.html +++ b/en_US/guide/q5.html @@ -10,13 +10,13 @@ - + -
Skip to content
On this page

How do I migrate my data to the new server and restore my backups?

  1. First use the one-click script and select Stop Panel
  2. Compress the /opt/nezha folder to the same path as the new server
  3. Run the one-click script in the new server, select Launch Panel
- diff --git a/en_US/guide/q6.html b/en_US/guide/q6.html index f542eef1..c6dcba56 100644 --- a/en_US/guide/q6.html +++ b/en_US/guide/q6.html @@ -10,13 +10,13 @@ - + -
Skip to content
On this page

How to set up a monthly reset of transfer statistics?

In the home page, the traffic statistics will be reset when the server is restarted.
If you want to set the traffic statistics to be reset once a month, you can do it like this:

  1. Go to the Notification page of the admin panel
  2. Refer to this document to create a monthly transfer statistics notification
  3. Return to the home page and you can see the monthly transfer statistics in the Service page, where the statistics will not be reset when the server is restarted

TIP

This method can be set to any period, including and not limited to hourly/daily/weekly/monthly/yearly reset transfer statistics, very flexible!

- diff --git a/en_US/guide/q7.html b/en_US/guide/q7.html index 18f473cb..04d3f04f 100644 --- a/en_US/guide/q7.html +++ b/en_US/guide/q7.html @@ -10,13 +10,13 @@ - + -
Skip to content
On this page

Customize Agent

Customize the NIC and hard drive partitions to be monitored

  • Run /opt/nezha/agent/nezha-agent --edit-agent-config to select a custom NIC and partition, and then restart Agent

Other Flags

Run ./nezha-agent --help to view supported flags,if you are already using the one-click script, you can edit /etc/systemd/system/nezha-agent.service,at the end of this line ExecStart= add:

  • --report-delay System information reporting interval, default is 1 second, can be set to 3 to reduce the system resource usage on the agent side (configuration range 1-4)
  • --skip-conn Not monitoring the number of connections, if it is a server with a large number of connections, the CPU usage will be high. It is recommended to set this to reduce CPU usage
  • --skip-procs Disable monitoring the number of processes can also reduce CPU and memory usage
  • --disable-auto-update Disable Automatic Update Agent (security feature)
  • --disable-force-update Disable Forced Update Agent (security feature)
  • --disable-command-execute Disable execution of scheduled tasks, disallow WebShell (security feature)
  • --tls Enable SSL/TLS encryption (If you are using nginx to reverse proxy Agent´s grpc connections, and if nginx has SSL/TLS enabled, you need to enable this configuration)
- diff --git a/en_US/guide/servers.html b/en_US/guide/servers.html index 7ae03f1c..18bc3a1c 100644 --- a/en_US/guide/servers.html +++ b/en_US/guide/servers.html @@ -10,13 +10,13 @@ - + -
Skip to content
On this page

Servers

Introduction

The Servers area is responsible for managing the Agent, the most basic area in Nezha Monitoring, and the basis for other functions.

Add a server

The first step is to add a servers, which can be customized with names, groups, display index and notes.
Servers in the same group will be displayed in groups in supported themes, and notes will only be displayed in the admin panel, no need to worry about leaking information.

Install Agent

Please refer to the previous article: Install Agent
We recommend using one-click installation, that is, after configuring the communication domain name, click the button on the column one-click installation and copy it to the monitored servers for installation.

Forced Updates

The flags related to the update of the Agent are: --disable-auto-update and --disable-force-update. Please refer to Customize Agent
By default, the Agent is updated automatically, but when the user turns off automatic updates, the specified servers can also be selected for forced updates.
This feature does not take effect when -disable-force-update is turned on.

Data List

  • Version number: Record the current version of Agent
  • Secret: Used when configuring the Agent
  • One-Click Installation: A more convenient way to install Agent
  • Manage: WebShell on the left, Edit in the middle, Delete on the right

Webshell

This feature does not take effect when disable-command-execute is turned on.
Both Linux and Windows are available and can be pasted using Ctrl+Shift+V.
For connection failure, please refer to Real-time channel disconnection/online terminal connection failure.
Note that in theWebShell function, the Agent also connects to the Domain names for public access via WebSocket, not via grpc.

- diff --git a/en_US/guide/services.html b/en_US/guide/services.html index 2abb40cb..9ac45d7e 100644 --- a/en_US/guide/services.html +++ b/en_US/guide/services.html @@ -10,13 +10,13 @@ - + -
Skip to content
On this page

Service area is a function setting area for setting up Agents to monitor external websites or servers
The monitoring results can be viewed on the "Services" page in the home page

How to use

To add a new monitor, you can go to the "Services" page in the administration panel and click "Add Service Monitor".

To add a service monitor, you need to complete the following settings:

  • Name - Customize a name

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

  • Target - Depending on the type you choose, the target is set in different ways

  • HTTP-GET: Selecting this type, you should enter a URL as the target, the URL should be added with http:// or https:// If your target URL is https://, it will also monitor the SSL certificate of that URL and trigger a notification when the SSL certificate expires or changes.
    For example: https://example.com
  • ICMP-Ping: When selecting this type, you should enter a domain name or IP without a port number
    For example: 1.1.1.1 or example.com
  • TCP-Ping: When selecting this type, you should enter a domain name or IP and include the port number
    For example: 1.1.1.1:80 or example.com:22
  • Interval: Sets the time interval in seconds between each time Agent sends requests to the target

  • Coverage: Select a rule to determine which Agents to use to send requests to the target

  • Specific Servers: Use with coverage to select the Agent to be excluded from the rule

  • Notification Group: Select the notification method you have set up on the "Notification" page. Click here for more information

  • Enable Failure Notification: Select whether to receive target failure notifications as needed, default is inactive

After setting, click "Add" and you are done.
Wait for a moment to go to the "Services" page on the home page to view the monitoring results

Notification of delay changes

Nezha Monitoring monitors and statistics the delay between the Agent and the target server, and sends notifications in case of significant changes
Use this feature to help you monitor your server's routes for changes

  • Enable delay notifications:When enabled, notifications will be sent when the Agent to target server delay is higher than the Max delay or lower than the Min delay

Management Monitor

To manage existing service monitoring, you can go to the "Services" page in the administration panel
Select a monitoring configuration and click the icon on the right to edit or delete it

- diff --git a/en_US/guide/settings.html b/en_US/guide/settings.html index 7e87b254..dbb52081 100644 --- a/en_US/guide/settings.html +++ b/en_US/guide/settings.html @@ -10,7 +10,7 @@ - + @@ -58,8 +58,8 @@ .hotaru-cover { background: url(https://s3.ax1x.com/2020/12/08/DzHv6A.jpg) center; } -</style>

Access Password

If you don't want to show your homepage directly, you can set a access password here
After setting the password, you need to enter the password to access the homepage

CDN Bypassed Domain/IP

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

IP Change Alert

If you want to be notified when a server's ip changes, you can set it up here

Coverage

Select a rule here to determine which servers need to be monitored, and you can choose according to your needs

Specific Servers

In conjunction with the coverage settings, set the exclusions for the selected rule here

Send Notification To Specific Notification Group

Select the notification method, please set the notification method in the "Notifications" page

WARNING

When the settings are completed, the notification takes effect when enabled is activated


WARNING

IP Change Alert does not show ip by default, if you don't want to hide it, you can activate "Do NOT desensitize Server IP In Notification Messages"

- diff --git a/en_US/guide/tasks.html b/en_US/guide/tasks.html index 5b7668ec..7bc73714 100644 --- a/en_US/guide/tasks.html +++ b/en_US/guide/tasks.html @@ -10,13 +10,13 @@ - + -
Skip to content
On this page

In the task area, you can set up scheduled tasks, Trigger tasks, and multi-server batch execution tasks

Nezha monitoring supports pushing commands to the Agent for execution, so this feature is very flexible and can be used to periodically back up the server in conjunction with restic, rclone. Periodically restart a service to reset the network connection. It can also be used with notifications to perform a task when a notification is triggered, such as running a script when the CPU is at high occupancy for a long period of time.

How to use

Go to the "Tasks" page of the admin panel and click "Add Scheduled Task"
To add a scheduled task you need to make the following settings:

  • Name - Customize a task name

  • Task Type - select the type of task
    Scheduled Tasks - Tasks are executed periodically at the scheduled time set below
    Trigger Tasks - Tasks that are triggered only by API or notification rules and are executed once per trigger

  • Cron Expression - (Not valid when using the trigger task type) Set schedule time, the Cron Expression is like:: * * * * * * sec min hour day month week, see details in CRON Expression Format
    For example: 0 0 3 * * * is Every day at 3 o'clock

  • Command - Just like writing shell/bat scripts, but line wrap is not recommended, Multiple Commands should be connected with &&/&
    For example, to execute a periodic reboot command, you can type reboot here

  • Coverage and Specific Servers - Similar to the settings on the Services page, select rules to determine which Agents need to execute scheduled tasks
    When using the trigger task type, you can select Only servers that are included in the notification rule

  • Notification Group - Select the notification method you have set up on the "Notification" page. Click here for more information

  • Send Success Notification - When this item is activated, a message notification will be triggered when the task is successfully executed

Manage tasks

To manage existing scheduled tasks, you can go to the "Tasks" page in the administration panel
Select a task configuration and the three icons on the right, which are:

  • Execute Now - When clicked, the scheduled time will be ignored and the task will be executed immediately
  • Edit - Click to modify the task configuration
  • Delete - Delete this scheduled task

FAQ

  1. Command not found
    Command not found may cause by missing PATH environment variable, for Linux Server, you may try adding source ~/.bashrc at beginning of your command or execute by absolute path.
- diff --git a/en_US/index.html b/en_US/index.html index 1d01d8fe..1fccfdf8 100644 --- a/en_US/index.html +++ b/en_US/index.html @@ -10,13 +10,13 @@ - + -
Skip to content

Nezha Monitoring

A open source, lightweight server and website monitoring and O&M tool

One-Click Installation

Support one-click script installation Dashboard and Agent services for easy use; mainstream systems such as Linux, Windows, MacOS, OpenWRT, etc. are all supported.

Real-time monitoring

Supports monitoring the system status of multiple servers simultaneously, including monitoring the status of web pages, ports, and SSL certificates. It also supports sending notifications when there are failures or when data reaches the limit. Multiple notification methods are supported, such as Telegram, email, and WeChat.

Easy O&M

Support WebSSH, support data monitoring, support setting scheduled tasks, and support batch execution of tasks on servers.

- diff --git a/guide/agent.html b/guide/agent.html index e865242b..6d00de97 100644 --- a/guide/agent.html +++ b/guide/agent.html @@ -10,12 +10,12 @@ - + -
Skip to content
On this page

哪吒监控的被控端服务被称为 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)

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

在 Windows 中一键安装

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



其他方式安装 Agent

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

  • 首先在管理面板中添加一台服务器
  • 在被控服务器中,运行脚本(位于中国大陆的服务器请使用镜像):
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://cdn.jsdelivr.net/gh/naiba/nezha@master/script/install.sh -o nezha.sh && chmod +x nezha.sh && sudo CN=true ./nezha.sh
  • 选择“安装监控 Agent”
  • 输入通信域名,如:”data.example.com“
  • 输入面板通信端口(RPC端口),默认为 5555
  • 输入 Agent 密钥,Agent 密钥在管理面板中添加服务器时生成,可以在管理面板中的“主机”页中找到
  • 等待安装完成后返回 Dashboard 主页查看服务器是否上线

在 其他 Linux 如 Alpine 使用 Openrc 的发行版 安装 Agent

本节内容由 unknown0054 贡献

  • 修改 SERVER、SECRET、TLS 然后在 shell 中执行
shell
cat >/etc/init.d/nezha-agent<< EOF
+    
Skip to content
On this page

哪吒监控的被控端服务被称为 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)

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

在 Windows 中一键安装

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



其他方式安装 Agent

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

  • 首先在管理面板中添加一台服务器
  • 在被控服务器中,运行脚本(位于中国大陆的服务器请使用镜像):
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://jihulab.com/nezha/dashboard/-/raw/master/script/install.sh -o nezha.sh && chmod +x nezha.sh && sudo CN=true ./nezha.sh
  • 选择“安装监控 Agent”
  • 输入通信域名,如:”data.example.com“
  • 输入面板通信端口(RPC端口),默认为 5555
  • 输入 Agent 密钥,Agent 密钥在管理面板中添加服务器时生成,可以在管理面板中的“主机”页中找到
  • 等待安装完成后返回 Dashboard 主页查看服务器是否上线

在 其他 Linux 如 Alpine 使用 Openrc 的发行版 安装 Agent

本节内容由 unknown0054 贡献

  • 修改 SERVER、SECRET、TLS 然后在 shell 中执行
shell
cat >/etc/init.d/nezha-agent<< EOF
 #!/sbin/openrc-run
 SERVER="" #Dashboard 地址 ip:port
 SECRET="" #SECRET
@@ -152,8 +152,8 @@
  stop
  sleep 2
  start
-}
  • 运行 chmod +x /etc/init.d/nezha-service 赋予执行权限
  • 启动服务: /etc/init.d/nezha-service enable && /etc/init.d/nezha-service start



FAQ

Agent 有 Docker 镜像吗?

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

- diff --git a/guide/agentq.html b/guide/agentq.html index a20dfa4d..dd628464 100644 --- a/guide/agentq.html +++ b/guide/agentq.html @@ -10,13 +10,13 @@ - + -
Skip to content
On this page

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

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

一键脚本安装时出错

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

多出现在国内主机中,目前一键脚本只从 Github 直接获取安装脚本,您可以多尝试几次,或者手动安装 Agent,别忘了使用镜像。

sudo: command not found

请先手动安装 sudo。

- diff --git a/guide/api.html b/guide/api.html index 528e237c..6a9f33f6 100644 --- a/guide/api.html +++ b/guide/api.html @@ -10,7 +10,7 @@ - + @@ -124,8 +124,8 @@ } } ] -}
- diff --git a/guide/dashboard.html b/guide/dashboard.html index 951c058c..b0e88a5c 100644 --- a/guide/dashboard.html +++ b/guide/dashboard.html @@ -10,12 +10,12 @@ - + -
Skip to content
On this page

准备工作

搭建一个哪吒监控,你需要:

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

TIP

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

  1. 一个 Github 账号(或:Gitlab、Jihulab、Gitee)

TIP

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

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

WARNING

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



获取 Github/Jihulab 的 Client ID 和密钥

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

  • 首先我们需要新建一个验证应用,以 Github 为例,登录 Github 后,打开 https://github.com/settings/developers ,依次选择“OAuth Apps” - “New OAuth App”
    Application name - 随意填写
    Homepage URL - 填写面板的访问域名,如:"http://cdn.example.com"
    Authorization callback URL - 填写回调地址,如:"http://cdn.example.com/oauth2/callback"
  • 点击 “Register application”
  • 保存页面中的 Client ID,然后点击 “Generate a new client secret“,创建一个新的 Client Secret,新建的密钥仅会显示一次,请妥善保存

  • JihuLab 的应用创建入口为:https://jihulab.com/-/profile/applications
  • Redirect URL 中应填入回调地址
  • 在下方范围中勾选 read_userread_api
  • 创建完成后,保存好应用程序 ID 和密码

在服务器中安装 Dashboard

  • 在面板服务器中,运行安装脚本:
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://cdn.jsdelivr.net/gh/naiba/nezha@master/script/install.sh -o nezha.sh && chmod +x nezha.sh && sudo CN=true ./nezha.sh
  • 等待Docker安装完毕后,分别输入以下值:
    OAuth提供商 - Github,Gitlab,Jihulab,Gitee 中选择一个
    Client ID - 之前保存的 Client ID
    Client Secret - 之前保存的密钥
    用户名 - OAuth 提供商中的用户名
    站点标题 - 自定义站点标题
    访问端口 - 公开访问端口,可自定义,默认 8008
    Agent的通信端口 - Agent与Dashboard的通信端口,默认 5555

  • 输入完成后,等待拉取镜像
    安装结束后,如果一切正常,此时你可以访问域名+端口号,如 “http://cdn.example.com:8008” 来查看面板

  • 将来如果需要再次运行脚本,可以运行:

bash
./nezha.sh

来打开管理脚本


配置反向代理

  • 在宝塔面板中新建一个站点,域名填写公开访问域名,如 “http://cdn.example.com“ ,然后点击“设置”进入站点设置选项,选择“反向代理” - “新建反向代理”

  • 自定义一个代理名称,在下方“目标 URL”中填入 http://127.0.0.1 然后点击“保存”

  • 打开刚刚新建的反向代理右边的“配置文件”,将配置文件替换为以下内容:

nginx
#PROXY-START/
+    
Skip to content
On this page

准备工作

搭建一个哪吒监控,你需要:

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

TIP

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

  1. 一个 Github 账号(或:Gitlab、Jihulab、Gitee)

TIP

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

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

WARNING

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



获取 Github/Jihulab 的 Client ID 和密钥

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

  • 首先我们需要新建一个验证应用,以 Github 为例,登录 Github 后,打开 https://github.com/settings/developers ,依次选择“OAuth Apps” - “New OAuth App”
    Application name - 随意填写
    Homepage URL - 填写面板的访问域名,如:"http://cdn.example.com"
    Authorization callback URL - 填写回调地址,如:"http://cdn.example.com/oauth2/callback"
  • 点击 “Register application”
  • 保存页面中的 Client ID,然后点击 “Generate a new client secret“,创建一个新的 Client Secret,新建的密钥仅会显示一次,请妥善保存

  • JihuLab 的应用创建入口为:https://jihulab.com/-/profile/applications
  • Redirect URL 中应填入回调地址
  • 在下方范围中勾选 read_userread_api
  • 创建完成后,保存好应用程序 ID 和密码

在服务器中安装 Dashboard

  • 在面板服务器中,运行安装脚本:
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://jihulab.com/nezha/dashboard/-/raw/master/script/install.sh -o nezha.sh && chmod +x nezha.sh && sudo CN=true ./nezha.sh
  • 等待Docker安装完毕后,分别输入以下值:
    OAuth提供商 - Github,Gitlab,Jihulab,Gitee 中选择一个
    Client ID - 之前保存的 Client ID
    Client Secret - 之前保存的密钥
    用户名 - OAuth 提供商中的用户名
    站点标题 - 自定义站点标题
    访问端口 - 公开访问端口,可自定义,默认 8008
    Agent的通信端口 - Agent与Dashboard的通信端口,默认 5555

  • 输入完成后,等待拉取镜像
    安装结束后,如果一切正常,此时你可以访问域名+端口号,如 “http://cdn.example.com:8008” 来查看面板

  • 将来如果需要再次运行脚本,可以运行:

bash
./nezha.sh

来打开管理脚本


配置反向代理

  • 在宝塔面板中新建一个站点,域名填写公开访问域名,如 “http://cdn.example.com“ ,然后点击“设置”进入站点设置选项,选择“反向代理” - “新建反向代理”

  • 自定义一个代理名称,在下方“目标 URL”中填入 http://127.0.0.1 然后点击“保存”

  • 打开刚刚新建的反向代理右边的“配置文件”,将配置文件替换为以下内容:

nginx
#PROXY-START/
 location / {
     proxy_pass http://127.0.0.1:8008;
     proxy_set_header Host $http_host;
@@ -35,8 +35,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://cdn.example.com" 和 "https://cdn.example.com/oauth2/callback" ,不更改此项可能会导致你无法登录面板后台

FAQ

启用HTTPS后/terminal或/ws不能正常连接怎么办?

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

我对面板提供的数据修改/增加功能不满意,我想要自己修改/增加数据怎么办?

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

DANGER

再重复一遍,请勿随意修改数据库!

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

数据库中各表/列是什么意思?

文档不提供数据库解释,有能力修改数据库的稍加分析应该就足以看懂。

Dashboard 会自动更新吗?

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

如何更新 Dashboard?

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

- diff --git a/guide/dashboardq.html b/guide/dashboardq.html index 12a21db5..d06d5a73 100644 --- a/guide/dashboardq.html +++ b/guide/dashboardq.html @@ -10,7 +10,7 @@ - + @@ -24,8 +24,8 @@ expires 12h; error_log /dev/null; access_log /dev/null; - }
  1. 保存配置,并清空浏览器、NginX、CDN 中的缓存,此时刷新页面应恢复正常
- diff --git a/guide/loginq.html b/guide/loginq.html index 5eea2910..713f476c 100644 --- a/guide/loginq.html +++ b/guide/loginq.html @@ -10,13 +10,13 @@ - + -
Skip to content
On this page

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

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

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

TIP

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

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

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

登录后面板报错

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

lookup xxx

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

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

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

oauth2: server response missing access_token

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

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

您登陆错了账号或者配置错了用户名,注意用户名不是邮箱,可使用脚本修改。

dial tcp xxx:443 i/o timeout

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

net/http: TLS handshake timeout

同上。

- diff --git a/guide/notifications.html b/guide/notifications.html index 0599526e..09cce08b 100644 --- a/guide/notifications.html +++ b/guide/notifications.html @@ -10,7 +10,7 @@ - + @@ -45,8 +45,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" } -}

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

通知效果



报警规则说明

基本规则

完整示例:

添加一个离线报警

添加一个监控 CPU 持续 10s 超过 50% 内存持续 20s 占用低于 20% 的报警

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

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

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

规则一:

规则二:

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


特殊:任意周期流量报警

可以用作月流量报警

示例:

ID 为 3 和 4 的服务器(ignore 里面定义),以每月 1 号为统计周期,周期内统计的出站月流量达到 1TB 时报警

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

通知触发模式说明

设置报警时执行任务

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

- diff --git a/guide/q1.html b/guide/q1.html index 94abb01d..7f3e5a80 100644 --- a/guide/q1.html +++ b/guide/q1.html @@ -10,7 +10,7 @@ - + @@ -59,8 +59,8 @@ ufw allow proto tcp from serverIp to any port 443 #centos iptables -I INPUT -p tcp --dport 443 -j DROP -iptables -I INPUT -s serverIp -p tcp --dport 443 -j ACCEPT - diff --git a/guide/q2.html b/guide/q2.html index 17b3f797..2d5599de 100644 --- a/guide/q2.html +++ b/guide/q2.html @@ -10,13 +10,13 @@ - + -
Skip to content
On this page

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?
- diff --git a/guide/q3.html b/guide/q3.html index 4a77d085..dacb47f4 100644 --- a/guide/q3.html +++ b/guide/q3.html @@ -10,7 +10,7 @@ - + @@ -51,8 +51,8 @@ versions h2c 2 } } -}

Dashboard 面板端配置

Agent 端配置

开启 Cloudflare CDN(可选)

根据 Cloudflare gRPC 的要求:gRPC 服务必须侦听 443 端口 且必须支持 TLS 和 HTTP/2。 所以如果需要开启 CDN,必须在配置 Nginx 或者 Caddy 反向代理 gRPC 时使用 443 端口,并配置证书(Caddy 会自动申请并配置证书)。

- diff --git a/guide/q4.html b/guide/q4.html index fec229ca..415b2812 100644 --- a/guide/q4.html +++ b/guide/q4.html @@ -10,13 +10,13 @@ - + -
Skip to content
On this page

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

  • 如果你使用了 CDN,请确认 CDN 服务商提供 WebSocket 服务,并且已开启 WebSocket
  • 确认你的反代规则中针对 /ws,/terminal 路径的 WebSocket 进行了特别配置,你可以 点击这里 查看反向代理配置
- diff --git a/guide/q5.html b/guide/q5.html index 4cfa6640..ed9576c6 100644 --- a/guide/q5.html +++ b/guide/q5.html @@ -10,13 +10,13 @@ - + -
Skip to content
On this page

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

  1. 先运行一键脚本,选择 停止面板
  2. 在旧服务器中打包 /opt/nezha 文件夹,复制到新环境相同位置解压
  3. 在新环境中运行一键脚本,选择 启动面板
- diff --git a/guide/q6.html b/guide/q6.html index ea469e45..846041a6 100644 --- a/guide/q6.html +++ b/guide/q6.html @@ -10,13 +10,13 @@ - + -
Skip to content
On this page

如何每月重置流量统计?

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

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

TIP

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

- diff --git a/guide/q7.html b/guide/q7.html index fac9eb17..6af79fc8 100644 --- a/guide/q7.html +++ b/guide/q7.html @@ -10,13 +10,13 @@ - + -
Skip to content
On this page

自定义 Agent 监控项目

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

  • 执行 /opt/nezha/agent/nezha-agent --edit-agent-config 来选择自定义的网卡和分区,然后重启 Agent 即可生效

其他运行参数

通过执行 ./nezha-agent --help 查看支持的参数,如果你使用了一键脚本安装Agent,可以编辑 /etc/systemd/system/nezha-agent.service,在 ExecStart= 这一行的末尾加上以下参数

  • --report-delay 控制系统信息上报的间隔,默认为 1 秒,可以设置为 3 来进一步降低 agent 端系统资源占用(配置区间 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 时,需要启用该项配置)
- diff --git a/guide/servers.html b/guide/servers.html index 338f2596..73266c23 100644 --- a/guide/servers.html +++ b/guide/servers.html @@ -10,13 +10,13 @@ - + -
Skip to content
On this page

主机

介绍

主机区域负责管理Agent,是哪吒探针中最基础的区域,也是其他功能的基础。

添加服务器

第一步是添加主机,可以自定义名称、分组、排序和备注。
拥有相同分组的主机会在受支持的主题中划分到一起进行显示,备注仅会在后台显示,无需担心泄露信息。

安装Agent

请参考前文安装Agent
推荐使用一键安装,即配置好参数后,点击主机一键安装列上的按钮,复制到相应主机进行安装。

强制更新

Agent更新相关的参数是 自定义agent监控项目 中的 --disable-auto-update--disable-force-update
默认情况下,Agent会自动更新,无需干预。但当用户关闭自动更新后,也可以选中指定主机进行强制更新。
disable-force-update开启时此功能不生效。

数据列

  • 版本号: 记录Agent当前版本
  • 密钥: 即secret\key,配置Agent时会用到
  • 一键安装: 较为便捷的Agent安装方式
  • 管理: 左为WebShell,中为编辑,右为删除

在线终端

即WebShell,disable-command-execute 开启时此功能不生效。
Linux和Windows均可用,可使用Ctrl+Shift+V粘贴。
连接失败请参考实时通道断开/在线终端连接失败
注意在线终端功能中,Agent也是通过WebSocket连接到公开访问域名,而非通过grpc交互。

- diff --git a/guide/services.html b/guide/services.html index 8cb2ab53..937e3e58 100644 --- a/guide/services.html +++ b/guide/services.html @@ -10,13 +10,13 @@ - + -
Skip to content
On this page

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

使用方法

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

新增一个服务监控,你需要设置以下参数:

  • 名称 - 自定义一个名称

  • 类型 - 选择一个监控类型,目前哪吒监控支持三种监控类型,分别是 “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 至目标服务器的延迟大于最高延迟或小于最低延迟时,将会发送报警通知

管理监控

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

- diff --git a/guide/settings.html b/guide/settings.html index 01e6c6a4..de32a421 100644 --- a/guide/settings.html +++ b/guide/settings.html @@ -10,7 +10,7 @@ - + @@ -58,8 +58,8 @@ .hotaru-cover { background: url(https://s3.ax1x.com/2020/12/08/DzHv6A.jpg) center; } -</style>

前台查看密码

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

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

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

IP 变更提醒

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

覆盖范围

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

特定服务器

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

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

选择通知方式,通知方式请提前在 “报警” 页内设置

WARNING

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


WARNING

IP变更通知默认打码,如果你不希望打码,可以勾选 “通知信息IP不打码”

- diff --git a/guide/tasks.html b/guide/tasks.html index 99c14084..1fa8b5d6 100644 --- a/guide/tasks.html +++ b/guide/tasks.html @@ -10,13 +10,13 @@ - + -
Skip to content
On this page

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

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

使用方法

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

  • 名称 - 自定义一个任务名称

  • 任务类型 - 选择任务的类型
    计划任务 - 按下方设置的计划时间,周期性执行任务
    触发任务 - 仅被 API 或报警规则触发的任务,每次触发执行一次

  • 计划 - (使用触发任务类型时不生效)设置计划时间,时间的格式为: * * * * * * 分别对应 秒 分 时 天 月 星期,详情见计划表达式格式
    如:0 0 3 * * * 对应为 每天3点

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

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

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

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

管理任务

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

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

常见问题

  1. xxx 命令找不到
    如果运行失败,提示 xxx 命令找不到,可能是 PATH 环境变量的问题,Linux 服务器在命令开头加入 source ~/.bashrc 或者使用绝对路径执行
- diff --git a/hashmap.json b/hashmap.json index 9923c4a7..d9fa946c 100644 --- a/hashmap.json +++ b/hashmap.json @@ -1 +1 @@ -{"en_us_case_case3.md":"63f1f83e","en_us_case_case4.md":"0599b4cb","en_us_case_case5.md":"75c022d0","en_us_case_index.md":"e1cdf48e","en_us_developer_index.md":"7cc3c922","en_us_guide_agentq.md":"16d0b37a","en_us_case_case1.md":"bd238d57","case_case4.md":"b879d03c","case_case1.md":"9636467d","en_us_developer_l10n.md":"741f9b21","developer_index.md":"6deb69e0","developer_l10n.md":"a1c43339","en_us_case_case2.md":"9f71e24b","en_us_guide_api.md":"a594b6e2","case_index.md":"349818a1","en_us_developer_theme.md":"72c4fa5f","en_us_guide_agent.md":"131ad39b","case_case3.md":"ec96e142","case_case2.md":"ddac47f2","developer_theme.md":"7e9c4737","en_us_guide_dashboardq.md":"f5a177c3","case_case5.md":"7373a3b6","en_us_guide_dashboard.md":"b1edb021","en_us_guide_loginq.md":"8c9ac10b","en_us_guide_q2.md":"62f0a52b","en_us_guide_notifications.md":"1e3309fc","guide_q3.md":"c6ded44e","guide_q5.md":"b1f86ecd","guide_q2.md":"eb3ae7c1","guide_q1.md":"c8530d1c","guide_q7.md":"07e67e61","guide_q6.md":"573d3b14","guide_settings.md":"207114a9","guide_services.md":"72cc52c5","guide_servers.md":"d1def130","index.md":"df6b95bf","guide_q4.md":"fede05c7","en_us_guide_services.md":"a60b7cbd","en_us_guide_settings.md":"0f8102b9","en_us_guide_tasks.md":"67055555","en_us_index.md":"0b5605cb","guide_agentq.md":"1adcb3de","guide_api.md":"e60064a2","guide_dashboardq.md":"cc10e28e","en_us_guide_q3.md":"0cfdd667","guide_loginq.md":"bd9f6604","guide_notifications.md":"81d5e210","guide_dashboard.md":"53a64459","en_us_guide_q6.md":"81b709fc","guide_agent.md":"1039f270","en_us_guide_q4.md":"eb1310a0","guide_tasks.md":"c57aabf6","en_us_guide_q5.md":"a7f4e653","en_us_guide_q7.md":"5e98f929","en_us_guide_servers.md":"abbee449"} +{"developer_theme.md":"2c3f159f","en_us_case_case1.md":"a91f540d","en_us_case_case2.md":"f6dd26ff","en_us_case_case3.md":"2d18f0db","en_us_case_case4.md":"ccb15ad3","en_us_case_index.md":"a39cc88b","en_us_developer_index.md":"bf3e515a","en_us_developer_l10n.md":"b9c02869","en_us_developer_theme.md":"dee4e013","en_us_guide_agentq.md":"30f39c02","en_us_guide_api.md":"b16103f8","en_us_guide_dashboard.md":"3cc0021a","en_us_guide_dashboardq.md":"6d0e242b","en_us_guide_loginq.md":"7cbc69ad","en_us_guide_notifications.md":"545de155","en_us_guide_q4.md":"67db2cbd","en_us_guide_q5.md":"7f6e04d4","en_us_guide_q6.md":"dba5267a","en_us_guide_q7.md":"e61c0a23","en_us_guide_services.md":"6fec2f3d","en_us_guide_tasks.md":"1ea501e8","en_us_index.md":"f9a5bc13","guide_agent.md":"f52833ad","guide_agentq.md":"9be55476","guide_api.md":"7a222ed7","guide_dashboard.md":"2972db90","guide_dashboardq.md":"74dfbf6e","guide_loginq.md":"2906d3ff","guide_notifications.md":"0d1686ff","guide_q1.md":"81ae0758","guide_q2.md":"b588db9c","guide_q3.md":"cefef2ad","guide_q4.md":"ed911d3e","guide_q5.md":"5f7c7008","guide_q6.md":"1ec21718","guide_q7.md":"647987c6","guide_servers.md":"818b7785","guide_settings.md":"8f33e9d2","guide_tasks.md":"cba9d13a","index.md":"3e7f3101","en_us_case_case5.md":"1dd4e304","en_us_guide_q2.md":"e1dab069","en_us_guide_q3.md":"41a969d2","case_case1.md":"86f6ebaa","case_case3.md":"22f9493d","case_case2.md":"26c353ad","case_case5.md":"f67aa872","developer_index.md":"aa052f9f","case_index.md":"5872fb68","case_case4.md":"88e5e1f3","guide_services.md":"365436a1","en_us_guide_servers.md":"c6bbe82d","en_us_guide_settings.md":"215bc7fd","en_us_guide_agent.md":"087eb20d","developer_l10n.md":"f5974325"} diff --git a/index.html b/index.html index fe3cdf84..e9598089 100644 --- a/index.html +++ b/index.html @@ -10,13 +10,13 @@ - + -
Skip to content

哪吒监控

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

一键安装

支持一键脚本安装面板和监控服务,轻松使用;Linux、Windows、MacOS、OpenWRT等主流系统均受支持

实时监控

支持同时监控多个服务器的系统状态,支持监控网页、端口、SSL证书状态;支持故障、流量等状态报警,支持多种通知方式(Telegram、邮件、微信等)

轻松运维

支持WebSSH,支持流量循环监控,支持设置定时任务、服务器批量执行任务

-