MetaCubeX/metacubexd 项目中的 Web 控制面板访问路径问题解析

在使用 MetaCubeX/metacubexd 作为 sing-box 的 Web 控制面板时，用户可能会遇到访问路径的问题。本文将详细解析这一问题及其解决方案。

问题现象

当用户通过 brew 在 macOS 上安装 sing-box 并配置了 metacubexd 作为 Web 控制面板后，直接访问 127.0.0.1:9090 会返回 {"message":"Unauthorized"} 的错误信息。然而同样的配置在 OpenWrt 系统上却可以正常工作。

原因分析

这个问题的根本原因在于 sing-box 对 Web 控制面板访问路径的处理方式。sing-box 默认将 Web 控制面板的访问路径设置为 /ui 子路径，而非根路径。这意味着：

1. 直接访问根路径 (/) 会触发 API 的未授权响应
2. 正确的访问路径应该是 /ui 子路径

解决方案

要正确访问 Web 控制面板，用户需要在基础 URL 后添加 /ui 路径，即访问：

http://127.0.0.1:9090/ui

不同系统的差异

值得注意的是，这个问题在不同系统上表现可能不同：

1. macOS/brew 安装：需要显式添加 /ui 路径
2. OpenWrt 系统：可能由于中间件或反向代理配置自动处理了路径重定向

这种差异通常是由于不同部署环境下中间件或 Web 服务器的配置不同导致的。在 OpenWrt 上，可能配置了 URL 重写规则，自动将根路径请求重定向到 /ui 路径。

最佳实践建议

1. 始终使用完整的 /ui 路径访问控制面板
2. 如需直接通过根路径访问，可以考虑配置反向代理规则
3. 检查 sing-box 的日志以确认控制面板是否正确加载
4. 确保 metacubexd 的静态文件已正确下载并部署

通过理解这些访问路径的处理机制，用户可以更有效地使用 MetaCubeX/metacubexd 作为 sing-box 的 Web 控制界面。