前言

某一天，和正常一样访问博客后台面板，打算写点东西，然后出现了以下画面：

我十分肯定前一天还可以正常访问，且在这之间没做过任何修改，我印象中无论是后台还是前端在配置的时候都没有提到要开启admin proxy，查看了docker-compose.yml和.env文件也确实没找到相关配置项，查看反代配置也没问题；也尝试过重启镜像，重装镜像，但都无果，转而向群里博友求助，但是也没人碰到过这个问题。

这个问题就这样搁置了几天，毕竟还要上班，腾不出太多时间折腾...

今天，忽然想到在服务器上安装claude code，让它帮我排查，没想到它还真给我解决了，用了这么久的claude code，居然一直没想到给它上服务器，被自己蠢到了。

🛠️ 故障复盘：MX Space 后台访问异常与修复

1. 故障背景

• 场景：正常访问博客后台时突然出现异常。
• 现象：
  • 访问 https://bambooo.top/proxy/qaqdmin 返回 {"message":"admin proxy not enabled"}。
  • 配置后页面一直转圈，浏览器控制台显示大量 JS 文件 502 错误。
• 排查过程：检查了 Docker 和反代配置，重启/重装镜像均无效。最终通过 Claude Code 辅助排查解决了问题。

2. 核心原因分析

3. 解决方案

方案核心：直接由 Nginx 服务静态文件 + 优化 Nginx 配置

步骤 1：提取并复制静态文件 需要将容器内的文件复制到宿主机或 Nginx 容器可访问的位置。

# 1. 从 MX Server 容器复制文件到宿主机
docker cp mx-server:/app/admin /root/mx-space/admin-static

# 2. 复制到 Nginx 容器内 (示例容器名为 1Panel-openresty-QqyX)
docker cp /root/mx-space/admin-static 1Panel-openresty-QqyX:/tmp/admin-static

步骤 2：配置 Nginx 在 Nginx 配置中添加以下 location 块，直接服务静态文件：

# 管理后台主路径
location ^~ /qaqdmin/ {
  alias /tmp/admin-static/;
  try_files $uri $uri/ /qaqdmin/index.html;
  index index.html;
}

# JS 文件路径
location ^~ /qaqdmin/js/ {
  alias /tmp/admin-static/js/;
}

# CSS/Assets 文件路径
location ^~ /qaqdmin/assets/ {
  alias /tmp/admin-static/assets/;
}

步骤 3：修改环境变量配置 更新管理后台的 API 地址，确保请求能正确代理到后端：

# 修改 API 地址
BASE_API: 'http://localhost:2333' → 'https://bambooo.top/api/v2'

# 修改网关地址
GATEWAY: '' → 'https://bambooo.top'

步骤 4：修复静态资源路径 修改前端引用路径，将相对路径改为绝对路径：

• ./js/ → /qaqdmin/js/
• ./assets/ → /qaqdmin/assets/

4. 最终结果与关键要点

✅ 修复结果：

• 后台可通过 https://bambooo.top/qaqdmin 正常访问。
• 静态资源（JS/CSS）加载正常。
• 绕过了 Admin Proxy 的本地访问限制。

📌 关键经验：

1. Docker 隔离：容器间文件系统隔离，需通过 docker cp 桥接文件。
2. Nginx 配置：alias 指令需精确处理路径映射。
3. 路径规范：静态资源建议使用绝对路径，避免相对路径混淆。
4. 配置协同：环境变量仅是第一步，网络和文件系统配置同样重要。