Microbin项目部署中Nginx子目录路由问题的解决方案

在使用Microbin自托管服务时，许多用户选择通过Nginx反向代理来提供Web访问。当将Microbin部署在非根路径（如子目录/microbin）时，可能会遇到前端无法正常提交内容的问题，具体表现为点击保存按钮无响应。

问题现象分析

用户通过Nginx将https://domain.com/microbin代理到本地的Microbin服务后，虽然能正常访问界面，但提交内容时会出现404错误。通过开发者工具可观察到，前端实际请求的是/upload路径而非预期的/microbin/upload路径。

根本原因

Microbin的前端代码默认使用绝对路径发起API请求，当服务被部署在子目录时，前端仍会向根路径发送请求，导致路径不匹配。这是Web应用在子目录部署时的常见路由问题。

解决方案

方案一：使用子域名部署（推荐）

1. 配置DNS解析，创建专用子域名（如microbin.domain.com）
2. 修改Nginx配置，将子域名直接代理到后端服务：

server {
    server_name microbin.domain.com;
    location / {
        proxy_pass http://127.0.0.1:8082;
        # 其他代理头设置...
    }
}

3. 更新Microbin环境变量中的MICROBIN_PUBLIC_PATH为子域名地址

此方案完全避免了路径问题，是最简洁的解决方案。

方案二：深度路径重写（适用于必须使用子目录的情况）

1. 修改Nginx配置，添加路径重写规则：

location /microbin/ {
    proxy_pass http://127.0.0.1:8082/;
    # 关键重写规则
    rewrite ^/microbin(/.*)$ $1 break;
    # 其他代理设置...
}

2. 确保前端静态资源路径正确：

location /microbin/static/ {
    alias /path/to/microbin/static/;
}

配置要点

1. 代理设置中proxy_pass结尾的斜杠会影响URI传递
2. 必须正确设置Host和X-Forwarded-*头信息
3. Web应用的静态资源路径需要单独处理
4. 任何配置变更后都需要重载Nginx服务

最佳实践建议

对于自托管服务，建议优先考虑子域名部署方案。这种方式：

• 完全避免路径问题
• 更符合现代Web应用架构
• 便于后续扩展和维护
• 减少潜在的Cookie作用域问题

如果受限于环境必须使用子目录，则需确保前后端路径配置的一致性，并进行充分测试。