超详细！飞牛fnos使用docker部署immich人脸识别AI相册！无需代码，小小白也能看得懂！

庞胖胖One · 2024-12-26 23:48:43

[i=s] 本帖最后由庞胖胖One 于 2024-12-27 23:15 编辑 [/i]

Immich相册简介

Immich‌是一个开源的照片备份解决方案，类似于Google Photos，但完全免费且具有AI功能。它主要用于家庭服务器（如NAS）上部署，提供照片备份、管理和智能处理功能‌。

功能特点

‌照片备份‌：Immich能够自动备份设备上的照片和视频，确保数据的安全和完整性。 ‌智能管理‌：它具有智能分类和整理功能，可以根据日期、地点等信息自动整理照片和视频。 ‌AI功能‌：Immich支持AI图像处理，包括人脸识别、图像合并、AI美颜和智能编辑等，提升图片质量和管理效率。 ‌多设备同步‌：用户可以在不同的设备上同步照片和视频，实现跨设备访问和管理。 ‌界面友好‌：其用户界面设计美观，操作简便，适合家庭用户使用。

软件图1200.png

官方软件截图

环境准备

已经打开docker服务飞牛系统
已经创建“储存空间”（已经可以存储文件了）
足够大的储存空间，至少4G（其他空间视相册大小而定）
其他：官方推荐的配置是2个核心和4G内存（不强制，就是慢些）

Immich的数据库目录的创建

创建位置：不指定。推荐选用固态硬盘、系统硬盘

打开飞牛【文件管理器】→点击【新建文件夹】→输入文件夹名称点击【确定】

创建文件夹.png

在这里，我创建了3个文件夹（推荐创建三个）

【immich】用于存放软件数据

【手机相册备份】手机上传照片到这里

【相册】原有的相册目录

查看并记录文件夹原始路径：

右键文件夹→点击【详细信息】→【复制原始路径】→记录起来，后面用到

记录文件夹地址.png

我的三个文件夹路径分别是

文件夹名称	文件夹原始路径	备注
immich	/vol1/1000/immich	存放软件数据
手机相册备份	/vol1/1000/手机相册备份	上传目录
相册	/vol1/1000/相册	原有的相册目录

下载并上传所用到的文件（一共2个）

这两个是我修改过的，大家也可以到官网下载（英文）

上传两个文件.png

immich.yml文件保存在电脑

1.env.yml文件上传至【immich】（存放软件数据）文件夹，

下 upload 附件：文章所提到的2个文件.zip

载地址在附件，请自行下载后解压

上传文件OK.png

修改1.env.yml配置文件内容

在文件管理器内，双击打开1.env.yml（编辑里面内容）

编辑文件.png

修改文件1.png 修改完成后，如下图

修改完成.png

重命名1.env.yml配置文件（重要）

将1.env.yml重命名为【.env】，（注意，文件名为.env 带. ）

重命名OK.png

准备工作完成！开始安装！！

打开Docker程序

开始安装.png

开始安装2.png

开始安装，安装速度跟网速有较大关系，可以在以下地方确认是否安装完成

正常构建下载的图.png

安装完成确认.png

问题一：部分启动解决办法

重启容器问题.png

删除immich文件夹，过一会程序会自己新建immich文件夹（存放软件数据的文件夹），并写入数据

Immich_postgres容器就会启动成功，软件就可以正常访问

图片1.png

删除一次后，程序会自动新建immich文件夹，如图所示，3分钟左右就能启动成功

自动重启容器.png

删除immich文件夹后也可以手动重启immich_postgres容器（快那么一点点）

手动重启.png

问题二：构建失败解决办法

①如果构建失败，请查看日志是否有以下字样。

问题原因：Docker镜像服务器被屏蔽，

解决办法：添加修改Docker镜像仓库地址，修改方法如图：

构架失败图：

构建失败2.png

解决办法：添加或修改docker镜像仓库

修改仓库.png

相册的简单使用方法

正式访问.png

创建账户，简单设置后，进入管理页面

添加外部相册

添加已有相册，就是【相册】这个文件夹

自己的照片和以前的照片可以放在这个文件夹里面，相册会自动识别

添加方法：在主界面点击右上角头像

管理.png

添加外部相册.png

点击闯将.png

添加路径.png

使用手机登录，进行上传和同步

手机下载immich的APP ，安卓苹果都可以下载，非公网用户请在内网使用

手机APP登录.png

软件和手机APP都默认中文，而且界面非常友好，大家按照软件上的提示使用就可以了，非常简单

到此教程结束，还需要什么软件的教程，可以帖子底下留言

创建文件来自immich官方文档，主要是翻译了部分内容添加的部分已经做了中文说明，请放心使用 upload 附件：文章所提到的2个文件.zip

庞胖胖One · 2024-12-27 00:02:56

审核得多久哦？

庞胖胖One · 2024-12-28 10:56:15

一定要记得添加外部相册哦！

庞胖胖One · 2024-12-27 10:48:33

赶紧试试吧

dlyangb1 · 2024-12-28 21:14:40

猛猛的，我去试试看~

dlyangb1 · 2024-12-30 08:23:58

请问不能按头像分类，人物页面里提示“找不到人物”该咋弄？

庞胖胖One · 2025-1-1 00:32:24

点击右上角头像→管理→任务里，人脸检查任务打开，打开后，您就可以把人脸进行取名字了，要把同一个人合并在一起，就把名字设置成一样的就可以了

wccici · 2025-1-7 08:57:58

怎么打开硬件加速？我是8代Intel核显？

庞胖胖One · 2025-1-8 23:21:40

这个比较麻烦一些，后续发个帖子详细说

FM2207 · 2025-1-9 11:08:03

好经验，改天试一下。

kingxl · 2025-1-9 16:44:01

如何版本更新操作？

stm · 2025-1-11 13:38:07

对照教程我安装成功了，感谢！

欢乐马_UcGMf · 2025-1-11 23:30:17

顺利安装，感谢lz的分享

q516269179 · 2025-1-12 22:58:45

学习一下

江楓x · 2025-1-13 16:14:04

非常详细感谢分享

leesung · 2025-1-13 16:39:35

本帖最后由醉生梦死[? 于 2025-1-14 00:10 编辑

用安卓app 不知道怎么登陆

quietness · 2025-1-13 21:17:32

在创建项目这里没有看明白，.env这个文件是在那一步添加上的

说谢谢🐏? · 2025-1-16 17:16:32

上传图片还是在UPLOAD_LOCATION 的目录下吧？
WAIBUXIANGCHE_LOCATION 的引用是能看到飞牛相册中的图片。
有方案让这俩相册合成一个么？

欢乐马_LpZxO · 2025-1-17 10:58:53

有那位大佬用webdav挂载做外部图库的吗？都是地址验证失败，求指导。

庞胖胖One · 2025-1-20 00:52:23

放在指定文件夹，会自动添加

庞胖胖One · 2025-1-20 00:53:57

WAIBUXIANGCHE_LOCATION 去掉这个参数或直接使用官方文档，不过要手动上传照片到文件夹

庞胖胖One · 2025-1-20 00:55:10

先挂载本地webdav到本地目录，在WAIBUXIANGCHE_LOCATION=填写挂载的本地目录（提示：挂网盘目录会很慢很慢）

cy2843898 · 2025-1-20 13:50:50

time="2025-01-20T13:48:51+08:00" level=warning msg="The \"UPLOAD_LOCATION\" variable is not set. Defaulting to a blank string."
time="2025-01-20T13:48:51+08:00" level=warning msg="The \"WAIBUXIANGCHE_LOCATION\" variable is not set. Defaulting to a blank string."
time="2025-01-20T13:48:51+08:00" level=warning msg="The \"DB_DATABASE_NAME\" variable is not set. Defaulting to a blank string."
time="2025-01-20T13:48:51+08:00" level=warning msg="The \"DB_PASSWORD\" variable is not set. Defaulting to a blank string."
time="2025-01-20T13:48:51+08:00" level=warning msg="The \"DB_USERNAME\" variable is not set. Defaulting to a blank string."
time="2025-01-20T13:48:51+08:00" level=warning msg="The \"DB_DATA_LOCATION\" variable is not set. Defaulting to a blank string."
invalid spec: :/var/lib/postgresql/data: empty section between colons
Exited:15

说谢谢🐏? · 2025-1-21 14:50:40

庞胖胖One 发表于 2025-1-20 00:53
WAIBUXIANGCHE_LOCATION 去掉这个参数或直接使用官方文档，不过要手动上传照片到文件夹 ...

嗯嗯，我现在飞牛相册也有一点图，后来改主要用Immich，懒得导出在导入了

珍玖汇 · 2025-1-21 20:13:29

按照楼主的教程安装immich, 一路很顺利完成，将照片导入“相册”目录里，可以正常查看，但是无法进行人脸识别，不知道是什么问题？有大侠可以做到相册人脸识别的吗？请赐教！

lsyfj@126.com · 2025-1-21 21:27:28

一样,构建不成功

Amperage · 2025-1-22 10:28:27

根据您提供的容器日志和检查服务的反馈，我们可以进行以下分析和解决步骤：
分析日志
日志中显示多次尝试下载检测模型 buffalo_l，但都失败了。错误信息为：
LocalEntryNotFoundError: An error happened while trying to locate the files on the Hub and we cannot find the appropriate snapshot folder for the specified revision on the local disk. Please check your internet connection and try again.
这表明在尝试从 Hugging Face Hub 下载模型时出现了问题，可能是由于网络连接问题或模型路径不正确。

同样问题，问了kimi ，但是还没解决。

珍玖汇 · 2025-1-22 16:22:15

模型路径是安装文件里固定好的了，能不能修改一个有效的路径或者换一个大模型？

´連椄ф簖 · 2025-1-22 20:10:13

一样的不明白怎么回事，楼主也没看到这个问题？

kunihiko · 2025-1-22 20:37:55

顺利安装，感谢分享

FM2207 · 2025-1-23 11:12:31

镜像太慢了，大佬有推荐的国内可用的吗？

LOTTEN · 2025-1-24 08:59:23

这个跟飞牛刚刚更新的AI人脸识别有什么优势吗

庞胖胖One · 2025-1-29 16:46:56

检查是否已经将文件.env进行重命名

等。。。。。。 · 2025-2-27 22:12:54

国内这网络，模型当然无法自动拉去，去镜像站手动拉取然后上传

一沙一世界 · 2025-3-3 10:12:06

人脸识别还需要手动设置吗？

米其林 · 2025-3-8 19:23:57

#这里是外部相册
WAIBUXIANGCHE_LOCATION=/vol1/1000/相册和添加外部相册步骤中填的路径：/usr/src/app/外部相册八杆子打不着，都不同，我按这个来，外部路径识别不了啊？是不是教程有问题啊？

Jackxwb · 2025-3-17 18:33:53

[i=s] 本帖最后由 Jackxwb 于 2025-3-17 18:37 编辑 [/i]

想问下如何替换模型？

自己下载了模型丢进去，不能识别，还是会去hf下载

目录结构

.
**── clip
**   **── antelopev2
**   **   **── detection
**   **   **   **── fp16
**   **   **   **   **── model.armnn
**   **   **   **── model.onnx
**   **   **   **── rknpu
**   **   **       **── rk3566
**   **   **       **   **── model.rknn
**   **   **       **── rk3568
**   **   **       **   **── model.rknn
**   **   **       **── rk3576
**   **   **       **   **── model.rknn
**   **   **       **── rk3588
**   **   **           **── model.rknn
**   **   **── README.md
**   **   **── recognition
**   **   **   **── fp16
**   **   **   **   **── model.armnn
**   **   **   **── model.armnn
**   **   **   **── model.onnx
**   **   **   **── rknpu
**   **   **       **── rk3566
**   **   **       **   **── model.rknn
**   **   **       **── rk3568
**   **   **       **   **── model.rknn
**   **   **       **── rk3576
**   **   **       **   **── model.rknn
**   **   **       **── rk3588
**   **   **           **── model.rknn
**   **   **── url.txt
**   **── XLM-Roberta-Large-Vit-B-16Plus
**       **── config.json
**       **── README.md
**       **── textual
**       **   **── LinearTransformation.weight
**       **   **── model.onnx
**       **   **── onnx__MatMul_2826
**       **   **── onnx__MatMul_2832
< 此次省略同目录一大批文件 >
**       **   **── onnx__MatMul_3423
**       **   **── onnx__MatMul_3424
**       **   **── onnx__MatMul_3425
**       **   **── rknpu
**       **   **   **── rk3566
**       **   **   **   **── model.rknn
**       **   **   **── rk3568
**       **   **   **   **── model.rknn
**       **   **   **── rk3576
**       **   **   **   **── model.rknn
**       **   **   **── rk3588
**       **   **       **── model.rknn
**       **   **── sentencepiece.bpe.model
**       **   **── special_tokens_map.json
**       **   **── tokenizer_config.json
**       **   **── tokenizer.json
**       **   **── transformer.embeddings.position_embeddings.weight
**       **   **── transformer.embeddings.word_embeddings.weight
**       **   **── transformer.encoder.layer.0.intermediate.dense.bias
**       **   **── transformer.encoder.layer.10.intermediate.dense.bias
**       **   **── transformer.encoder.layer.11.intermediate.dense.bias
**       **   **── transformer.encoder.layer.12.intermediate.dense.bias
**       **   **── transformer.encoder.layer.13.intermediate.dense.bias
**       **   **── transformer.encoder.layer.14.intermediate.dense.bias
**       **   **── transformer.encoder.layer.15.intermediate.dense.bias
**       **   **── transformer.encoder.layer.16.intermediate.dense.bias
**       **   **── transformer.encoder.layer.17.intermediate.dense.bias
**       **   **── transformer.encoder.layer.18.intermediate.dense.bias
**       **   **── transformer.encoder.layer.19.intermediate.dense.bias
**       **   **── transformer.encoder.layer.1.intermediate.dense.bias
**       **   **── transformer.encoder.layer.20.intermediate.dense.bias
**       **   **── transformer.encoder.layer.21.intermediate.dense.bias
**       **   **── transformer.encoder.layer.22.intermediate.dense.bias
**       **   **── transformer.encoder.layer.23.intermediate.dense.bias
**       **   **── transformer.encoder.layer.2.intermediate.dense.bias
**       **   **── transformer.encoder.layer.3.intermediate.dense.bias
**       **   **── transformer.encoder.layer.4.intermediate.dense.bias
**       **   **── transformer.encoder.layer.5.intermediate.dense.bias
**       **   **── transformer.encoder.layer.6.intermediate.dense.bias
**       **   **── transformer.encoder.layer.7.intermediate.dense.bias
**       **   **── transformer.encoder.layer.8.intermediate.dense.bias
**       **   **── transformer.encoder.layer.9.intermediate.dense.bias
**       **── url.txt
**       **── visual
**           **── model.onnx
**           **── preprocess_cfg.json
**           **── rknpu
**               **── rk3566
**               **   **── model.rknn
**               **── rk3568
**               **   **── model.rknn
**               **── rk3576
**               **   **── model.rknn
**               **── rk3588
**                   **── model.rknn
**── immich - hf - url.txt
**── out.txt

30 directories, 206 files

immich_machine_learning 容器的启动日志

Initializing Immich ML v1.129.0
[03/17/25 17:56:24] INFO     Starting gunicorn 23.0.0                     
[03/17/25 17:56:24] INFO     Listening at: http://[::]:3003 (9)           
[03/17/25 17:56:24] INFO     Using worker: app.config.CustomUvicornWorker   
[03/17/25 17:56:24] INFO     Booting worker with pid: 10                  
[03/17/25 17:56:51] INFO     Started server process [10]                  
[03/17/25 17:56:51] INFO     Waiting for application startup.             
[03/17/25 17:56:51] INFO     Created in-memory cache with unloading after 300s  
                             of inactivity.                               
[03/17/25 17:56:51] INFO     Initialized request thread pool with 4 threads.  
[03/17/25 17:56:51] INFO     Application startup complete.                
[03/17/25 17:59:40] INFO     Downloading detection model 'antelopev2'. This may 
                             take a while.                                
[03/17/25 18:01:51] WARNING  Failed to load detection model 'antelopev2'.   
                             Clearing cache.                              
[03/17/25 18:01:51] WARNING  Attempted to clear cache for model 'antelopev2',   
                             but cache directory does not exist           
[03/17/25 18:01:51] INFO     Downloading detection model 'antelopev2'. This may 
                             take a while.                                
[03/17/25 18:04:02] ERROR    Exception in ASGI application                

                             ╭─────── Traceback (most recent call last) ───────╮
                             ** /opt/venv/lib/python3.11/site-packages/urllib3/ **
                             ** connection.py:203 in _new_conn                  **
                             **                                                 **
                             **   200 **   **   :return: New socket connection.   **
                             **   201 **   **   """                               **
                             **   202 **   **   try:                              **
                             ** ❱ 203 **   **   **   sock = connection.create_conn **
                             **   204 **   **   **   **   (self._dns_host, self.por **
                             **   205 **   **   **   **   self.timeout,             **
                             **   206 **   **   **   **   source_address=self.sourc **
                             **                                                 **
                             ** /opt/venv/lib/python3.11/site-packages/urllib3/ **
                             ** util/connection.py:85 in create_connection      **
                             **                                                 **
                             **    82 **                                         **
                             **    83 **   if err is not None:                   **
                             **    84 **   **   try:                              **
                             ** ❱  85 **   **   **   raise err                     **
                             **    86 **   **   finally:                          **
                             **    87 **   **   **   # Break explicitly a referenc **
                             **    88 **   **   **   err = None                    **
                             **                                                 **
                             ** /opt/venv/lib/python3.11/site-packages/urllib3/ **
                             ** util/connection.py:73 in create_connection      **
                             **                                                 **
                             **    70 **   **   **   **   sock.settimeout(timeout)  **
                             **    71 **   **   **   if source_address:            **
                             **    72 **   **   **   **   sock.bind(source_address) **
                             ** ❱  73 **   **   **   sock.connect(sa)              **
                             **    74 **   **   **   # Break explicitly a referenc **
                             **    75 **   **   **   err = None                    **
                             **    76 **   **   **   return sock                   **
                             ╰─────────────────────────────────────────────────╯
                             OSError: [Errno 101] Network is unreachable  

                             The above exception was the direct cause of the  
                             following exception:

看其他的教程里说，需要在 cache 目录下面创建一个 clip 目录，我也创建了，所有文件权限777，但还是识别不出来。模型文件是用git下载的，除了 .git 文件外都复制进去了

Jackxwb · 2025-3-17 19:23:46

搞明白了

clip里放智能搜索相关的模型

facial-recognition里面放人脸识别模型

微信用_UiN96 · 2025-3-21 01:10:13

感觉飞牛ai相册的智能识别-增强模型比immich的要好很多，有办法让immich使用飞牛的模型吗

15841686035 · 2025-3-23 20:15:17

总是验证路径失败，这里应该怎么填写

15841686035 · 2025-3-23 20:22:56

15841686035 发表于 2025-3-23 20:15
总是验证路径失败，这里应该怎么填写

哦知道了原来是输入和楼主一样的路径：/usr/src/app/外部相册，如果自己挂在飞牛上的移动硬盘或者其他存储路径里面的照片怎么添加进来？

15841686035 · 2025-3-23 20:57:45

为了把自己挂在飞牛上的移动硬盘或者其他存储路径里面的照片添加进来，我想修改一下路径，结果都失败。这是因为权限问题还是什么，难道要重新安装部署immich，在那个.env 里重新设置目录吗，还是应该有其他设置方式。

lipengju530 · 2025-3-25 22:32:46

楼主能否教一下有更新时如何更新，官网只看到了命令行的方案，还是您写的教程简单易懂。

yhaa · 2025-4-6 23:43:57

有点搞笑，原来不是加后缀，而是改名为“.env”

yhaa · 2025-4-6 23:44:58

env_file:
- .env

飘尘 · 2025-4-7 17:04:30

非常详尽教程，谢谢

jimo · 2025-4-7 22:28:38

请问有办法在安装哪里不用魔法也很快嘛？或者直接下载好的？

jimo · 2025-4-8 09:47:57

15841686035 发表于 2025-3-23 20:57
为了把自己挂在飞牛上的移动硬盘或者其他存储路径里面的照片添加进来，我想修改一下路径，结果都失败。这是 ...

请问解决了吗？同问

奶白菜 · 2025-4-19 13:55:57

请问安装好但是无法创建管理员账户是为什么有人知道吗

梁钰x · 2025-5-10 23:01:51

庞胖胖One 发表于 2025-1-29 16:46
检查是否已经将文件.env进行重命名

一样的报错，有人解决了吗。重命名的文件名是11.env

		自动登录	找回密码
密码			立即注册

超详细！飞牛fnos使用docker部署immich人脸识别AI相册！无需代码，小小白也能看得懂！

Immich相册简介

功能特点

环境准备

Immich的数据库目录的创建

打开飞牛【文件管理器】→点击【新建文件夹】→输入文件夹名称点击【确定】

查看并记录文件夹原始路径：

右键文件夹→点击【详细信息】→【复制原始路径】→记录起来，后面用到

下载并上传所用到的文件（一共2个）

载地址在附件，请自行下载后解压

修改1.env.yml配置文件内容

重命名1.env.yml配置文件（重要）

准备工作完成！开始安装！！

开始安装，安装速度跟网速有较大关系，可以在以下地方确认是否安装完成

问题一：部分启动 解决办法

问题二：构建失败解决办法

解决办法：添加或修改docker镜像仓库

相册的简单使用方法

添加外部相册

使用手机登录，进行上传和同步

本帖子中包含更多资源

点评

点评

点评

点评

点评

点评

点评

点评

点评

点评

点评

点评

点评

点评

本帖子中包含更多资源

本帖子中包含更多资源

点评

本帖子中包含更多资源

点评

点评

问题一：部分启动解决办法