Sonarr多实例本地存储隔离问题的技术解析与解决方案

在Sonarr项目的实际使用场景中，部分用户会采用同一主机下部署多个实例的方式管理不同类型的媒体资源（如普通剧集与动画剧集）。这种架构虽然提高了资源隔离性，但近期版本（v3.x）暴露出一个关键问题：不同实例间的本地存储数据会相互覆盖。

问题本质

浏览器本地存储(LocalStorage)采用域名作为隔离边界，而Sonarr将所有实例的用户操作偏好（如最后选择的根目录、剧集类型等）统一存储在'sonarr'这个硬编码键名下。当用户通过不同路径前缀（如/tv和/anime）访问同一域名的多个实例时，浏览器会共享相同的LocalStorage命名空间。

这种设计会导致两个典型问题：

1. 在添加新剧集时，默认根目录可能来自其他实例的存储记录
2. 当跨实例的默认值不兼容时（如目标实例不存在记录的根目录），会直接导致操作失败

技术背景

现代前端应用通常使用持久化状态管理来提升用户体验，Sonarr通过createPersistState中间件将Redux状态自动同步到LocalStorage。问题根源在于存储键名的设计未考虑多实例场景，这与浏览器安全模型形成冲突：

• 同源策略：相同协议+域名+端口视为同一源
• 存储隔离：LocalStorage按源隔离，不区分路径

解决方案

项目维护者通过提交bcfad1f引入实例感知的存储键名机制，核心改进包括：

1. 动态生成包含实例路径的存储键名
2. 保持向后兼容性，自动迁移现有数据
3. 确保各实例状态完全隔离

这种方案与Radarr的处理方式形成对比，后者由于不同的实现方式未出现相同问题。技术实现上参考了已有的认证cookie隔离方案，体现了架构设计的一致性。

最佳实践

对于自行部署多实例的用户，建议：

1. 升级到包含该修复的版本（v3.0.10+）
2. 检查各实例的根目录配置是否冲突
3. 对于历史数据，系统会自动处理键名迁移

该修复不仅解决了界面交互问题，更重要的是确立了多实例场景下的状态管理规范，为后续功能扩展奠定了基础。这种设计模式也可为其他需要支持多实例的Web应用提供参考。