Domoticz登录页面循环跳转问题分析与解决方案

问题现象

在Domoticz智能家居系统中，部分用户反馈在升级到2024.4版本后（或从旧版本迁移后），出现无法通过Web界面正常登录的情况。具体表现为：

1. 输入正确的用户名密码后，页面短暂跳转至仪表盘又立即返回登录界面
2. 日志显示"Login successful"但会话无法保持
3. 仅通过本地127.0.0.1访问可正常登录，外部设备均失败

根本原因分析

经过技术排查，该问题主要由以下两个因素导致：

1. 系统时间不同步
   Domoticz的会话Cookie采用时间戳验证机制。当Raspberry Pi的系统时间与实际时间偏差过大时（特别是断电后未正确同步），会导致生成的Cookie立即过期，表现为"登录成功但无法保持会话"。

2. 认证机制变更
   新版本默认使用"login page"模式替代旧版的"basic-auth"，前者依赖Cookie维持会话，对系统时间同步和浏览器设置更为敏感。

解决方案

方案一：校正系统时间（推荐）

1. 通过SSH连接Raspberry Pi
2. 执行时间同步命令：

   sudo timedatectl set-ntp true
   sudo systemctl restart systemd-timesyncd
   

3. 验证时间是否正确：

   date
   

方案二：调整认证设置

1. 通过本地访问(127.0.0.1)登录Domoticz
2. 进入"Settings → System Settings"
3. 在"Security"选项卡中：
   • 确保"Local Networks"包含内网IP段（如192.168.1.0/24）
   • 或切换为"Basic-Auth"模式（不推荐，安全性较低）

方案三：浏览器配置

1. 清除浏览器缓存和Cookie
2. 确保未启用"隐私模式"或"无痕浏览"
3. 登录时勾选"Remember me"选项

技术原理补充

Domoticz的Web认证流程包含以下关键环节：

1. 服务端生成包含时间戳的Session Token
2. 通过Set-Cookie头返回给客户端
3. 后续请求需携带有效Cookie
4. 服务端会验证Cookie时间戳与服务器时间的偏差

当系统时间异常时，即使密码验证通过，生成的Cookie也会因时间校验失败而被丢弃，导致循环跳转。该设计是安全机制的一部分，防止重放攻击。

最佳实践建议

1. 为Raspberry Pi配置NTP服务自动校时
2. 建议使用UPS设备避免意外断电
3. 定期检查系统日志中的时间同步状态
4. 对于家庭网络，可将设备IP加入"Local Networks"白名单

通过以上措施，可有效解决登录循环问题，同时保证系统安全性。该问题非软件缺陷，而是系统配置与安全机制交互产生的结果。理解其背后的技术原理，有助于更好地运维Domoticz系统。