immich – 省钱又省心的照片视频自托管多平台工具

这款自托管照片和视频备份工具，省钱又省心！让你摆脱昂贵的云存储费用，自己搭建服务器，享受更经济实惠的备份方案。直接从手机上传，操作简单，隐私保护更到位，随时随地都能访问和恢复。可以自定义存储路径、设置访问权限，对你的数据拥有绝对的掌控权。

功能

核心功能：

• 上传与查看： 无论是移动端还是网页端，都支持上传和查看照片与视频，这是基本功能。
• 自动备份： 移动端在应用开启时自动备份，确保数据实时同步，网页端则需要手动操作。
• 防止重复： 两端都具备防止重复备份的功能，避免存储空间浪费。
• 选择性备份： 移动端允许用户选择性备份相册，提供更灵活的备份策略。
• 下载与分享： 用户可以在本地设备上下载备份数据，并与他人分享。

高级功能：

• 元数据与搜索： 两端都支持查看照片的 EXIF 信息（如相机型号、拍摄时间等）和地图位置，并提供强大的搜索功能。
• 多用户与管理： 网页端提供用户管理功能，适合团队或家庭共享使用，移动端则更注重个人使用。
• 离线支持： 移动端支持离线访问，即使没有网络也能查看照片，网页端则依赖网络连接。

平台差异化功能：

• 移动端独有： 自动备份、选择性备份相册、后台备份、离线支持、LivePhoto/MotionPhoto 支持等功能更适合移动设备的使用场景。
• 网页端独有： 用户管理、360 度图像显示、公共分享、归档等功能，更适合在电脑上进行管理和分享。

安装

硬件要求

操作系统：

• 推荐使用 Linux 操作系统，如 Ubuntu、Debian 等。
• Windows 用户可以使用 Docker Desktop for Windows 或 WSL 2。
• macOS 用户可以使用 Docker Desktop for Mac。

内存：

• 最低 4GB，推荐 6GB。

处理器：

• 最低 2 核，推荐 4 核。

存储：

• 推荐使用与 Unix 兼容的文件系统（如 EXT4、ZFS、APFS 等），并支持用户/组所有权和权限。
• 生成缩略图和转码视频可能会使照片库的平均大小增加 10-20%。
• 支持使用网络共享存储图像和视频资产。

使用 Docker Compose 运行 Immich

Immich 要求使用 Docker Compose 版本 2.x 以上。

第一步 - 下载所需文件

1. 创建一个目录来存放 docker-compose.yml 和 .env 文件，例如 ./immich-app。

2. 进入创建的目录：

   mkdir ./immich-app
   cd ./immich-app

3. 下载 docker-compose.yml 和 example.env 文件，可以通过以下两种方式之一：

   使用命令行下载：

    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.yml 和 example.env 文件，并将它们移动到你创建的目录中。

   注意： 如果你从浏览器下载了文件，请确保将 example.env 重命名为 .env。

可选：硬件加速

• 可以选择启用机器学习和转码的硬件加速。有关如何设置这些加速的详细信息，请参阅硬件转码和硬件加速机器学习指南。

第二步 - 配置 .env 文件

编辑 .env 文件，并根据你的需求进行配置。

• .env 文件示例内容：

  # 可选，如果需要，填写自定义数据库信息。
  # ...
  
  # 设置上传文件的存储位置
  UPLOAD_LOCATION=/path/to/your/storage
  
  # 可选，修改数据库密码。Postgres 数据库不会公开暴露，因此此密码仅用于本地身份验证。
  # 为避免 Docker 解析此值时出现问题，最好仅使用字符 A-Za-z0-9。
  DB_PASSWORD=your_custom_password

第三步 - 启动容器

1. 进入到第一步创建的目录（该目录应包含你已编辑好的 docker-compose.yml 和 .env 文件）。

2. 运行以下命令启动容器：

   docker compose up -d

   Docker 版本注意：

   如果出现错误信息 "unknown shorthand flag: 'd' in -d"，则可能是你使用的 Docker 版本过低。（例如，在 Ubuntu 22.04.3 LTS 中的 docker.io 软件包会出现这种情况。）

   你可以通过以下步骤解决此问题：

   • 使用 apt remove 删除 Ubuntu 自带的 docker.io 软件包。
   • 通过 Docker 官方仓库安装 docker 和 docker-compose 软件包。

   注意： 正确的命令是 docker compose，而不是 docker-compose。

第四步 - 升级

重要提示：

为了避免升级过程中出现问题，请密切关注版本更新信息，并查看包含重大变更的版本列表。

• 如果在 .env 文件中设置了 IMMICH_VERSION 变量，则需要将其更新到最新版本或你想要升级到的版本。

升级 Immich：

当新版本的 Immich 发布时，你可以通过以下命令进行升级（在包含 docker-compose.yml 文件的目录中执行）：

docker compose pull && docker compose up -d

自动更新：

Immich 目前正处于快速开发阶段，可能会出现重大更新和漏洞。因此，我们建议在更新之前阅读版本说明，并在使用 Watchtower 等自动更新工具时格外小心。

更多信息：

有关如何使用 Immich 的详细信息，请参阅安装后指南。

GitHub 身份验证：

下载容器镜像可能需要你登录到 GitHub 容器注册表（具体步骤请参考此处）。

移动端下载

• Google Play
• Apple Store

官方链接

• GitHub 仓库