Immich
SHA-256高性能自托管的照片和视频管理方案
自己搭建的私人谷歌相册，完全掌控数据
核心功能
- 手机照片视频自动备份
- AI 智能搜索（物体、人脸、文字）
- 人脸识别与自动聚类
- 多用户支持与共享相册
- 支持 Raw、LivePhoto、360 度图像
避坑指南
- •务必遵守 3-2-1 备份策略，不要仅依赖 immich 存储珍贵照片。2. 初次部署需注意存储路径设置，外部存储卷挂载错误可能导致数据丢失。3. 人脸识别和 AI 搜索需要一定的 CPU/GPU 资源，低配机器可能响应较慢。4. 反向代理（如 Nginx）部署时需正确配置 WebSocket 和文件上传大小限制。5. 与 Google Photos 不同，immich 没有无限存储，需自行管理磁盘空间。
适用场景
- 替代 Google Photos 或 iCloud 照片，将数据保存在自己的服务器上
- 家庭或小团队共享照片和视频，无需依赖第三方云
- 摄影师备份和管理原始照片与视频，保留完整 EXIF 信息
详细介绍
Immich 是一个开源的自托管照片和视频管理平台，旨在让您完全掌控自己的媒体文件。它提供手机自动备份、强大的 AI 搜索（物体、人脸、文本 CLIP 识别）、人脸识别与聚类、共享相册、多用户支持以及时间线界面。支持 Raw 格式、实况照片、360 度图像，并同时提供移动端和网页端客户端。与云服务不同，您的数据保留在自己的基础设施上，确保隐私和所有权。
常见问题与排障 (1)
故障排除为什么在 Immich 中 ENCODED_VIDEO_LOCATION 和 THUMB_LOCATION 环境变量不生效？
这些环境变量不会被Immich服务器代码读取。它们仅用于在docker-compose.yml中进行变量替换，以简化卷挂载路径。要实际使用自定义存储位置，请更新相关容器的卷挂载，将您期望的主机目录映射到预期的内部路径（例如，将/your/custom/thumbs挂载到/usr/src/app/upload/thumbs）。有关示例，请参考官方的custom-locations指南。
标签
快速上手
安装软件
双击下载的安装程序，按提示完成安装
步骤1：准备一台 Linux 服务器（或 NAS），安装 Docker 和 Docker Compose
步骤2：从官方仓库下载 docker-compose.yml 和 .env 文件，根据注释修改配置（如存储路径）
步骤3：在终端运行 `docker compose up -d`，等待容器启动
- 步骤1：准备一台 Linux 服务器（或 NAS），安装 Docker 和 Docker Compose
- 步骤2：从官方仓库下载 docker-compose.yml 和 .env 文件，根据注释修改配置（如存储路径）
- 步骤3：在终端运行 `docker compose up -d`，等待容器启动
已提供 SHA-256 校验码，下载后可自行核对文件完整性
该校验码提取自 GitHub 官方 Release 页面
SHA256 校验码
ae3a662c7b32fe090d4eed35c4fc8586f5d1faa41a252b401aa1581b0dca97e6该校验码提取自 GitHub Release 页面，下载后请自行核对文件完整性
本平台所有 SHA-256 校验码均提取自项目在 GitHub 官方 Release 页面发布的文件，未做任何修改。你可以通过 GitHub Releases 页面自行验证。
开源透明
查看 GitHub 源码卸载说明
在 docker-compose.yml 所在目录运行 `docker compose down -v`（-v 会删除数据库卷，如需保留数据请省略 -v），然后删除 immich 目录即可。
无额外依赖
下载后即可直接使用，无需安装其他运行环境
遇到问题？查看下方 FAQ
1 FAQ