跳转到主要内容

系统要求

Immich 的硬件和软件要求：

硬件​

  • 操作系统: 推荐使用 Linux 或类 Linux 操作系统 (Ubuntu, Debian 等)。
    • 非 Linux 操作系统的 Docker 使用体验通常较差，强烈不推荐使用。 我们在非 Linux 操作系统上的设置或故障排除支持将大大减少。 如果仍然希望尝试使用非 Linux 操作系统，可以按照以下方式设置：
    • Immich 在虚拟机中运行良好，推荐使用完整的虚拟机。 不推荐在 LXC 容器中使用 Docker（参考此处），但高级用户可能可以尝试。 如果出现问题，建议切换到受支持的虚拟机部署。
  • 内存: 最小 4GB，推荐 6GB。
  • CPU: 最小 2 核，推荐 4 核。
  • 存储: 推荐使用支持 Unix 用户/组归属和权限的文件系统 (EXT4, ZFS, APFS 等)。
    • 缩略图生成和转码视频可能平均增加照片库大小的10-20%。
提示

Postgres 数据库的良好性能和稳定连接对于 Immich 的流畅运行至关重要。 Postgres 数据库文件通常大小在 1-3 GB 之间。 因此，Postgres 数据库 (DB_DATA_LOCATION) 应优先使用本地 SSD 存储，并且绝对不可以使用任何类型的网络共享。 另外，如果使用 Docker 资源限制，Postgres 数据库需要至少 2GB的内存。 Windows 用户可能会遇到与非 Unix 兼容文件系统相关的问题，详情见下文。

软件​

Immich 需要 Docker 和 Docker Compose 插件：

  • Docker Engine: 适用于 Linux 服务器的 CLI 版本（或通过 WSL2 运行于 Windows）。
  • Docker Desktop: GUI版本 不推荐 在 Linux 上使用，但适用于 Windows 或 macOS。

按照链接的安装指南安装 Docker Engine 或 Desktop，它们都会安装 Compose 插件；该插件也可以单独安装。

备注

Immich 要求使用命令 docker compose；类似命名的 docker-compose 已被废弃，Immich 不再支持它。

Windows 用户的特殊要求​

Windows 系统上的数据库存储

Immich 的 Postgres 数据库 (DB_DATA_LOCATION) 必须位于支持用户/组归属和权限的文件系统上 (EXT2/3/4, ZFS, APFS, BTRFS, XFS 等)。它无法在任何格式为 NTFS 或 ex/FAT/32 的文件系统上工作。 在使用 WSL（Windows Subsystem for Linux）并挂载主机目录时（通常位于 /mnt），它也无法正常工作。 如果遇到此问题，可以将绑定挂载改为 Docker 卷，方法如下：

修改 .env 文件如下：

- DB_DATA_LOCATION=./postgres
+ DB_DATA_LOCATION=pgdata

在 docker-compose.yml 文件底部添加以下内容：

volumes:
  model-cache:
+ pgdata: