Hassio-Addons中Immich服务的版本兼容性问题解析

问题背景

在Home Assistant操作系统中运行的Immich服务（照片管理应用）近期出现了版本兼容性问题。Android客户端自动更新后，要求服务器端最低版本为1.106.0，而Home Assistant中的Immich插件版本仍停留在1.105.1，导致客户端无法正常连接服务器。

技术分析

Immich是一个自托管的照片和视频备份解决方案，由客户端和服务器端组成。当客户端版本高于服务器端时，可能会出现兼容性问题。在本案例中：

1. 版本差异：Android客户端更新后需要1.106.0及以上版本的服务器支持
2. 更新机制：Home Assistant中的Immich插件采用每周六自动更新的策略
3. 回退限制：Android应用商店不提供降级安装选项，用户无法自行回退到旧版客户端

解决方案

针对这一版本兼容性问题，开发团队采取了以下措施：

1. 版本升级：将Immich插件升级至1.106.4版本
2. 端口配置修复：解决了环境变量中端口设置的类型问题（从整数8080改为字符串"8080"）
3. 验证测试：确认新版本在aarch64架构的HAos上正常运行

技术细节

值得注意的是，Immich 1.106.x版本在配置上有以下变化：

1. 端口绑定：服务器默认监听在3001端口
2. API路由：新增了用户头像相关API端点
3. 环境变量：严格了端口参数的格式要求

用户建议

对于遇到类似问题的用户，建议：

1. 定期检查Immich插件的更新状态
2. 在客户端自动更新前，确认服务器端版本是否兼容
3. 遇到问题时，可通过Portainer插件进行手动配置调整
4. 及时查看日志文件获取详细的错误信息

总结

版本管理是自托管服务中常见的挑战。Immich作为快速发展的项目，其版本迭代较为频繁。Home Assistant用户应关注插件更新周期，并在必要时手动触发更新检查，以确保客户端和服务器的版本兼容性。开发团队已通过及时更新解决了这一特定问题，后续版本应能提供更稳定的使用体验。