alangrainger/immich-person-to-album Docker Image Overview

alangrainger/immich-person-to-album

alangrainger

自动将人物（人脸）添加到相册并保持相册更新，支持分享给其他用户，可创建组合相册并支持多Immich用户API密钥管理。

1 次收藏下载次数: 0状态：社区镜像维护者：alangrainger仓库类型：镜像最近更新：6 个月前

轩辕镜像，不浪费每一次拉取。点击查看

中文简介版本下载

轩辕镜像，不浪费每一次拉取。点击查看

Immich 自动人物相册管理

官方文档仓库：[***]

镜像概述和主要用途

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

核心功能和特性

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

使用场景和适用范围

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

使用方法和配置说明

Docker-compose配置

首先复制项目的docker-compose.yml文件，配置方式有以下两种：

方法一：使用`config.json`文件

在docker-compose.yml所在目录创建/data/文件夹
将项目的config.json示例文件复制到data文件夹
根据需求编辑config.json文件

方法二：内联配置

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

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