Immich 外部图库功能支持通过文件目录挂载方式，将现有图片/视频资源整合至服务中，实现分散媒体文件的集中管理和自动化同步。

文件路径映射配置：

  1. ‌环境变量设置‌

在 .env 文件中添加：

EXTERNAL_PATH=/你nas外部图库路径
  1. ‌Docker 容器配置‌

修改 docker-compose.yml 中 immich_server 服务的卷映射：

services:
  immich_server:
    volumes:
      - ${EXTERNAL_PATH}:/usr/src/app/external

  1. ‌重启服务‌：

    docker compose up -d

系统界面配置

  1. ‌进入管理界面‌：

Immich 主页 → 用户头像 → [管理] → [外部图库]

  1. ‌创建外部图库‌

点击【创建图库】
通过三点菜单选择【编辑导入路径】
点击【添加路径】并输入容器内路径：

/usr/src/app/external

确认保存配置

三、运行效果

  1. ‌在[外部图库]管理界面选择[扫描所有图库]

系统启动后台扫描（耗时取决于文件数量）

  1. ‌访问图库内容‌

导航至【图库】页面查看已索引文件
支持按时间/地点/人物等多维度浏览

注意事项

  1. ‌路径权限要求‌

确保 Docker 容器对 NAS 路径有读取权限（建议设置 UID/GID 映射）

  1. ‌同步机制说明‌

增量同步：仅扫描新增/修改文件
同步周期：默认每6小时自动检查（可自定义）

  1. ‌文件格式支持‌

支持标准图片/视频格式（JPG/PNG/MP4/MOV 等），RAW 文件需验证兼容性

应用场景建议

  1. ‌家庭媒体归档‌

整合各设备备份目录到统一视图

  1. ‌摄影作品管理‌

保持原始目录结构的同时实现可视化浏览

  1. ‌多用户协作‌

通过外部库共享团队创作素材

提示：外部图库文件保持原始存储位置，Immich 仅建立索引关系不迁移文件。
参考：https://immich.app/docs/guides/external-library