alangrainger/immich-person-to-album

Immich 自动人物相册管理

官方文档仓库：https://github.com/alangrainger/immich-person-to-album

镜像概述和主要用途

该镜像用于自动将人物（人脸）添加到指定相册并保持相册内容实时更新。通过此工具，用户可将自动生成的人物相册分享给其他用户（例如，创建孩子的共享相册）。支持将任意人脸/人物添加到任意相册，例如创建自动更新的"家庭"相册。同时支持多个Immich用户的API密钥，单个Docker容器可处理多用户的自动相册管理需求。

核心功能和特性

• 自动相册更新：自动将指定人物的照片添加到目标相册并保持内容最新
• 灵活的人物-相册关联：可将任意人物关联到任意相册，支持创建组合相册（如"家庭"相册）
• 多用户支持：支持配置多个Immich用户的API密钥，统一管理多用户的自动相册
• 定时任务：可通过配置定时规则（Cron表达式）自动执行更新任务

使用场景和适用范围

• 家庭照片管理：创建包含所有家庭成员的自动更新相册
• 共享相册：将孩子或特定人物的照片自动同步到共享相册，方便亲友查看
• 多用户环境：在家庭或团队中，集中管理多个用户的自动人物相册

使用方法和配置说明

Docker-compose配置

首先复制项目的https://github.com/alangrainger/immich-person-to-album/blob/main/docker-compose.yml%E6%96%87%E4%BB%B6%EF%BC%8C%E9%85%8D%E7%BD%AE%E6%96%B9%E5%BC%8F%E6%9C%89%E4%BB%A5%E4%B8%8B%E4%B8%A4%E7%A7%8D%EF%BC%9A

方法一：使用config.json文件

1. 在docker-compose.yml所在目录创建/data/文件夹
2. 将项目的https://github.com/alangrainger/immich-person-to-album/blob/main/data/config.json.example%E5%A4%8D%E5%88%B6%E5%88%B0%60data%60%E6%96%87%E4%BB%B6%E5%A4%B9
3. 根据需求编辑config.json文件

方法二：内联配置

在docker-compose.yml文件中直接内联配置：

yaml
services:
  immich-person-to-album:
    image: docker.xuanyuan.run/alangrainger/immich-person-to-album:latest
    container_name: immich-person-to-album
    restart: always
    volumes:
      - ./data:/data
    environment:
      CONFIG: |
        {
          "immichServer": "http://192.168.0.20:2283",  # Immich服务器地址
          "schedule": "*/30 * * * *",  # 定时任务规则（每30分钟执行一次）
          "users": [  # 用户配置列表
            {
              "apiKey": "",  # 用户的Immich API密钥
              "personLinks": [  # 人物-相册关联列表
                {
                  "description": "Photos of Joe",  # 描述信息
                  "personId": "Joe's person ID",  # 人物ID
                  "albumId": "Shared album ID"  # 目标相册ID
                }
              ]
            }
          ]
        }

创建API密钥

1. 在桌面端打开Immich
2. 点击个人头像
3. 选择账户设置
4. 进入API密钥页面
5. 点击新建API密钥
6. 输入密钥名称
7. 添加权限：asset.read（读取资产）和albumAsset.create（创建相册资产）
8. 点击创建
9. 复制生成的API密钥并填入配置文件

获取人物ID和相册ID

人物ID获取

• 进入Immich → 探索 → 人物 → 点击目标人物
• 从URL中复制ID，例如URL：http://your-server/people/f3437c84-83f9-4e84-9640-0dcd12efd08e
• 人物ID为：f3437c84-83f9-4e84-9640-0dcd12efd08e

相册ID获取

• 进入Immich → 相册 → 点击目标相册
• 从URL中复制ID，例如URL：http://your-server/albums/ff85e8c5-32e6-49e0-a0ad-e4dd7ef66bce
• 相册ID为：ff85e8c5-32e6-49e0-a0ad-e4dd7ef66bce

致谢

感谢https://github.com/ajb3932/immich-partner-sharing%E6%8F%90%E4%BE%9B%E7%9A%84%E5%88%9B%E6%84%8F%E5%92%8C%E9%83%A8%E5%88%86%E6%96%87%E6%A1%A3%E5%86%85%E5%AE%B9%E3%80%82