Audiobookshelf 2.18.0版本中反向代理子目录路径下的电子书加载问题分析

在Audiobookshelf 2.18.0版本中，用户报告了一个关于电子书加载的重要问题。当通过反向代理配置将Audiobookshelf部署在子目录路径下时，EPUB格式的电子书无法正常加载。这个问题主要影响那些希望通过反向代理将Audiobookshelf集成到现有网站中的用户。

问题现象

用户在使用Caddy作为反向代理时，将Audiobookshelf配置在/audiobookshelf子目录下。当尝试打开EPUB电子书时，浏览器会显示空白页面。通过开发者工具检查发现，请求的API路径缺少了配置的子目录前缀，导致请求失败。

具体表现为：浏览器尝试访问/api/items/{item-id}/ebook路径，而不是预期的/audiobookshelf/api/items/{item-id}/ebook路径。这种路径不匹配导致请求无法正确路由到后端服务。

技术背景

Audiobookshelf是一个开源的音频书籍管理平台，支持电子书和有声读物的管理。在2.18.0版本中，系统对电子书阅读功能进行了改进，但在处理反向代理配置时出现了路径解析问题。

反向代理是常见的部署方式，特别是当需要：

1. 将多个服务集成到同一域名下
2. 添加SSL/TLS加密
3. 实现负载均衡
4. 进行URL重写等操作时

问题根源

经过分析，这个问题源于前端代码在构建API请求时没有充分考虑反向代理配置的子目录前缀。具体来说：

1. 前端代码在生成电子书阅读请求时使用了绝对路径
2. 路径构建逻辑没有从配置中读取反向代理的子目录前缀
3. 导致生成的URL与实际的代理配置不匹配

解决方案

项目维护者已经确认这个问题并计划在近期发布修复补丁。对于遇到此问题的用户，可以采取以下临时解决方案：

1. 暂时使用端口直接访问（如13378端口）
2. 在反向代理配置中添加额外的URL重写规则
3. 回退到2.17.x版本等待修复

最佳实践建议

在使用反向代理部署Audiobookshelf时，建议：

1. 测试所有功能，包括电子书阅读、音频播放等核心功能
2. 检查开发者工具中的网络请求，确保所有API路径正确
3. 考虑使用子域名而非子目录进行反向代理配置
4. 保持关注项目更新，及时应用修复补丁

这个问题提醒我们在进行Web应用部署时，特别是在使用反向代理配置时，需要全面测试所有功能路径，确保前端构建的URL与后端路由配置完全匹配。