Autobrr反向代理配置中baseUrl参数的正确使用方法

问题背景

在使用Autobrr的Caddy反向代理配置时，许多用户会遇到baseUrl参数配置不当导致的问题。主要表现为两种异常情况：

1. 当配置为baseUrl = "/autobrr"时，系统会重置用户数据，要求重新创建账户
2. 当配置为baseUrl = "/autobrr/"时，页面显示完全空白

技术原理分析

Autobrr的baseUrl参数设计用于支持URI路径模式的反向代理配置，这与常见的子域名模式有本质区别。URI路径模式需要前后端协同工作：

1. 前端资源路径处理：所有静态资源(JS/CSS)的引用路径需要基于baseUrl重写
2. API请求路径处理：后端API接口需要正确识别并剥离baseUrl前缀
3. Cookie路径作用域：会话cookie需要设置正确的path属性

正确的配置方案

要实现类似Radarr的URI路径模式访问，必须同时满足以下两个条件：

1. Autobrr配置：

baseUrl = "/autobrr/"

注意结尾的斜杠是必须的，这确保了所有资源路径的正确解析。

2. Caddy配置： 必须添加uri strip_prefix /autobrr指令，该指令会：

• 将接收到的请求路径中的/autobrr前缀移除
• 确保后端服务接收到正确的请求路径
• 保持API接口的正常访问

常见问题排查

如果遇到空白页面问题，建议检查：

1. 浏览器开发者工具中的网络请求，确认静态资源是否加载成功
2. 后端日志，确认API请求是否被正确处理
3. Cookie的Path属性是否正确设置为/autobrr

最佳实践建议

1. 始终在baseUrl中使用结尾斜杠
2. 反向代理配置中必须包含路径剥离指令
3. 清除浏览器缓存后再测试配置变更
4. 优先考虑使用子域名模式（如autobrr.example.com），可以避免路径相关的问题

通过正确理解Autobrr的baseUrl工作机制，配合反向代理的路径处理功能，可以实现灵活多样的部署方案，满足不同环境下的访问需求。