更新排障指南

docs/en_US/guide/dashboardq.md

@@ -29,3 +29,19 @@ 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.  
+
+## 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.

docs/guide/agentq.md

@@ -5,7 +5,7 @@
 ## 一键脚本安装时出错  
 
 ### 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。

docs/guide/dashboardq.md

@@ -17,7 +17,7 @@ curl ip-api.com
 密码位于 site-viewpassword 项中。
 
 ## 面板安装/重启/更新失败: iptables ......
-首先尝试重启docker再操作  
+首先尝试重启 Docker 再操作  
 ```shell
 systemctl status docker
 systemctl restart docker
@@ -29,3 +29,19 @@ systemctl status docker
 
 ## 面板重启失败：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

@@ -34,7 +34,7 @@
 您登陆错了账号或者配置错了用户名，注意**用户名不是邮箱**，可使用脚本修改。
 
 ### dial tcp xxx:443 i/o timeout
-网络问题，可先重启docker，`sudo systemctl restart docker`，再使用脚本重启面板。  
+网络问题，可先重启 Docker，`sudo systemctl restart docker`，再使用脚本重启面板。  
 如为国内服务器配置 Github 登陆方式，则建议切换到Jihulab以避免网络干扰。
 
 ### net/http: TLS handshake timeout