Mailu项目中Snappymail自动登出问题的分析与解决

问题背景

在Mailu邮件服务器项目中，部分用户在使用Snappymail Webmail时遇到了自动登出的问题。具体表现为：用户成功登录后，Webmail界面仅显示几秒钟即被自动重定向至登出页面。值得注意的是，该问题仅影响部分用户账户，而管理员账户（如postmaster@）则不受影响。

问题现象

受影响用户在登录流程中会经历以下典型行为序列：

1. 用户通过/sso/login页面成功认证
2. 系统重定向至Snappymail Webmail界面
3. 约5秒后，浏览器自动发起/sso/logout请求
4. 用户被重定向回登录页面

通过浏览器开发者工具分析网络请求，可以观察到在自动登出前，系统会发送一个XHR POST请求至/webmail/?/Json/=&q[]=/0/，该请求的响应中包含了删除smaccount Cookie的指令。

环境配置

受影响系统的主要配置参数包括：

• SESSION_TIMEOUT=864000（10天）
• PERMANENT_SESSION_LIFETIME=2592000（30天）
• 使用Docker Compose部署
• Mailu版本：2024.06.26
• 宿主机系统：Debian 12 Bookworm

排查过程

初步排查

1. 清除缓存测试：删除Snappymail的缓存和设置目录（/mailu/webmail/_data_/_default_/cache和/mailu/webmail/_data_/_default_/storage），问题依旧
2. 浏览器环境测试：尝试不同浏览器、不同设备，清除所有Cookie和本地存储，问题依旧
3. 日志分析：启用LOG_LEVEL=DEBUG后，未发现明显的错误信息

深入分析

通过对比正常账户和异常账户的配置差异，发现关键区别在于AutoLogout参数的设置。异常账户的配置文件中缺少此参数，而正常账户则包含该参数。

解决方案

临时解决方法

手动编辑受影响用户的配置文件：

1. 定位到用户配置文件：/mailu/webmail/_data_/_default_/storage/_domain_/_user_/settings
2. 添加或修改AutoLogout参数，设置其值为0（表示永不自动登出）

{
    "AutoLogout": 0,
    // 其他已有配置...
}

永久解决方案

1. 升级Snappymail：确保使用最新版本，避免已知的配置默认值问题
2. 批量修复：对于已有用户，可以通过脚本批量检查并修复缺失的AutoLogout参数
3. 配置默认值：修改Snappymail的默认配置模板，确保新用户创建时自动包含合理的AutoLogout设置

技术原理

Snappymail的自动登出机制依赖于AutoLogout参数。当该参数缺失时，系统可能使用了一个不兼容的默认值，导致会话立即终止。将值设为0可以禁用自动登出功能，或者可以设置为合理的超时时间（以分钟为单位）。

最佳实践建议

1. 定期检查配置：部署新版本后，应抽样检查用户配置文件的完整性
2. 配置审计：建立配置审计机制，确保关键参数始终存在且有效
3. 文档记录：记录所有自定义配置参数及其预期值，便于故障排查
4. 监控机制：实现用户登录行为的监控，及时发现异常登出模式

总结

Mailu项目中Snappymail自动登出问题通常源于用户配置文件中AutoLogout参数的缺失。通过手动添加该参数并设置适当值，可以有效解决问题。对于生产环境，建议实施系统性的配置管理和监控方案，以预防类似问题的发生。