Immich 任务队列怎么看:上传之后服务器在后台忙什么
照片上传完成不等于「处理完成」。Immich 对每个文件还有一串后台工作要做,理解这套机制,你就明白为什么刚传完两千张照片时搜索没结果、人脸页是空的——不是坏了,是队列还没跑完。
Jobs 页面在哪、长什么样
网页端左侧进入 Administration(管理)→ Job Queues(任务队列)。每个任务类型一张卡片,卡片上显示等待中/活跃/成功的数量,右上角有三个全局按钮:全部暂停、全部恢复、清空失败的。

与每张照片相关的核心任务
元数据提取(Metadata Extraction):读 EXIF——拍摄时间、相机型号、GPS 坐标。时间线的日期分组和 地图地点 都靠它。微信、WhatsApp 等应用转发来的图片经常没有 EXIF,这是「日期显示不对」的常见原因。
缩略图生成:每张照片其实生成三种——模糊占位(thumbhash,加载时的「马赛克」)、Webp 预览、Jpeg 小缩略图。另外每个人脸还会单独生成一张人脸小图。所以「为什么缩略图任务这么多」的答案是:数量本来就是照片数的三四倍。
智能搜索(Smart Search):机器学习容器为每张照片计算语义向量。没跑完这一步,语义搜索 就搜不到对应照片。
人脸识别:先检测人脸,再聚类分组。聚类算法全局生效,所以人脸任务通常要等整批照片处理完,人脸识别一页 有原理详解。
视频转码:把浏览器/手机不兼容的视频格式转一份兼容副本。原图永远不动,转码副本可以按策略删除或重生成。
实用操作节奏
- 大批量导入前:暂停「智能搜索」「人脸识别」「转码」三类任务,先让照片全部传完、缩略图出齐;然后恢复它们,让机器学习在夜里慢慢跑。
- 机器发烫风扇狂转:在管理后台系统设置里可以给任务限流(并发数、机器学习负载),或直接手动暂停不需要的任务。
- 发现某类任务卡住:卡片上会显示失败计数,点进详情能看到具体文件和报错;清空失败后可重跑。