更新排障指南

docs/guide/agentq.md

@@ -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。
 

docs/guide/dashboardq.md

@@ -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 中的缓存，此时刷新页面应恢复正常

docs/guide/loginq.md

@@ -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
 同上。