优化更新中英文文档-排障指南
This commit is contained in:
Kris
+10
-6
@@ -3,15 +3,19 @@ outline: deep
|
||||
---
|
||||
|
||||
## 后台显示的 IP 和 Agent 实际 IP 不一致？
|
||||
请查看 [Dashboard 相关-为什么管理面板中显示的 IP 和 Agent 实际 IP 不一致？](/guide/dashboardq.html#为什么管理面板中显示的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 加速服务或者镜像，并在一键安装脚本中设置。
|
||||
|
||||
多出现在中国大陆的服务器中，目前一键脚本只从 Github 直接获取安装脚本，您可以多尝试几次，或者[手动安装 Agent](/guide/agent.html#其他方式安装agent)。另外，也可以自行寻找第三方 Github 加速服务或者镜像，并在一键安装脚本中设置。
|
||||
|
||||
### sudo: command not found
|
||||
请先手动安装 sudo。
|
||||
|
||||
请先手动安装 sudo，例如在 Ubuntu 中：
|
||||
|
||||
```shell
|
||||
apt install sudo
|
||||
```
|
||||
+42
-27
@@ -2,14 +2,17 @@
|
||||
outline: deep
|
||||
---
|
||||
|
||||
## 为什么管理面板中显示的 IP 和 Agent 实际 IP 不一致？
|
||||
## 为什么管理面板中显示的 IP 和 Agent 实际 IP 不一致？
|
||||
|
||||
首先解释管理面板中显示的IP是怎么得到的：Agent 会每隔一段时间请求一遍 IP-API，获取到 IP 信息后上报到 Dashboard，目前使用的 IP-API 可在此查看：[myip.go](https://github.com/nezhahq/agent/blob/main/pkg/monitor/myip.go)。
|
||||
如您发现管理面板中显示的 IP 和服务商提供给您的 IP 不一致，最大的可能是服务商给您的是**入口 IP**，但 Agent 测试的是您的**出口 IP**。这个问题也可能会出现在多线服务器和 IPLC 专线中。
|
||||
如您发现管理面板中显示的 IP 和服务商提供给您的 IP 不一致，最大的可能是服务商给您的是**入口 IP**，但 Agent 测试的是您的**出口 IP**。这个问题也可能会出现在多线服务器和 IPLC 专线中。
|
||||
|
||||
::: tip
|
||||
举个简单也十分常见的例子，服务商给您提供的是一台高防服务器，为了同时满足高防和低网络中断率的目标，提供给您的 IP 可能是经过映射后的高防 IP 而并非您服务器的真实出口 IP
|
||||
:::
|
||||
举个简单也十分常见的例子，服务商给您提供的是一台高防服务器，为了同时满足高防和低网络中断率的目标，提供给您的 IP 可能是经过映射后的高防 IP 而并非您服务器的真实出口 IP。
|
||||
:::
|
||||
|
||||
您也可以在 Agent 服务器中运行以下命令测试出口 IP:
|
||||
|
||||
您也可以在 Agent 服务器中运行以下命令测试出口IP:
|
||||
```shell
|
||||
curl https://ipapi.co/ip/
|
||||
curl ip.sb
|
||||
@@ -17,45 +20,57 @@ curl ip-api.com
|
||||
```
|
||||
|
||||
## 忘记查看密码\删除查看密码
|
||||
|
||||
请查看或编辑 `/opt/nezha/dashboard/data/config.yaml` 文件。
|
||||
密码位于 site-viewpassword 项中。
|
||||
密码位于 `site-viewpassword` 项中。
|
||||
|
||||
## 面板安装/重启/更新失败: iptables ......
|
||||
首先尝试重启 Docker 再操作
|
||||
|
||||
首先尝试重启 Docker 再操作：
|
||||
|
||||
```shell
|
||||
systemctl status docker
|
||||
systemctl restart docker
|
||||
systemctl status docker
|
||||
```
|
||||
|
||||
重启后尝试重新安装面板。
|
||||
若依然出现 iptables... 等错误，则考虑直接关闭 iptables 甚至移除 iptables。
|
||||
这个问题也可能与内核有关，也可以尝试更换官方内核。
|
||||
这个问题也可能与内核有关，也可以尝试更换官方内核。
|
||||
|
||||
## 面板重启失败：Invalid hostPort: nz_site_port 等
|
||||
如出现可以通过安装脚本修改配置，或者直接修改 `/opt/nezha/dashboard/docker-compose.yaml`文件。
|
||||
|
||||
如出现此问题，可以通过安装脚本修改配置，或者直接修改 `/opt/nezha/dashboard/docker-compose.yaml` 文件。
|
||||
|
||||
## 面板布局错误、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 中的缓存，此时刷新页面应恢复正常
|
||||
|
||||
## 面板无法启动：panic: 无法找到配置的DDNS提供者...
|
||||
填入的DDNS provider的值有误，目前仅支持 `webhook`、`cloudflare`，`tencentcloud` 和 `dummy`。
|
||||
如果出现 Dashboard 页面布局错误，通常是 CSS 文件丢失或无法被加载。
|
||||
出现此类错误，可以先尝试 `重启并更新面板`。
|
||||
如果更新面板后问题没有得到解决，那么可能是你的 vhost 配置文件内有不适用的配置，你可以编辑 Nginx 的 vhost 文件或在宝塔面板内：
|
||||
|
||||
## 面板更新DDNS崩溃：panic: interface conversion: interface {} is nil, not []interface {}
|
||||
填入的DDNS `AccessID` 或 `AccessSecret` 有误。
|
||||
1. 在 `网站` 中找到安装 Dashboard 时配置的站点，点击右侧 `设置`。
|
||||
2. 选择 `配置文件`，删除配置文件中的：
|
||||
|
||||
```nginx
|
||||
location ~ .*\.(js|css)?$
|
||||
{
|
||||
expires 12h;
|
||||
error_log /dev/null;
|
||||
access_log /dev/null;
|
||||
}
|
||||
```
|
||||
|
||||
3. 保存配置，并清空浏览器、Nginx、CDN 中的缓存，此时刷新页面应恢复正常。
|
||||
|
||||
## 面板无法启动：panic: 无法找到配置的 DDNS 提供者...
|
||||
|
||||
填入的 DDNS provider 的值有误，目前仅支持 `webhook`、`cloudflare`、`tencentcloud` 和 `dummy`。
|
||||
|
||||
## 面板更新 DDNS 崩溃：panic: interface conversion: interface {} is nil, not []interface {}
|
||||
|
||||
填入的 DDNS `AccessID` 或 `AccessSecret` 有误。
|
||||
|
||||
## 打开网络监控页显示：server monitor history not found
|
||||
|
||||
出现此错误说明没有在服务页中设置 TCP-Ping 和 ICMP-Ping 类型的监控或者监控数据还未生成。
|
||||
如已经设置完毕，可以等待一段时间后再查看。
|
||||
+27
-16
@@ -3,45 +3,56 @@ outline: deep
|
||||
---
|
||||
|
||||
## 登录回调后页面卡住\拒绝连接\响应时间过长
|
||||
还有其他一些表现形式，总之登录后浏览器无法正常显示。
|
||||
|
||||
还有其他一些表现形式，总之登录后浏览器无法正常显示。
|
||||
|
||||
1. 您的服务器无法连接到 Github/Gitee，最常见于国内服务器配置 Github 情况下，可以考虑多尝试几次或者切换到 Cloudflare Access。
|
||||
2. 您配置错了回调地址，确保您的回调地址正确且**端口与协议**均正确！
|
||||
3. Dashboard 发生未知错误，您可以使用脚本查看日志。
|
||||
|
||||
::: tip
|
||||
什么是协议？
|
||||
在浏览器中，您的域名以`://`结尾的字符串即为协议，通常为 `http` 和 `https` 两种。由于正常部署情况下面板可能有多种协议+域名+端口组合均可访问，请务必选一个最合适的作为回调。
|
||||
:::
|
||||
::: tip
|
||||
什么是协议？
|
||||
在浏览器中，您的域名以 `://` 结尾的字符串即为协议，通常为 `http` 和 `https` 两种。由于正常部署情况下面板可能有多种协议+域名+端口组合均可访问，请务必选一个最合适的作为回调。
|
||||
:::
|
||||
|
||||
### 如何检查我的回调地址是否错误？
|
||||
|
||||
### 如何检查我的回调地址是否错误？
|
||||
请确保登录前浏览器显示的协议+域名+端口和登录后跳转到的协议+域名+端口一致。
|
||||
请确保您的路径为`/oauth2/callback`，**全部小写**
|
||||
请确保您的路径为 `/oauth2/callback`，**全部小写**。
|
||||
|
||||
## 登录后面板报错
|
||||
|
||||
### http: named cookie not present
|
||||
1. 清理 cookies 后重新登录，或换个浏览器
|
||||
2. 检查回调地址，确保您的回调地址正确且**端口与协议**均正确！发起请求的地址需要和回调地址处于同域，端口、协议和域名(或IP)都需要一致。
|
||||
|
||||
1. 清理 cookies 后重新登录，或换个浏览器。
|
||||
2. 检查回调地址，确保您的回调地址正确且**端口与协议**均正确！发起请求的地址需要和回调地址处于同域，端口、协议和域名(或IP)都需要一致。
|
||||
|
||||
### lookup xxx
|
||||
容器DNS解析失败，多数情况下为修改了iptables相关配置。
|
||||
建议先重启docker，`sudo systemctl restart docker`，再使用脚本重启面板。
|
||||
仍然出现lookup错误建议查看是否有其他控制iptables的工具，如宝塔防火墙等。
|
||||
这个问题也可能与内核有关系，请尝试更换官方内核。
|
||||
|
||||
容器 DNS 解析失败，多数情况下为修改了 iptables 相关配置。
|
||||
建议先重启 docker，`sudo systemctl restart docker`，再使用脚本重启面板。
|
||||
仍然出现 lookup 错误建议查看是否有其他控制 iptables 的工具，如宝塔防火墙等。
|
||||
这个问题也可能与内核有关系，请尝试更换官方内核。
|
||||
|
||||
### 授权方式无效，或者登录回调地址无效、过期或已被撤销
|
||||
|
||||
只出现在 Gitee 登录方式中，原因不明，建议更换到 GitHub。
|
||||
|
||||
### oauth2: server response missing access_token
|
||||
|
||||
可能由多种因素引起，最大可能性是网络问题，建议检查网络后重试。
|
||||
无法解决的话建议更换 Github 等。
|
||||
|
||||
### 该用户不是本站点管理员，无法登录
|
||||
您登陆错了账号或者配置错了用户名，注意**用户名不是邮箱**，可使用脚本修改。
|
||||
Cloudflare Access 用户请注意，您的用户名不是邮箱，而是User ID。
|
||||
|
||||
您登陆错了账号或者配置错了用户名，注意**用户名不是邮箱**，可使用脚本修改。
|
||||
Cloudflare Access 用户请注意，您的用户名不是邮箱，而是 User ID。
|
||||
|
||||
### dial tcp xxx:443 i/o timeout
|
||||
|
||||
网络问题，可先重启 Docker，`sudo systemctl restart docker`，再使用脚本重启面板。
|
||||
如为国内服务器配置 Github 登陆方式，则建议切换到 Cloudflare Access 以避免网络干扰。
|
||||
|
||||
### net/http: TLS handshake timeout
|
||||
同上。
|
||||
|
||||
同上。
|
||||
Reference in New Issue
Block a user