在 NAS 和群晖威联通上装 Immich：各平台安装路线一览
官方文档为 Docker Compose 之外的常见平台各准备了一条安装路径。它们殊途同归——最终都是让同一套容器跑起来——但各平台的坑位不同，这一页帮你选对入口、避开共性错误。
各平台路线速查
| 平台 | 官方路线 | 要点 |
|---|---|---|
| 群晖 Synology | Container Manager 跑 compose 项目 | 走 DSM 套件中心装 Container Manager，导入 compose 文件 |
| 威联通 QNAP | Container Station | 版本较老时注意 Compose v2 支持情况 |
| Unraid | Community Applications 模板或 compose | 多 compose 文件支持有限，需内联硬件加速配置 |
| TrueNAS | 官方 App 目录 | 走系统自带的 Apps 机制 |
| Portainer | 图形化 compose | 同样不支持多 compose 文件引用 |
| Kubernetes | Helm/manifest | 适合已有 K8s 集群的用户 |
| 一键部署 | 官方合作托管 | 没有自有机器时的替代方案，本质是托管 |
三个平台无关的共性提醒
数据库位置的老规矩不变。不管平台多花哨，Postgres 数据目录必须落在本地文件系统上。群晖上把数据库目录指到共享文件夹（很多是 Btrfs/EXT4 没问题，但走网络协议挂载的会出事）前先确认这一点，见 .env 配置详解。
docker compose 而非 docker-compose。老系统自带的 Compose v1 已不被 Immich 支持。威联通、老群晖装新版 Container Manager/Container Station 就是为了拿到 Compose v2。
内存预算别忘了机器学习。NAS 上可分配的内存经常比独立机器紧张——8GB 内存的入门 NAS 跑完系统后剩不了多少。配额不够时的取舍见 硬件要求 的 4GB 例外条款：关闭机器学习保核心备份功能。
硬件加速在 NAS 上的特殊性
群晖/威联通机型差异大，GPU 直通配置五花八门。硬件转码一页 讲通用原理；对 Unraid 和 Portainer 这类不支持多 compose 文件的平台，官方文档提供了把 hwaccel.transcoding.yml 内容内联进主 compose 文件的写法——部署阶段可以先跳过转码加速，跑稳了再回来加。
装完之后
平台安装只是把 标准部署流程 的「建目录下载文件」两步换成了图形界面操作，后面的 管理员注册、手机连接、备份配置完全一致。遇到平台特有的报错，优先查该平台官方文档页和社区讨论，关键词用「平台名 + Immich」。