mirror of
https://github.com/nezhahq/nezha.git
synced 2025-01-22 20:58:14 -05:00
244 lines
8.8 KiB
Markdown
244 lines
8.8 KiB
Markdown
# 哪吒面板
|
||
|
||
   
|
||
|
||
系统状态监控报警、API(SSL证书变更、即将到期、到期)/TCP端口存活/PING 监控、计划任务(可以定时在Agent上执行命令，备份、重启、What ever you want)、极省资源，64M 服务器也能装 agent。
|
||
|
||
| 默认主题 | DayNight [@JackieSung](https://github.com/JackieSung4ev) | hotaru [@CokeMine](https://github.com/CokeMine) |
|
||
| ---- | ---- | ---- |
|
||
|  | <img src="https://s3.ax1x.com/2021/01/20/sfJv2q.jpg"/> | <img src="https://s3.ax1x.com/2020/12/09/rPF4xJ.png" width="1600px" /> |
|
||
|
||
\>> [查看针友列表](https://www.google.com/search?q=%22powered+by+%E5%93%AA%E5%90%92%E9%9D%A2%E6%9D%BF%22&filter=0) (Google)
|
||
|
||
## 一键脚本
|
||
|
||
建议使用 WatchTower 自动更新面板，Windows终端可以使用 nssm 配置自启动（见尾部教程）
|
||
|
||
- 海外：
|
||
|
||
```shell
|
||
curl -L https://raw.githubusercontent.com/naiba/nezha/master/script/install.sh -o nezha.sh && chmod +x nezha.sh
|
||
sudo ./nezha.sh
|
||
```
|
||
|
||
- 国内加速：
|
||
|
||
```shell
|
||
curl -L https://raw.sevencdn.com/naiba/nezha/master/script/install.sh -o nezha.sh && chmod +x nezha.sh
|
||
sudo ./nezha.sh
|
||
```
|
||
|
||
## 功能说明
|
||
|
||
<details>
|
||
<summary>自定义代码：去版权、改LOGO、改色调、加统计代码等。</summary>
|
||
|
||
- 默认主题更改进度条颜色示例
|
||
|
||
```
|
||
<style>
|
||
.ui.fine.progress> .bar {
|
||
background-color: pink !important;
|
||
}
|
||
</style>
|
||
```
|
||
- 默认主题修改LOGO、移除版权示例（来自 [@iLay1678](https://github.com/iLay1678)，欢迎PR）
|
||
|
||
```
|
||
<style>
|
||
.right.menu>a{
|
||
visibility: hidden;
|
||
}
|
||
.footer .is-size-7{
|
||
visibility: hidden;
|
||
}
|
||
.item img{
|
||
visibility: hidden;
|
||
}
|
||
</style>
|
||
<script>
|
||
window.onload = function(){
|
||
var avatar=document.querySelector(".item img")
|
||
var footer=document.querySelector("div.is-size-7")
|
||
footer.innerHTML="Powered by 你的名字"
|
||
footer.style.visibility="visible"
|
||
avatar.src="你的方形logo地址"
|
||
avatar.style.visibility="visible"
|
||
}
|
||
</script>
|
||
```
|
||
|
||
- hotaru 主题更改背景图片示例
|
||
|
||
```
|
||
<style>
|
||
.hotaru-cover {
|
||
background: url(https://s3.ax1x.com/2020/12/08/DzHv6A.jpg) center;
|
||
}
|
||
</style>
|
||
```
|
||
</details>
|
||
|
||
<details>
|
||
<summary>计划任务：备份脚本、服务重启，等定期运维任务。</summary>
|
||
|
||
使用此功能可以定期结合 restic、rclone 给服务器备份，或者定期某项重启服务来重置网络连接。
|
||
</details>
|
||
|
||
<details>
|
||
<summary>报警通知：CPU、内存、硬盘、带宽、流量实时监控。</summary>
|
||
|
||
#### 灵活通知方式
|
||
|
||
`#NEZHA#` 是面板消息占位符，面板触发通知时会自动替换占位符到实际消息
|
||
|
||
Body 内容是`JSON` 格式的：**当请求类型为FORM时**，值为 `key:value` 的形式，`value` 里面可放置占位符，通知时会自动替换。**当请求类型为JSON时** 只会简进行字符串替换后直接提交到`URL`。
|
||
|
||
URL 里面也可放置占位符，请求时会进行简单的字符串替换。
|
||
|
||
参考下方的示例，非常灵活。
|
||
|
||
1. 添加通知方式
|
||
|
||
- server酱示例
|
||
- 备注：server酱
|
||
- URL：https://sc.ftqq.com/SCUrandomkeys.send?text=#NEZHA#
|
||
- 请求方式: GET
|
||
- 请求类型: 默认
|
||
- Body: 空
|
||
|
||
- wxpusher示例，需要关注你的应用
|
||
- 备注: wxpusher
|
||
- URL：http://wxpusher.zjiecode.com/api/send/message
|
||
- 请求方式: POST
|
||
- 请求类型: JSON
|
||
- Body: `{"appToken":"你的appToken","topicIds":[],"content":"#NEZHA#","contentType":"1","uids":["你的uid"]}`
|
||
|
||
- telegram示例 [@haitau](https://github.com/haitau) 贡献
|
||
- 备注：telegram机器人消息通知
|
||
- URL：https://api.telegram.org/botXXXXXX/sendMessage?chat_id=YYYYYY&text=#NEZHA#
|
||
- 请求方式: GET
|
||
- 请求类型: 默认
|
||
- Body: 空
|
||
- URL参数获取说明：botXXXXXX 中的 XXXXXX 是在 telegram中关注官方 @Botfather ，输入/newbot ，创建新的机器人（bot）时，会提供的 token（在提示Use this token to access the HTTP API:后面一行）这里 'bot' 三个字母不可少。创建 bot 后，需要先在 telegram中与BOT进行对话（随便发个消息），然后才可用 API发送消息。YYYYYY 是 telegram 用户的数字 ID。与机器人@userinfobot 对话可获得。
|
||
|
||
2. 添加一个离线报警
|
||
|
||
- 备注：离线通知
|
||
- 规则：`[{"Type":"offline","Min":0,"Max":0,"Duration":10}]`
|
||
- 启用：√
|
||
|
||
3. 添加一个监控 CPU 持续 10s 超过 50% **且** 内存持续 20s 占用低于 20% 的报警
|
||
|
||
- 备注：CPU+内存
|
||
- 规则：`[{"Type":"cpu","Min":0,"Max":50,"Duration":10},{"Type":"memory","Min":20,"Max":0,"Duration":20}]`
|
||
- 启用：√
|
||
|
||
#### 报警规则说明
|
||
|
||
- Type
|
||
- cpu、memory、swap、disk：Min/Max 数值为占用百分比
|
||
- net_in_speed(入站网速)、net_out_speed(出站网速)、net_all_speed(双向网速)、transfer_in(入站流量)、transfer_out(出站流量)、transfer_all(双向流量)：Min/Max 数值为字节（1kb=1024，1mb = 1024*1024）
|
||
- offline：不支持 Min/Max 参数
|
||
- Duration：持续秒数，监控比较简陋，取持续时间内的 70 采样结果
|
||
- Ignore: `{"1": true, "2":false}` 忽略此规则的服务器ID列表
|
||
</details>
|
||
|
||
<details>
|
||
<summary>服务监控：HTTP、SSL证书、ping、TCP 端口等。</summary>
|
||
|
||
进入 `/monitor` 页面点击新建监控即可，表单下面有相关说明。
|
||
</details>
|
||
|
||
## 常见问题
|
||
|
||
<details>
|
||
<summary>如何进行数据迁移、备份恢复？</summary>
|
||
|
||
数据储存在 `/opt/nezha` 文件夹中，迁移数据时打包这个文件夹，到新环境解压。然后执行一键脚本安装即可
|
||
</details>
|
||
|
||
<details>
|
||
<summary>如何使 OpenWrt/LEDE 自启动？来自 @艾斯德斯</summary>
|
||
|
||
首先在 release 下载对应的二进制解压后放置到 `/root/nezha-agent`，然后 `chmod +x /root/nezha-agent` 赋予执行权限，然后创建 `/etc/init.d/nezha-agent`：
|
||
|
||
```
|
||
#!/bin/sh /etc/rc.common
|
||
|
||
START=99
|
||
USE_PROCD=1
|
||
|
||
start_service() {
|
||
procd_open_instance
|
||
procd_set_param command /root/nezha-agent -i xxx -p 111 -d
|
||
procd_set_param respawn
|
||
procd_close_instance
|
||
}
|
||
|
||
stop_service() {
|
||
killall nezha-agent
|
||
}
|
||
|
||
restart() {
|
||
stop
|
||
sleep 2
|
||
start
|
||
}
|
||
```
|
||
|
||
赋予执行权限 `chmod +x /etc/init.d/nezha-agnt` 然后启动服务 `/etc/init.d/nezha-agent enable && /etc/init.d/nezha-agent start`
|
||
</details>
|
||
|
||
<details>
|
||
<summary>首页服务器随机闪烁掉线？</summary>
|
||
|
||
执行 `ntpdate 0.pool.ntp.org` 同步一下面板部署所在的服务器的时间，ref: [How do I use pool.ntp.org?](https://www.ntppool.org/en/use.html)
|
||
</details>
|
||
|
||
<details>
|
||
<summary>提示实时通道断开？</summary>
|
||
|
||
### 启用 HTTPS
|
||
|
||
使用宝塔反代或者上CDN，建议 Agent配置 跟 访问管理面板 使用不同的域名，这样管理面板使用的域名可以直接套CDN，Agent配置的域名是解析管理面板IP使用的，也方便后面管理面板迁移（如果你使用IP，后面IP更换了，需要修改每个agent，就麻烦了）
|
||
|
||
### 实时通道断开(WebSocket反代)
|
||
|
||
使用反向代理时需要针对 `/ws` 路径的 WebSocket 进行特别配置以支持实时更新服务器状态。
|
||
|
||
- Nginx(宝塔)：在你的 nginx 配置文件中加入以下代码
|
||
|
||
```nginx
|
||
server{
|
||
|
||
#server_name blablabla...
|
||
|
||
location /ws {
|
||
proxy_pass http://ip:站点访问端口;
|
||
proxy_http_version 1.1;
|
||
proxy_set_header Upgrade $http_upgrade;
|
||
proxy_set_header Connection "Upgrade";
|
||
proxy_set_header Host $host;
|
||
}
|
||
|
||
#其他的 location blablabla...
|
||
}
|
||
```
|
||
|
||
- CaddyServer v1（v2无需特别配置）
|
||
|
||
```Caddyfile
|
||
proxy /ws http://ip:8008 {
|
||
websocket
|
||
}
|
||
```
|
||
</details>
|
||
|
||
## 社区文章
|
||
|
||
- [哪吒探针 - Windows 客户端安装](https://nyko.me/2020/12/13/nezha-windows-client.html)
|
||
- [哪吒面板，一个便携服务器状态监控面板搭建教程，不想拥有一个自己的探针吗？](https://haoduck.com/644.html)
|
||
- [哪吒面板：小鸡们的最佳探针](https://www.zhujizixun.com/2843.html) *（已过时）*
|
||
- [>>更多教程](https://www.google.com/search?q=%22%E5%93%AA%E5%90%92%E9%9D%A2%E6%9D%BF%22+%22%E6%95%99%E7%A8%8B%22) (Google)
|