更新排障指南

This commit is contained in:
Kris 2022-12-21 17:29:15 +01:00
parent 067217d197
commit 3642761253
No known key found for this signature in database
GPG Key ID: 36AFAA97D2910652
5 changed files with 53 additions and 21 deletions

View File

@ -101,7 +101,7 @@ function getGuideSidebarZhCN() {
{
text: '常见问题',
children: [
{ text: 'TG api被墙', link: '/guide/q1' },
{ text: 'TG api 被墙', link: '/guide/q1' },
{ text: 'Agent 无法启动/上线 查看日志并进行排错的步骤', link: '/guide/q2' },
{ text: '反向代理 gRPC 端口的步骤', link: '/guide/q3' },
{ text: '实时通道断开/在线终端连接失败', link: '/guide/q4' },
@ -113,8 +113,8 @@ function getGuideSidebarZhCN() {
{
text: '排障指南',
children: [
{ text: 'Dashboard相关', link: '/guide/dashboardq' },
{ text: 'Agent相关', link: '/guide/agentq' },
{ text: 'Dashboard 相关', link: '/guide/dashboardq' },
{ text: 'Agent 相关', link: '/guide/agentq' },
{ text: '登录相关', link: '/guide/loginq' }
]
}

View File

@ -28,4 +28,20 @@ If you still get iptables... etc. errors, then consider simply closing iptables
This issue may also be kernel related, try replacing the official kernel as well.
## Dashboard reboot failed: Invalid hostPort: nz_site_port etc.
Usually this does not occur, if it does, you can modify the configuration through the installation script.
Usually this does not occur, if it does, you can modify the configuration through the installation script.
## Wrong Dashboard layout, CSS resources cannot be loaded
If the Dashboard page has an incorrect layout, the usual reason is that the CSS file is missing or cannot be loaded.
When such an issue occurs, you can first try `Reboot and update the Dashboard`.
If the problem is not resolved after updating the Dashboard, then there may be an unsuitable configuration within your vhost configuration file. You can edit the vhost file or within the Aapanel to:
1. Find the site you configured when installing Dashboard in `Website` and click `Conf` on the right side
2. Select `Config` and delete the following from the config file:
````nginx
location ~ .*\.(js|css)?$
{
expires 12h;
error_log /dev/null;
access_log /dev/null;
}
````
3. Save the configuration and clear the cache in the browser, NginX, and CDN, then refresh the page and it should return to normal.

View File

@ -1,12 +1,12 @@
## 后台显示的IP和Agent实际IP不一致
请查看 [Dashboard相关-为什么管理面板中显示的IP和Agent实际IP不一致](/guide/dashboardq.html#为什么管理面板中显示的ip和agent实际ip不一致)
## 后台显示的 IP Agent 实际 IP 不一致?
请查看 [Dashboard 相关-为什么管理面板中显示的 IP Agent 实际 IP 不一致?](/guide/dashboardq.html#为什么管理面板中显示的ip和agent实际ip不一致)
在此不再赘述。
## 一键脚本安装时出错
### curl: Failed to connect to raw.githubusercontent.com......
多出现在国内主机中,目前一键脚本只从github直接获取安装脚本,您可以多尝试几次,或者[手动安装Agent](/guide/agent.html#其他方式安装agent),别忘了使用镜像。
多出现在国内主机中,目前一键脚本只从 Github 直接获取安装脚本,您可以多尝试几次,或者[手动安装 Agent](/guide/agent.html#其他方式安装agent),别忘了使用镜像。
### sudo: command not found
请先手动安装sudo。
请先手动安装 sudo。

View File

@ -1,11 +1,11 @@
## 为什么管理面板中显示的IP和Agent实际IP不一致
首先解释管理面板中显示的IP是怎么得到的Agent会每隔一段时间请求一遍IP-API获取到IP信息后上报到Dashboard目前使用的IP-API可在此查看[myip.go](https://github.com/naiba/nezha/blob/master/cmd/agent/monitor/myip.go)。
如您发现管理面板中显示的IP和服务商提供给您的IP不一致最大的可能是服务商给您的是**入口IP**但Agent测试的是您的**出口IP**。这个问题也可能会出现在多线服务器和IPLC专线中。
## 为什么管理面板中显示的 IP Agent 实际 IP 不一致?
首先解释管理面板中显示的IP是怎么得到的Agent 会每隔一段时间请求一遍 IP-API获取到 IP 信息后上报到 Dashboard目前使用的 IP-API 可在此查看:[myip.go](https://github.com/naiba/nezha/blob/master/cmd/agent/monitor/myip.go)。
如您发现管理面板中显示的 IP 和服务商提供给您的 IP 不一致,最大的可能是服务商给您的是**入口 IP**但Agent测试的是您的**出口 IP**。这个问题也可能会出现在多线服务器和 IPLC 专线中。
::: tip
举个简单也十分常见的例子服务商给您提供的是一台高防服务器为了同时满足高防和低网络中断率的目标提供给您的IP可能是经过映射后的高防IP而并非您服务器的真实出口IP
举个简单也十分常见的例子,服务商给您提供的是一台高防服务器,为了同时满足高防和低网络中断率的目标,提供给您的 IP 可能是经过映射后的高防 IP 而并非您服务器的真实出口 IP
:::
您也可以在Agent服务器中运行以下命令测试出口IP:
您也可以在 Agent 服务器中运行以下命令测试出口IP:
```shell
curl api.myip.la
curl ip.sb
@ -17,15 +17,31 @@ curl ip-api.com
密码位于 site-viewpassword 项中。
## 面板安装/重启/更新失败: iptables ......
首先尝试重启docker再操作
首先尝试重启 Docker 再操作
```shell
systemctl status docker
systemctl restart docker
systemctl status docker
```
重启后尝试重新安装面板。
若依然出现iptables...等错误则考虑直接关闭iptables甚至移除iptables。
若依然出现 iptables... 等错误,则考虑直接关闭 iptables 甚至移除 iptables。
这个问题也可能与内核有关,也可以尝试更换官方内核。
## 面板重启失败Invalid hostPort: nz_site_port 等
通常不会出现这个情况,如出现可以通过安装脚本修改配置。
## 面板布局错误、CSS 资源无法被加载
如果出现 Dashboard 页面布局出现错误,通常的原因是 CSS 文件丢失或无法被加载
出现此类错误,可以先尝试 `重启并更新面板`
如果更新面板后问题没有得到解决,那么可能是你的 vhost 配置文件内有不适用的配置,你可以编辑 NginX 的 vhost 文件或在宝塔面板内:
1. 在`网站`中找到安装 Dashboard 时配置的站点,点击右侧`设置`
2. 选择`配置文件`,删除配置文件中的:
````nginx
location ~ .*\.(js|css)?$
{
expires 12h;
error_log /dev/null;
access_log /dev/null;
}
````
3. 保存配置并清空浏览器、NginX、CDN 中的缓存,此时刷新页面应恢复正常

View File

@ -1,8 +1,8 @@
## 登录回调后页面卡住\拒绝连接\响应时间过长
还有其他一些表现形式,总之登录后浏览器无法正常显示。
1. 您的服务器无法连接到Github/Gitee最常见于国内服务器配置Github情况下可以考虑多尝试几次或者切换到Jihulab/Gitee。
1. 您的服务器无法连接到 Github/Gitee最常见于国内服务器配置 Github 情况下,可以考虑多尝试几次或者切换到 Jihulab/Gitee。
2. 您配置错了回调地址,确保您的回调地址正确且**端口与协议**均正确!
3. Dashboard发生未知错误您可以使用脚本查看日志但此项可能性较低。
3. Dashboard 发生未知错误,您可以使用脚本查看日志,但此项可能性较低。
::: tip
什么是协议?
@ -24,18 +24,18 @@
这个问题也可能与内核有关系,请尝试更换官方内核。
### 授权方式无效,或者登录回调地址无效、过期或已被撤销
只出现在Gitee登录方式中原因不明建议更换到Jihulab。
只出现在 Gitee 登录方式中,原因不明,建议更换到 Jihulab。
### oauth2: server response missing access_token
可能由多种因素引起,最大可能性是网络问题,建议检查网络后重试。
无法解决的话建议更换Github/Jihulab等。
无法解决的话建议更换 Github/Jihulab 等。
### 该用户不是本站点管理员,无法登录
您登陆错了账号或者配置错了用户名,注意**用户名不是邮箱**,可使用脚本修改。
### dial tcp xxx:443 i/o timeout
网络问题,可先重启docker`sudo systemctl restart docker`,再使用脚本重启面板。
如为国内服务器配置Github登陆方式则建议切换到Jihulab以避免网络干扰。
网络问题,可先重启 Docker`sudo systemctl restart docker`,再使用脚本重启面板。
如为国内服务器配置 Github 登陆方式则建议切换到Jihulab以避免网络干扰。
### net/http: TLS handshake timeout
同上。