开源自托管相片视频管理工具Immich更新失败的原因，
目前的 .env 配置为：
代码段
IMMICH_VERSION=v2
当前服务器版本为 2.7.5，而最新版本已到 3.0.2。
这是一次跨大版本升级。Immich 官方不会将 v2 标签自动指向 v3，因此配置保持不变会一直停留在 2.7.x。根据官方文档，升级到新的主版本需要手动将 IMMICH_VERSION 修改为对应的新主版本标签（如 v3）或指定具体版本号。
升级步骤
- 修改配置文件： Bash
nano /data/dockge/stacks/immich-app/.env
- 将： 代码段
IMMICH_VERSION=v2
修改为： 代码段
IMMICH_VERSION=v3
(或者固定到 IMMICH_VERSION=v3.0.2。更推荐使用 v3，方便后续直接通过 docker compose pull 获取 3.x 的补丁更新)
3. 执行更新命令：
Bash
cd /data/dockge/stacks/immich-app
docker compose pull
docker compose up -d
注意事项（请勿直接盲目升级）
Immich v3 包含破坏性更新（Breaking Changes）。在执行上述升级命令前，务必先查阅官方迁移文档，确认是否有需要调整的环境变量或配置。
关于数据库兼容性： 当前 docker-compose.yml 中的配置为：
YAML
image: ghcr.io/immich-app/postgres:14-vectorchord0.4.3-pgvectors0.2.0
该镜像已在使用 VectorChord，并非已被弃用的 pgvecto.rs。因此数据库部分符合官方推荐配置，无需额外迁移。