Immich的安装与配置

要求

基础
- 已安装Docker（带有compose插件）
- 系统为以下架构：amd64，arm64
- 4GB RAM，2core CPU
推荐
- 可访问ghcr镜像
- Linux操作系统（其它系统可能会有未知问题）
- 6GB RAM，4core CPU
- Unix兼容，带有用户/组所有权和权限的文件系统 (EXT4, ZFS, APFS, etc.)

NTFS或exFAT/32文件系统（Windows文件系统）的附加要求

Immich Postgres数据库（DB_DATA_LOCATION）必须位于支持用户/组所有权和权限的文件系统上（如EXT2/3/4、ZFS、APFS、BTRFS、XFS等）。它不能在格式化为NTFS或ex/FAT/32的任何文件系统上工作它在WSL（Windows的Linux子系统）中使用挂载的主机目录（通常在/mnt下）时也无法工作但您可以将绑定挂载更改为Docker卷，方法如下：

在.env文件中修改存储路径为Docker卷：

- DB_DATA_LOCATION=./postgres
+ DB_DATA_LOCATION=pgdata

在docker-compose.yml的底部添加名为pgdata的Docker卷：

volumes:
  model-cache:
+ pgdata:

下载&配置 docker-compose.yml

下载文件

docker-compose.yml

.env （需重从example.env命名为.env）

将其存放在某个空文件夹内

自定义 .env

UPLOAD_LOCATION 是上传照片的存储位置，请修改为一个空文件夹，并确保有足够的可用空间，适当的权限
DB_DATA_LOCATION 是数据库的存储位置请，修改为一个空文件夹，并确保有足够的可用空间，适当的权限（建议存储在固态硬盘上）
TZ 是时区代码，请修改为自己所处第的时区
IMMICH_VERSION 是immich的版本号，建议修改为最新的版本号，以避免由于自动升级造成的，服务不可用/损坏
DB_PASSWORD 是数据库的密码，请更改为128字符内、由大小写阿拉伯字符、和数字组成的随机字符

启动容器

进入存放docker-compose.yml和.env的文件夹 bash title="Start the containers" docker compose up -d

如果没有出现任何错误，则代表您可以进行下一步骤了

如有报错，请询问AI或查看Immich官方安装教程（英文）或联系我

初始化

初次使用

前往http://<服务器IP地址>:2283

点击Getting Started按钮

按照实际情况填写

将面板设置为自身熟悉的语言

头像-Account Settings-App Settings-Lanuage

下一步

前往官方文档寻找相关内容（英文）

设置可选功能

以下链接将引导您访问官方文档（英文）

外部图库: 将现有照片库添加到 Immich
硬件转码: 加快视频转码
硬件加速机器学习: 加快各种机器学习任务（人脸识别、智能搜索）

其它/善后

更新

Warning
请务必阅读发布说明！ Immich 目前正处于紧张的开发阶段，这意味着您可能会遇到破坏性更改和错误。因此，我们建议在更新前阅读发布说明，并在使用Watchtower等自动工具时特别小心。
您可以在 GitHub Discussions 上查看有中断更改的版本。

如果设置了 IMMICH_VERSION，则需要将其更新为最新版本或所需版本。

当 Immich 的新版本发布时，可以使用以下命令升级和重启应用程序，这些命令在包含 docker-compose.yml 文件的目录下运行：

docker compose pull && docker compose up -d

要清理磁盘空间，可以使用以下命令删除旧版本的过时容器映像：

docker image prune

参考/可能有用的信息

Immich文档