Radarr多实例登录问题的技术分析与解决方案

问题背景

在Radarr的实际使用场景中，很多用户会部署多个实例来管理不同的媒体库。然而，当用户尝试同时登录多个Radarr实例时，会遇到一个典型的问题：登录第二个实例会导致第一个实例自动登出。这种现象严重影响了用户的使用体验，特别是对于需要同时操作多个实例的管理员来说。

问题根源分析

经过技术分析，该问题的根本原因在于Radarr的身份验证机制设计：

1. Cookie命名冲突：所有Radarr实例都使用相同的Cookie名称"RadarrAuth"来存储身份验证信息
2. 浏览器存储机制：浏览器对于同域名下的Cookie会进行覆盖处理
3. 本地存储共享：localStorage中的设置项也使用了相同的命名空间

当用户在同一个浏览器中访问不同实例时，后登录的实例会覆盖前一个实例的认证信息，导致前一个实例的会话失效。

技术解决方案

核心解决思路

解决这个问题的核心在于为每个Radarr实例创建独立的身份验证标识空间。具体可以通过以下方式实现：

1. 动态Cookie命名：将固定的"RadarrAuth"改为包含实例唯一标识的动态名称
2. 实例标识选择：可以使用端口号、实例名称或URL路径作为区分标识
3. 本地存储隔离：同步修改localStorage中的相关键名，确保各实例设置互不干扰

实现方案比较

在技术实现上，开发者社区提出了几种可能的方案：

1. 基于端口号的方案：最简单直接，但需要暴露配置提供程序
2. 基于实例名称的方案：更语义化，但需要额外配置
3. 混合方案：结合URL和端口号，确保最大兼容性

经过讨论，最终选择了基于端口号的方案，因为：

• 端口号天然唯一
• 不需要额外配置
• 实现相对简单

技术实现细节

在具体实现上，主要修改了Radarr的认证构建器扩展部分。关键修改点包括：

1. 认证Cookie命名：将硬编码的"RadarrAuth"改为动态生成的名称
2. 认证中间件配置：确保认证中间件能正确识别和处理动态命名的Cookie
3. 前后端协调：保证前端JavaScript能正确读取和处理修改后的Cookie名称

实际效果

该解决方案实施后，用户可以：

• 在同一浏览器中同时保持多个Radarr实例的登录状态
• 各实例的认证信息互不干扰
• 无需额外配置即可享受多实例支持

技术启示

这个问题的解决过程给我们带来了一些有价值的技术启示：

1. 分布式系统设计：即使是单机多实例的场景，也需要考虑资源隔离
2. 命名空间管理：全局唯一的标识符对于多实例环境至关重要
3. 用户场景考虑：开发者需要充分考虑实际使用场景，而不仅仅是功能实现

Radarr作为一款成熟的媒体管理工具，通过这个改进进一步提升了其在复杂部署环境下的可用性，体现了开源社区对用户体验的持续关注和优化。