WARNING
本文档由 AI 自动翻译，仅供参考。涉及关键操作或信息时，请以英文原文为准。
将 Immich 上传的照片和视频存储到 NAS
Immich 可以将通过网页或手机应用上传的照片和视频直接保存到 NAS，数据库仍保留在 Olares 中。缩略图、转码视频等生成的媒体文件也会保存到所选目录。
如果你希望浏览 NAS 上已有的照片，而不改变 Immich 的上传位置，请参阅从 NAS 导入照片到 Immich。该教程介绍的是外部图库，与本文的上传存储设置不同。
学习目标
通过本教程，你将学会：
- 将 NAS 文件夹设为 Immich 上传文件的保存位置。
- 在 NAS 与本地存储之间迁移已有媒体库。
- 在 NAS 存储不可用时恢复访问。
准备工作
- 使用 Immich 的 Olares 应用包 1.0.37 (Immich 3.3.5)，或后续提供
UPLOAD_LOCATION配置的版本。如果找不到该配置，说明当前安装包尚不支持此功能。 - 将 Olares 与 NAS 连接到同一网络。
- 准备具有读写权限的 NFS 或 SMB 共享。NFS 共享需允许 UID/GID
1000:1000读写。SMB 共享需使用具有读写权限的 NAS 账户挂载。
建议在首次上传照片前完成配置。如果已经使用 Immich，请先按照迁移已有媒体中的步骤处理原有文件，再修改上传位置。
挂载 NAS 共享目录
打开文件管理器，依次选择 存储、外部设备，然后选择 连接服务器。
选择 NFS，填写共享地址。例如：
text192.168.1.100:/volume1/photos将 IP 地址和共享路径替换为自己的 NAS 配置。使用 SMB 时，选择 SMB，填写
//<NAS-IP>/<共享目录>，并按提示输入具有读写权限的 NAS 账户和密码。完整 NFS 操作步骤请参阅挂载 NFS 共享。选择 确认，检查 外部设备 中显示的共享目录名称。后续步骤以挂载目录名
photos为例。在共享目录中创建名为
immich的空文件夹，并确认可以在其中创建文件。也可以使用其他名称，但上传路径中必须使用相同的名称。
请为 Immich 使用专用目录，将其他 NAS 文件保存在该目录之外。
设置上传位置
打开设置，依次选择 应用、Immich。
在 环境变量 区域，打开 管理环境变量。
选择
UPLOAD_LOCATION的编辑图标，填写媒体目录路径：text/external_storage/photos/immich将
photos替换为文件管理器中显示的挂载目录名，将immich替换为提前创建的专用目录名。使用这一格式的路径，不要填写 NAS 的 IP 地址、NFS 共享地址或 SMB 地址。选择 确认，再选择 应用。运行中的 Immich 会自动重启。如果之前为迁移媒体暂停了 Immich，等待配置应用完成后，返回应用设置并选择 恢复。
UPLOAD_LOCATION 的值 | 上传文件保存位置 |
|---|---|
| 留空 | Olares 中默认的本地媒体目录 |
已存在的 /external_storage/ 下的目录 | 指定的 NFS 或 SMB 目录 |
只需配置这一个变量。NAS 共享本身的挂载和卸载仍在文件管理器中操作。
验证上传结果
- 打开 Immich，上传一张新照片。
- 确认缩略图正常显示，并且可以打开和下载原图。
- 在文件管理器中打开 NAS 上的专用目录，检查
upload或library等子目录中是否出现新文件。
Immich 会管理目录结构和存储文件名，因此 NAS 中的文件名可能与照片详情中显示的原文件名不同。数据库仍使用 Olares 存储。
迁移已有媒体
修改 UPLOAD_LOCATION 只会改变应用使用的媒体目录，不会复制或同步文件。
- 暂停所有已连接设备的上传，等待正在执行的任务完成。在 Immich 运行时，通过管理界面创建数据库备份，并在待迁移媒体目录之外保留一份副本。
- 打开设置，依次选择 应用、Immich，然后选择 暂停。等待 恢复 按钮可用后，再复制文件。
- 备份完整媒体目录。当前应用包的默认本地目录位于文件管理器的 存储、数据 下，路径为
immich/data/upload。 - 将完整媒体目录的内容复制到目标位置，包括隐藏的
.immich文件和所有子目录。比较文件数量、大小和校验值，确认所有原始媒体和生成文件均已复制。 - 按照设置上传位置中的步骤填写目标目录，应用配置后恢复 Immich。
- 确认原有照片可以打开、原图可以下载，并测试一次新上传，再考虑删除旧副本。
目标目录应保持原有媒体结构。配置的路径下应直接包含 upload、library、thumbs、encoded-video、profile、backups 等目录，不要额外嵌套一层。
如果要切回默认本地存储，请按相同步骤备份并暂停 Immich，再将完整媒体目录复制到默认本地目录。清空 UPLOAD_LOCATION，应用配置后恢复 Immich。以后切回 NAS 时，也需要重复这一流程，复制当前的完整媒体目录，包括使用本地存储期间新增的媒体。
NAS 不可用时如何处理
如果配置了 NAS 路径，但启动时目标目录不可用，Immich 将无法启动，不会自动将新文件写入本地。
- 继续使用 NAS：在文件管理器中恢复挂载，确认配置的目录存在且可写。保持
UPLOAD_LOCATION不变，等待应用重试启动。如果 Immich 仍无法访问，请联系支持。 - 改用本地存储：如果 Immich 仍在运行，先暂停应用，再将完整媒体备份恢复到默认本地目录。清空
UPLOAD_LOCATION并应用。如果应用处于暂停状态，选择 恢复。本地模式不依赖 NAS 挂载，但文件尚未恢复的照片仍无法访问。
市场状态可能未同步恢复
恢复 Immich 访问后，Olares 市场可能仍显示失败状态，切换到本地存储后也可能出现这种情况。先检查能否打开 Immich 并访问照片。如果状态仍未更新，请联系支持，不要通过删除图库或数据库来清除错误标记。
了解更多
- 使用 Immich 管理照片：了解 Immich 的初始化和照片管理功能。
- 从 NAS 导入照片到 Immich：将已有 NAS 文件夹添加为外部图库。
- 管理应用环境变量：了解如何在 Olares 设置中修改应用配置。