本文主要是介绍解决TrueNas Scale部署immich后人脸识别失败，后台模型下载异常，immich更换支持中文搜索的CLIP大模型，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！
这个问题搞了我几天终于解决了，搜遍网上基本没有详细针对TrueNas Scale部署immich应用后，CLIP模型镜像下载超时导致人脸识别失败，以及更换支持中文识别的CLIP模型的博客。
分析
现象：TrueNas Scale安装immich官方镜像应用后，导入图片人脸识别失败，中文识别更不行，查看immich-machinelearning pod后台调用日志，显示huggingface.co无法访问，导致下载模型失败。
方案
下载模型文件，手动上传到pod的模型缓存文件夹中，然后设置对应的模型名称，保存后重新识别图片即可。
【关键信息】：TrueNas Scale安装immich应用后mmich-machinelearning pod的模型缓存文件路径为：
/mlcache/clip/与/mlcache/facial-recognition
此方案是上传到pod中CLIP模型文件的缓存目录下，如果pod被销毁需要重新上传覆盖模型文件到缓存目录
1. TrueNas Scale开启SMB共享，为本地文件上传到宿主机做准备，自行下载XLM-Roberta-Large-Vit-B-16Plus以及buffalo_l模型
模型数据对比，感觉XLM-Roberta-Large-Vit-B-16Plus模型好点,支持多语言，包括中文
官方默认的immich-app/ViT-B-32__openai模型只支持英文，这里顺便切换成XLM-Roberta-Large-Vit-B-16Plus模型。
贴下immich的官方镜像站https://huggingface.co/immich-app
国内镜像站:https://hf-mirror.com/immich-app
2. 登录TrueNas Scale后台，进入命令行，切换root账号，上传模型文件到pod中
上传前，确保当前immich没有执行的JOB。
上传模型文件之前：
【重要】选择应用-选择immich-工作负载-选择immich-machine-learning容器的日志图标-打开-查看是否有日志刷新
确认后再执行模型文件推送
执行k3s kubectl cp命令推送到pod
上传XLM-Roberta-Large-Vit-B-16Plus模型（例）:
k3s kubectl cp /mnt/pool/share-folder/SMB/XLM-Roberta-Large-Vit-B-16Plus immich-machinelearning-54969d6cb9-czcdn:/mlcache/clip/ -n ix-immich
变量解释:
- /mnt/pool/share-folder/SMB/XLM-Roberta-Large-Vit-B-16Plus（模型上传到TrueNas中的目录）
- immich-machinelearning-54969d6cb9-czcdn（文件接收pod的名称，重启应用后会变）
- /mlcache/clip/（pod固定路径）
- ix-immich（namespace名称）
同理上传buffalo_l模型:
cp /mnt/pool/share-folder/SMB/buffalo_l immich-machinelearning-54969d6cb9-czcdn:/mlcache/facial-recognition -n ix-immich
3.检查immich-machine-learning pod中是否成功接收到模型文件
应用-选择immich-工作负载-打开immich-machine-learning容器的命令行
进入根目录，查看是否有mlcache文件夹，cd /mlcache进入mlcache文件夹
- clip 存放
XLM-Roberta-Large-Vit-B-16Plus文件夹，对应设置里的CLIP MODEL - facial-recognition 存放
buffalo_l文件夹，对应设置里的FACIAL RECOGNITION MODEL
对应模型文件夹子文件展示：
4.web页面设置切换模型参数，保存
5.重新执行job任务，查看日志，确认是否加载模型文件
重新执行SMART SEARCH与FACE DETECTION任务，重新识别图片。
查看日志确认是否加载
识别成功效果图：
这篇关于解决TrueNas Scale部署immich后人脸识别失败，后台模型下载异常，immich更换支持中文搜索的CLIP大模型的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！
