Marzban项目在NGINX特定路径下的代理配置问题解析

背景介绍

在使用Marzban面板时，很多用户会选择通过NGINX反向代理来提供Web服务。一个常见的需求是将Marzban部署在非根路径下，例如将仪表板访问路径设置为/mb/dashboard而非默认的/dashboard。这种配置在技术实现上会面临一些挑战。

问题现象

当用户尝试通过NGINX将Marzban部署在子路径时（如/mb/），虽然能够成功获取HTML页面，但页面中引用的静态资源路径仍然是绝对路径/dashboard，而不是预期的/mb/dashboard。这会导致浏览器无法正确加载CSS、JavaScript等资源，最终呈现空白页面。

技术分析

造成这个问题的根本原因是Marzban前端代码中使用了硬编码的绝对路径。在目前的稳定版本中，前端资源路径是固定写死的，无法自动适应反向代理配置的子路径。

临时解决方案

虽然这不是最理想的解决方案，但可以通过以下NGINX配置来临时解决问题：

location ^~ /statics/ {
    proxy_pass http://127.0.0.1:8000/statics/;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
}

location ^~ /api/ {
    proxy_pass http://127.0.0.1:8000/api/;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
}

location ^~ /subpath/dashboard/ {
    proxy_pass http://127.0.0.1:8000/dashboard/;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    # 其他必要的代理头设置...
}

这种配置虽然能让页面在子路径下工作，但仍然存在以下限制：

1. API调用仍然使用原始URL路径
2. 静态文件路径也需要单独处理
3. 不是真正的路径重写，只是代理转发

未来改进方向

Marzban开发团队已经在next分支中实现了动态仪表板路径功能，这将允许用户自由配置仪表板的访问路径。这个改进预计会在下一个主要版本中发布。

最佳实践建议

对于生产环境部署，建议：

1. 如果可能，尽量使用根路径部署
2. 如需使用子路径，可以考虑等待支持动态路径的版本发布
3. 当前版本下，可以结合URL重写和代理配置来实现功能，但要注意这可能会带来维护复杂性

总结

在Web应用部署中，路径处理是一个常见但重要的问题。Marzban目前在这一方面还有改进空间，开发团队已经意识到这个问题并在积极解决。对于需要立即部署的用户，可以通过NGINX的复杂配置实现功能，但需要注意这可能带来的维护成本。随着项目的不断发展，这一问题有望得到更优雅的解决方案。