Immich 中文文档 下载 App

Immich 任务队列怎么看:上传之后服务器在后台忙什么

照片上传完成不等于「处理完成」。Immich 对每个文件还有一串后台工作要做,理解这套机制,你就明白为什么刚传完两千张照片时搜索没结果、人脸页是空的——不是坏了,是队列还没跑完。

Jobs 页面在哪、长什么样

网页端左侧进入 Administration(管理)→ Job Queues(任务队列)。每个任务类型一张卡片,卡片上显示等待中/活跃/成功的数量,右上角有三个全局按钮:全部暂停、全部恢复、清空失败的。

Immich 管理端任务队列总览
每类任务独立计数,可单独暂停或触发

与每张照片相关的核心任务

元数据提取(Metadata Extraction):读 EXIF——拍摄时间、相机型号、GPS 坐标。时间线的日期分组和 地图地点 都靠它。微信、WhatsApp 等应用转发来的图片经常没有 EXIF,这是「日期显示不对」的常见原因。

缩略图生成:每张照片其实生成三种——模糊占位(thumbhash,加载时的「马赛克」)、Webp 预览、Jpeg 小缩略图。另外每个人脸还会单独生成一张人脸小图。所以「为什么缩略图任务这么多」的答案是:数量本来就是照片数的三四倍。

智能搜索(Smart Search):机器学习容器为每张照片计算语义向量。没跑完这一步,语义搜索 就搜不到对应照片。

人脸识别:先检测人脸,再聚类分组。聚类算法全局生效,所以人脸任务通常要等整批照片处理完,人脸识别一页 有原理详解。

视频转码:把浏览器/手机不兼容的视频格式转一份兼容副本。原图永远不动,转码副本可以按策略删除或重生成。

实用操作节奏

任务机制搞清楚后,你可以放心大规模灌照片了——但先确认 数据库备份 已经打开,再读 .env 配置 复查一遍路径规划。