Immich 自托管照片和视频管理

它是什么

Immich 是一个你自己运行的服务器，用来存放照片和视频。它的 README 把它称作高性能的自托管照片和视频管理方案。它带一个网页应用和手机应用。手机会在后台上传新照片，服务器会给人脸分组、识别图片里的文字，还能按照片的内容回答搜索。这个条目讲的是运行服务器：服务器要你自己装，大多数方式从两个发布文件开始，而不是从手机应用商店装。

1. 下载两个发布文件，运行 docker compose up -d
2. 第一个在 2283 端口注册的用户就是管理员
3. 手机应用在同一个地址登录
4. 备份会上传你选的相册里的照片
5. 机器学习给人脸分组，也支撑搜索

适合谁

想把照片库放在自己掌控的机器上、又愿意跑 Docker 的人。一个家庭或一个家庭实验室都能用，因为它有用户、共享相册和管理员。如果你不想自己照看服务器，就别用它。文档要求至少 6 GB 内存，备份也要你自己安排。

用在哪里

服务器以 Docker 容器的方式运行。文档推荐 64 位 Linux，强烈不建议用其他系统。如果你仍想试，Windows 可以通过 Docker Desktop 或 WSL 2 搭建，macOS 可以通过 Docker Desktop 搭建，但团队在这些系统上能给的帮助会大大减少。你可以在浏览器里用它，也可以用 iOS 和 Android 的手机应用。

如何设置

点“获取”会把一个装有 Mindket 安装说明的 zip 压缩包存进你的下载文件夹，里面有运行 Immich 的每种方式、手机应用、升级和备份各一页。主要途径是 Docker Compose，用最新发布版里的两个文件。

1. 新建一个 Immich 文件夹。从最新发布版把 docker-compose.yml 和 example.env 下载进去。把第二个存成 .env。
2. 编辑 .env。把 UPLOAD_LOCATION 指向一个有空闲空间的新文件夹，改掉 DB_PASSWORD，需要的话再设置 TZ。
3. 运行 docker compose up -d。它会启动容器。
4. 打开网页并注册。访问 http://<machine-ip-address>:2283，点 Getting Started。第一个用户就是管理员。

mkdir ./immich-app
cd ./immich-app
wget -O docker-compose.yml https://github.com/immich-app/immich/releases/latest/download/docker-compose.yml
wget -O .env https://github.com/immich-app/immich/releases/latest/download/example.env

docker compose up -d

前两行建好文件夹并进入它。后两行下载文件，并把 example.env 存成 .env。

如何使用

在网页应用里上传，或者让手机来做。在手机上，点右上角的云图标，选要备份的相册，再按 Enable Backup。除非你在备份设置里改动，否则它只在 Wi-Fi 下上传。

搜索不只看文件名。

• People：服务器认出的人脸
• Contextual：照片或视频里有什么
• 图片里的文字，用 OCR 读出
• 位置，来自反向地理编码
• 文件名、文件夹路径、描述、标签和相机
• 时间范围、媒体类型、收藏、归档和星级评分

人脸和按内容搜索由机器学习服务负责。文档说它第一次需要某个模型时才去下载。

更新的话，如果你固定了版本，就改 .env 里的 IMMICH_VERSION，读一下发布说明，然后在放着 docker-compose.yml 的文件夹里运行：

docker compose pull && docker compose up -d

示例

你想让伴侣的手机和你的手机在家里共用一个图库。你搭好服务器，以管理员身份注册。接着在这里建第二个用户：

Administration > Users > Create user

两部手机都用服务器地址登录并打开备份。每部手机上传到自己的账号。想看到对方的照片，你们用共享相册或伙伴共享，README 把这两项都列为功能。

新手与专家

新手：Immich 把照片放在你自己的机器上，所以备份也得你自己来做。先从手机上传几张照片试试。快速入门页建议先传几张照片再传整个图库，还说大批量上传可能要很久。在把所有照片都交给它之前，先把服务器备份设好。

专家：compose 文件运行四个服务。它们是 2283 端口上的服务器、带模型缓存卷的机器学习服务、给 Redis 用的 Valkey 镜像，以及来自 Immich 自己镜像库、带 VectorChord 扩展的 Postgres。把 IMMICH_VERSION 设成 v3 这样的标签，会跟着这个大版本走，并跳过候选发布版。把 IMMICH_CONFIG_FILE 指向一个 JSON 或 YAML 文件，网页应用里就不能再改其他属性了。

文档还介绍了用 GPU 做视频转码（NVENC、Quick Sync、RKMPP 和 VAAPI）和机器学习（ARM NN、CUDA、ROCm、OpenVINO 和 RKNN）。两者都标为实验性。放在反向代理后面时，要转发 Host、X-Real-IP、X-Forwarded-Proto 和 X-Forwarded-For 请求头，允许大文件上传，并把 Immich 放在域名的根路径上，因为不支持子路径。服务器容器里的 immich-admin 工具可以重置管理员密码，也能列出用户。

注意事项

大部分内容在你的机器上运行，风险主要在你自己的副本上。

• 备份：数据库转储默认每天凌晨 2:00 运行，保留最近 14 份。它们只含元数据，所以你的照片和视频要另外备份 UPLOAD_LOCATION。README 提醒要遵循 3-2-1 备份计划
• 复制顺序：文档说复制时要停掉服务器容器，或者先备份数据库、再备份文件
• 更新：手机应用通常能配合当前和上一个大版本，服务器只和相同的大版本配合，所以先更新手机。不支持降级
• Free Up Space：它会删除 Immich 已备份的手机本地副本。在 Android 上，WhatsApp 聊天里的媒体之后可能显示模糊，如果你在 iOS 上使用 iCloud 照片，它还会把照片从 iCloud 和同一 Apple 账户下的其他设备上删掉
• 对外连接：默认配置会从 tiles.immich.cloud 加载地图样式，机器学习服务第一次需要某个模型时会去下载。配置还开启了新版本检查和反向地理编码，这些说明没有追查这两项是否对外发送、发送什么
• 密码：示例 .env 自带 DB_PASSWORD=postgres，所以要改掉。Postgres 不对外公开，所以这个密码只用于本地
• 安装脚本：它把下载的脚本交给 bash 执行，文档称它是实验性的，所以先读一遍
• 社区指南：群晖、Unraid 和 TrueNAS 的页面不是 Immich 团队官方支持的
• 费用：软件免费。支持页说你也可以购买 Immich，并说所有功能都免费，没有任何功能放在付费墙后面
• 许可证：AGPL-3.0，带标准的 LICENSE 文件。修改 Immich 并分享你的版本之前，先读一读
• 不代表认可：这些说明由 Mindket 编写，Immich 团队没有制作也没有认可。它们来自 README 和文档页面，里面的内容都没有运行过