（4658期）Immich API Connector – 私有云照片管理自动化神器

私有云照片管理自动化神器 连接自托管 Immich 照片服务器的 API 桥接工具，支持照片管理、自动备份、相册操作与用户管理，适合私有云相册自动化场景。 使用说明 核心用法 Immich API Bridge 是面向自托管 Immich 照片管理系统的 REST API 封装技能，允许通过命令行或脚本与私有 Immich 实例交互。核心功能覆盖八大场景：照片与资产管理、相册创建与维护、批量上传下载、用户管理、智能搜索、外部库同步以及后台任务调度。 配置方式灵活，支持环境变量（IMMICHURL、IMMICHAPIKEY）和 CLI 参数两种模式。认证采用简单的 Header Token 机制，通过 x-api-key 传递。内置脚本库（uploadphotos.py、downloadalbum.py、synclibrary.py）可处理批量操作，降低直接使用 curl 的复杂度。 显著优点 完全私有：数据存储于自托管服务器，规避公有云隐私风险 功能完整：覆盖 Immich 官方 API 的全部核心端点，包括缩略图生成、人脸识别、元数据索引等高级特性 自动化友好：支持批量上传、增量同步、定时任务，适合 NAS 或家庭服务器场景 零前端依赖：纯命令行操作，便于集成至 CI/CD 或家庭自动化工作流 潜在局限 自托管门槛：需自行部署 Immich 服务，对服务器配置、反向代理、SSL 证书有一定要求 无图形界面：非技术用户可能需要学习曲线 API 兼容性：Immich 版本迭代较快，存在接口变更风险 错误处理：curl 示例未展示重试、断点续传等健壮性机制 适合人群 拥有 NAS 或私有服务器的家庭用户 注重数据主权、希望替代 Google Photos/iCloud 的隐私敏感用户 需要将照片管理集成至自动化流程的开发者/运维人员 常规风险 密钥泄露：API Key 以明文存储于环境变量，多用户系统需加强权限管控 未加密传输：若未配置 HTTPS，存在中间人攻击风险 版本锁定：建议锁定 Immich 版本并测试后再升级，避免 API 不兼容 原始说明 Connect to self-hosted Immich instances to manage photos, albums, users, search media, upload/download files, and handle jobs via REST API.