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

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

2025-07-03 10:47:05作者:乔或婵

在使用 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 控制界面。

登录后查看全文
热门项目推荐
相关项目推荐