在绿联 NAS 上部署开源自托管的手机照片备份工具 Immich

电脑端

Immich 相册简介

Immich 是一个开源的照片备份解决方案，类似于 Google Photos，但完全免费且具有 AI 功能。它主要用于家庭服务器（如 NAS）上部署，提供照片备份、管理和智能处理功能。

功能特点

● 照片备份：Immich 能够自动备份设备上的照片和视频，确保数据的安全和完整性。

● 智能管理：它具有智能分类和整理功能，可以根据日期、地点等信息自动整理照片和视频。

● AI功能：Immich 支持 AI 图像处理，包括人脸识别、图像合并、AI 美颜和智能编辑等，提升图片质量和管理效率。

● 多设备同步：用户可以在不同的设备上同步照片和视频，实现跨设备访问和管理。

● 界面友好：其用户界面设计美观，操作简便，适合家庭用户使用。

了解更多功能详情，可参考：Immich 官方网站

创建 Immich 文件夹

1. 打开“文件管理”应用。

2. 在共享文件夹下的 Docker 目录中，创建一个新文件夹，并命名为 immich。

创建子文件夹并保存路径

1. 进入刚创建的 immich 文件夹，在其中再创建三个子文件夹：

● postgres

● 相册

● 手机相册

2. 创建完成后，分别选中每个文件夹，右键点击“属性”，复制文件夹的路径位置并保存。稍后在修改配置文件时需要用到。

准备配置文件

在部署 Immich 之前，您需要先准备好必要的配置文件。

1. 访问 Immich 的 GitHub 仓库，下载 docker-compose.yml 文件和 .env 配置文件到您的电脑本地。

2. 使用文本编辑器打开下载的example.env文件，找到UPLOAD_LOCATION字段，将其值修改为您希望在 NAS 上存放相册数据的实际目录路径。

3. 确认修改无误后，保存该文件。

上传并配置环境文件

接下来，需要将配置好的文件上传至 NAS。

1. 打开 NAS 的“文件管理”应用，进入“Docker”>“immich”文件夹（如果没有，请手动创建）。将刚才准备好的配置文件上传至此目录。

2. 上传完成后，请选中example.env文件，将其重命名为.env。

看不到 .env 文件？

Linux 系统默认会将以.开头的文件视为隐藏文件。如果您重命名后文件消失了，请按以下步骤操作：

● 打开“文件管理”的“设置”>“常规设置”。

● 取消勾选“隐藏以 . 开头的文件”选项。

● 点击保存，即可在列表中看到.env文件。

使用 Docker Compose 部署 Immich 容器

在 UGOS Pro 系统中，推荐使用 Docker Compose 部署 Immich。

此方式适合同时管理多个容器的场景，可通过单个 YAML 文件批量定义和启动服务，从而大幅简化容器的创建与维护过程。

部署步骤

1. 打开“Docker”应用，在左侧导航栏中选择“项目”＞“创建”按钮，启动项目创建向导。

2. 在项目创建向导中，选择从“本地电脑导入” Compose 配置，并上传之前下载的 immich.yml 文件。

3. 导入完成后，系统会自动识别 YAML 文件中的服务配置，点击“立即部署”。系统将自动拉取镜像并启动所有相关容器。

验证部署结果

部署完成后，可在“Docker”>“容器”页面中查看 Immich 的各个服务状态：

● 若所有服务均显示为“运行中”，说明部署成功。

● 若有容器启动失败，可点击容器名称查看日志以排查原因。

访问并使用 Immich 相册

1 部署完成后，通过浏览器访问容器，在浏览器地址栏输入http://NAS_IP:2283。例如 NAS 的 IP 是172.17.70.86，在浏览器中输入http://172.17.70.86:2283进行访问。

你可以在“控制面板”中，找到 “网络设置”，点击“网络连接” ，查看 NAS 设备的 IP 地址。

2 创建账户：安装完 im­mich 启动后的第一个用户默认是管理员账户。依次填入邮箱、密码以及名称，点击“注册”按钮完成账户注册。

3 随后，使用刚创建的账户密码完成登录。

4 启用服务前，还需要先做一些通用设置，例如主题、隐私、存储模版（默认禁用）设置等，按需选择后点击完成即可。

● 主题设置：按照提示设置程序的主题，目前只有日 / 夜两种模式可选。

● 隐私设置：按需启用是否进行隐私保护。

● 存储模板配置：功能默认关闭，根据官方文档中关于《存储模板的实现方式 》的解释，开启后可以自定义图片存储结构。

5 存储模板设置完成后，即可进入 im­mich 的用户主界面。您可以选择左侧菜单栏中的对应功能对图片或视频进行分类和整理。例如：

● 在照片选项页，您可以执行上传照片、分享、下载、删除，编辑照片等操作。

● 在相册选项页，您可以执行手动创建相册，编辑或分享相册给他人等操作。

为 Immich 添加外部图库

您还可以添加外部图库，将NAS中存放的照片或之前存放的照片移动到前面在文件管理器中创建的“相册”文件夹，添加外部图库后，Immich 会自动识别。添加步骤如下：

1. 在 Immich 主界面点击右上角头像，选择“管理”，然后点击“外部图库”。

2. 在外部图库界面，点击“创建图库”，选择图库所有者并点击创建。

3. 创建成功后，点击右侧的更多选项按钮，选择“编辑导入路径”。

4. 在弹出的“添加导入路径”窗口中，填入路径：/usr/src/app/外部相册，然后点击“添加”。

5. 添加后，界面显示添加成功的☑图标说明输入正确，继续点击“保存”即可。

6. 添加外部图库成功后，可在 Immich 相册中查看NAS中存放的照片。

为 Immich 安装模型

您可以在 Immich 主界面，点击“管理”>“设置”>“机器学习设置”，查看当前支持的智能模型，或根据个人需求安装模型，更多详情请参考：Immich 官方教程 。

注意：因模型体积较大，需自备代理方便下载。

使用手机端登录并上传和同步照片

使用手机下载 Immich APP ，iOS 和 Android 系统都可以下载。