FreshRSS中OIDC会话持久化问题的解决方案

在FreshRSS项目中，当使用OIDC(OpenID Connect)认证方式时，用户会遇到会话无法持久保存的问题。具体表现为：用户登录后，如果关闭浏览器标签页，过一段时间再重新访问时，系统会要求重新登录，而不是保持原有的登录状态。

问题分析

这个问题的根源在于FreshRSS的Docker容器默认配置中没有正确设置PHP会话相关的参数。在标准的PHP应用中，会话持久性通常由以下几个关键参数控制：

1. session.cookie_lifetime - 控制会话cookie的生命周期
2. session.gc_maxlifetime - 控制服务器端会话数据的存活时间
3. session.save_path - 指定会话数据存储位置

在Docker环境下，如果没有显式配置这些参数，PHP会使用默认值，导致会话在短时间内失效。

解决方案

通过在Docker容器的启动脚本(entrypoint.sh)中添加以下两行PHP配置，可以解决会话持久性问题：

php -d "session.cookie_lifetime=86400" \
    -d "session.gc_maxlifetime=86400" \
    -d "session.save_path=/tmp/sessions" \
    /var/www/FreshRSS/app/actualize_script.php > /dev/null 2>&1

这两行配置的作用是：

1. 将会话cookie的生命周期设置为86400秒(24小时)
2. 将会话数据在服务器端的存活时间同样设置为24小时
3. 指定/tmp/sessions作为会话数据存储路径

实现原理

这种解决方案通过以下机制确保会话持久性：

1. 浏览器端：设置了较长生命周期的会话cookie，确保浏览器关闭后cookie不会立即失效
2. 服务器端：延长了会话数据的存活时间，防止过早被垃圾回收
3. 存储路径：明确指定会话存储位置，避免默认路径可能导致的权限问题

注意事项

1. 会话时间设置应根据实际安全需求进行调整，24小时可能不适合所有场景
2. 在生产环境中，建议将会话数据存储在更持久的位置，而非/tmp目录
3. 如果使用多节点部署，需要考虑会话共享机制

这个解决方案已经在FreshRSS 1.24.2-dev版本中得到验证，适用于PostgreSQL数据库和多种PHP版本环境。