Immich 自托管照片和视频管理平台

自托管照片库常见的尴尬是：官方 Android 客户端仍倾向于把媒体交给 Google Photos，多设备备份之后又很难做程序化整理。Immich 这类方案把媒体留在自己的服务器上，但真正落地时，仍然会碰到几个具体问题：谁有权限看哪些相册、人脸识别结果怎么导入导出、搜索能不能不靠文件夹和日期，以及备份任务和资产整理能不能通过 API 写成自动化流程。

核心能力与工作方式

• 自动备份：手机客户端在后台把新增照片和视频推送到自托管服务，减少手动导入和重复存储。
• 人脸识别：在导入或整理阶段提取人脸特征，用人物相册组织内容，而不是只按拍摄地点堆文件夹。
• CLIP 语义搜索：通过 CLIP-based search 支持“海边的日落”“狗在草地上”这类自然语言查询，降低对精确文件名的依赖。
• 元数据提取：读取拍摄时间、相机参数、GPS 等信息，方便按时间线、位置或镜头参数筛选。
• 多用户与权限：为不同家庭成员或协作者分配访问范围，避免所有媒体都暴露给同一个账号。
• REST API：提供程序化媒体管理能力，可以把备份、查询、打标签、整理集合等动作接入脚本或工作流。

关键步骤通常是：客户端触发增量备份 → 服务端完成上传和校验 → 进行元数据解析与人脸/语义索引 → 用户通过 Web 或 API 查询、整理和共享。

适用边界与注意点

• 当前技能资料没有可提取的安装或使用步骤，需要在敏感流程中运行前先 review 上游仓库和项目文档。
• 它的价值依赖 Immich 主项目本身的配置质量，包括存储路径、备份策略、索引计算资源和权限模型。
• 人脸识别和 CLIP 搜索会消耗一定计算资源，适合能承受首次扫描和持续索引开销的自托管环境。
• 如果你需要的是简单的文件夹网盘式备份，这个方案偏重媒体理解和 API 化管理，不一定比通用同步工具更省事。