最新爆文 2024-11-15 1.36K

docker部署Immich AI照片相册管理工具从安装到配置完成详细保姆级教程

前言

家庭相册管理一直是我们日常生活的需求，不论是为了缓解“岌岌可危”的手机容量，还是打造家庭、儿童成长相册，或者是对摄影图片进行保存、汇总，都不可避免的需要接触到种类繁多的数码相册软件。

一般来说，苹果用户会选择icloud作为手机存储和管理工具，安卓用户则会选择google photos，也有一部分用户选择网盘工具来管理和上传照片，虽然方便，但是却有几个缺点。一个是相册上云，隐私不在；二是存储越来越多，费用越来越高。

那么，如何避免这些问题呢？答案很简单，那就是自建免费的相册管理工具，让全家的照片统统存在NAS或电脑里。

一.开源相册怎么选？

目前主流的开源相册分别是immich、photoprism、ente、荔枝、piwigo等。这里主要可以拿来说一下的就是immich、photoprism、ente三款，剩下的比较简易和轻量化，适合照片数量不多的人使用。

🔶Photoprism：

在几年前photoprism用的人还是挺多的，和immich可以一较上下，虽然支持AI分类、搜索，但是不支持clip，导致使用人数已经越来越低了，而且其亚洲人脸识别率很低。

🔶Ente：

Google Photos的模仿者，拥有端对端加密的特点，本身可以看作是一款商用软件，支持空间付费等。不过成也萧何败也萧何，端对端加密让应用几乎无法和其它应用去联动，所以对于个人用户而言，反而不是很友好。

🔶Immich：

开源相册系统中的T0，也几乎是用户的唯一选择。7月19日，immich宣布了关于软件收费的公告，不过说收费，更多的应该是捐赠后给予一个身份认证的意思，就算普通用户不捐赠，依旧可以无偿使用immich的所有服务。

之后，immich新版本中，在左下角增加了未经授权的字样，虽然这个未经授权不是强制的，但是让用户感觉很不舒服，于是有大佬给出了自定义CSS修改方案，同时，这个决定这让开发团队在github上被狠狠的吐槽了一番。

不过好的是，immich听取了社区的意见，在随后的更新中决定取消未授权字样。目前最新的v1.111版本中，已经完全没有相关提示了。

本文基于immich最新v1.111.0版本，重新介绍如何安装这一套开源相册管理工具，并且通过一系列的DIY手段，解决外部存储、中文Clip、人脸识别、显卡转码加速、中文地图等等问题。

二、Immich系统部署方法

1、导入镜像

如果无法访问docker下载地址的，可以通过本网盘下载镜像压缩包（exe格式），解压为tar格式以后上传至NAS的自定义路径。然后通过NAS的镜像导入功能导入，或通过ssh输入以下指令导入

阿里：/kK4M9gHgFz7

提取码: tr40

# path代表真实路径，XXX.tar代表镜像压缩包

docker load -i /path/XXXX.tar

2、compose代码

🔻新建文件夹路径/volume1/docker/immich，在目录下新建或上传【docker-compose.yml】文件，复制compose代码并修改

version: “3.8”

name: immich

services:

immich-server:

container_name: immich_server

image: ghcr.io/immich-app/immich-server:${IMMICH_VERSION:-release}

volumes:

– ${UPLOAD_LOCATION}:/usr/src/app/upload

# 如果怕修改原有照片，最后加上ro，否则删除ro

– ${PHOTOS_LOCATION}:/usr/src/app/external:ro

– /etc/localtime:/etc/localtime:ro

env_file:

– .env

ports:

– 2283:3001

depends_on:

– redis

– database

restart: always

immich-machine-learning:

container_name: immich_machine_learning

# 不同硬件可以在镜像后增加[armnn, cuda, openvino] 标签，比如支持cuda的独立显卡加速，可以为 ${IMMICH_VERSION:-release}-cuda

image: ghcr.io/immich-app/immich-machine-learning:${IMMICH_VERSION:-release}

# 下面的代码开启核显转码加速

# devices:

# – /dev/dri:/dev/dri

volumes:

# 这个目录存放AI模型

– /volume1/docker/immich/model:/cache

restart: always

redis:

container_name: immich_redis

image: library/redis:6.2-alpine

restart: always

database:

container_name: immich_postgres

image: tensorchord/pgvecto-rs:pg14-v0.2.0

environment:

POSTGRES_PASSWORD: ${DB_PASSWORD}

POSTGRES_USER: ${DB_USERNAME}

POSTGRES_DB: ${DB_DATABASE_NAME}

POSTGRES_INITDB_ARGS: ‘–data-checksums’

volumes:

#自定义data位置

– ${DB_DATA_LOCATION}:/var/lib/postgresql/data

restart: always

command: [“postgres”, “-c” ,”shared_preload_libraries=vectors.so”, “-c”, ‘search_path=”$$user”, public, vectors’, “-c”, “logging_collector=on”, “-c”, “max_wal_size=2GB”, “-c”, “shared_buffers=512MB”, “-c”, “wal_compression=on”]

🔻同一个路径下，增加【.env】文件，代码如下

TZ=Asia/Shanghai

IMMICH_VERSION=release

HF_ENDPOINT=https://hf-mirror.com

# 自定义的上传照片存放路径，群晖需要先创建好

UPLOAD_LOCATION=./library

# 自定义的数据库存放路径，群晖需要先创建好

DB_DATA_LOCATION=./postgres

# 自定义的外部库存放路径

PHOTOS_LOCATION=/volume1/homes/name/Photos/

# 下面修改数据库账号密码等信息

DB_PASSWORD=postgres

DB_USERNAME=postgres

DB_DATABASE_NAME=immich

3、各NAS系统部署项目方法

方法一：通用SSH部署compose（NAS、服务器、PC通用）

# 来到文件夹目录

cd /volume1/docker/容器名/

# 启动容器

docker-compose up -d

方法二：群晖部署compose

打开Container Manager，选择项目，点击新建，选择路径，点击下一步即可

方法三：威联通部署compose

打开Container Station，选择【应用程序】，点击【创建】，将代码复制进去，点击验证后部署即可

方法四：铁威马部署compose

打开Docker Manager，选择【项目】，点击【+】，选择文件路径以后，填入代码即可

三、Immich完整版配置方法

Storage Template功能建议大家不要开启，这样可以保持原有的文件格式。

首先我们来切换中文界面，点击右上角账号，选择【Account Settings】-【Language】，把【English】切换成【Chinese (Simplified)】

一、外部库解决群晖重复照片问题

接着，我们来引入外部图库，即原来通过其它方式传入NAS的图片，我们都可以将它们引入为immich的外部图库，进行集中管理。

点击新建图库最右侧的【…】，选择【编辑导入路径】，然后把我们在compose代码里设置的容器内路径填入，比如本文中的【/usr/src/app/external】。

完成以后，针对群晖用户，点击【扫描设置】，填入【**/SYNOPHOTO_*.** 】、【**/@eaDir/*】等等，这个是群晖photos默认生成的缩略图、缩略视频。如果不排除，immich会把群晖的低质量照片扫描4份左右，而且无法通过重复文件删除，特别麻烦。其它系统可以根据自定义忽略内容，比如、【**/tmp/*】。