Immich分内置上传库（网页/APP点上传） 和外部库External Library（直接读NAS文件夹里的图片）
-
✅ 如果是【外部库】（直接挂载NAS目录给immich读文件）
-
右上角点你的头像 → Administration（管理）
-
左侧菜单打开 External Libraries（外部库）
-
找到你对应的库，点右边三点菜单：
- Scan New Library Files：只扫描新增文件（推荐，速度快）
- Re-scan All Library Files：扫描全部，检查修改过的旧文件
-
去
Jobs（任务队列）看后台任务：会依次跑库扫描、生成缩略图、提取元数据，跑完照片就出来了
⚠️ 前提：compose里已经把NAS照片目录正确挂载进immich-server容器，路径匹配，权限可读；群晖Container Manager部署一定要提前建好目录再绑定挂载。
- ✅ 如果是【普通上传库】（网页右上角那个「上传」按钮传进去的） 这种模式不需要手动扫描：网页/APP上传完直接入库。 如果你是把文件直接丢到immich内置data目录里，不推荐这么干，immich不会自动识别，这种只能走外部库方案。
自动定时扫描（不用每次手动点）
管理后台 → Settings（设置）→ Library，配置定时cron周期，自动定期扫描外部库，适合NAS静态相册目录
注意：网络挂载目录（SMB/NFS）的inotify文件监控基本不可靠，自动监听容易失效，只能靠定时扫描，官方标注是实验性功能
排查常见踩坑（群晖DSM部署高频问题）
- 挂载路径写错：docker内路径和外部库填写路径必须严格一致，大小写敏感
- 权限：immich容器内的用户没有读NAS照片文件夹权限，会扫描不到
- 挂载只读
:ro没问题，外部库本来就建议只读，immich不会改动原文件