Immich 硬件要求：内存 CPU 存储与操作系统的真实门槛

Immich 是少数「官方把最低配置写得很明确」的自托管项目。这一页按官方文档的口径整理，数字均来自官方要求页，随版本更新可能有变化，以官方最新文档为准。

硬件底线

项目	最低	推荐	说明
内存	6GB	8GB	上传与机器学习处理同时进行时吃内存
CPU	2 核	4 核	影响转码与任务处理速度
架构	amd64 或 arm64	同左	常见 x86 电脑与新款树莓派分属两类
存储	视照片库规模	照片库 × 1.2	缩略图与转码平均多占 10–20%

关于内存的例外：只有 4GB 内存的机器也能跑，但需要在管理后台关闭机器学习功能——这意味着语义搜索和人脸识别不可用，只剩基础的时间线浏览和备份。这是个值得知道的降级路径，不是理想形态。

系统与软件要求

操作系统：官方强烈推荐 Linux（Ubuntu、Debian 等）64 位系统。Windows 和 macOS 只能通过 Docker Desktop 或 WSL2 跑，官方明说「体验较差，出问题能得到的协助也有限」。
Docker + Compose 插件：唯一官方部署方式。注意是 docker compose（空格），老的 docker-compose 连字符版本已不被支持。
x86-64-v2 微架构：从 v3 起，机器学习容器在 amd64 上要求 CPU 支持 x86-64-v2 指令集——大约 2012 年以后的主流 CPU 都满足。极老的机器最高只能用到 v2.7.5 版本。

两个最容易踩的存储坑

数据库必须放本地盘。Postgres 数据文件（默认 1–3GB）要求放在本地 SSD 上，官方原话是「任何形式的网络共享都不行」。DB_DATA_LOCATION 指向 NAS 挂载目录是新手高频故障源。

Windows 用户的文件系统陷阱。Postgres 无法在 NTFS、exFAT、FAT32 上运行；WSL2 里挂载的宿主目录（/mnt 开头的路径）同样不行。解决办法是在 .env 里把 DB_DATA_LOCATION=./postgres 改成 DB_DATA_LOCATION=pgdata（使用 Docker 卷），具体改法见 .env 关键配置。

LXC 容器警告。Proxmox 等 LXC 容器内跑 Docker 不被推荐，虚拟机（VM）才是受支持形态。

拿不准就先这么配

一台 4 核 8GB、256GB SSD 起步的旧笔记本或迷你主机，配上外接硬盘放照片，足够一个四口之家从零用起。装好之后如果发现任务处理慢，再回头读任务队列一页学习怎么调度和限流。下一步：Docker Compose 部署完整流程。