热门搜索:
ghcr.io/xiaoranqingxue/mt-ai-openvino:v1.0
ghcr.iolinux/amd64v1.0大小: 未知更新于 2026年5月23日
MT-AI
本仓库仅为个人学习交流使用，如作他用所承受的***责任一概与作者无关（下载使用即代表你同意上述观点）
使用immich开源的人脸及clip，供个人mt-photos使用
！！！ 修复V1.2出现的clip错误 ！！！
docker ENV 说明
| ENV | 含义 | 默认值 |
|---|---|---|
| FACE_MODEL_NAME | 人脸识别模型 | antelopev2 |
| CLIP_MODEL_NAME | CLIP模型 | XLM-Roberta-Large-Vit-B-16Plus |
| FACE_THRESHOLD | 人脸置信度 | 0.7 |
| MODEL_TTL | 模型卸载间隔(s) | 0 |
| LOG_LEVEL | 日志等级 | ERROR |
| INTEL_DEVICE_NAME | intel设备名 | CPU |
mtphotos中，人脸置信度建议修改为 0.7 0.55，人物匹配差异值建议修改为 0.5 0.35左右！
脚本说明
- 确保已成功配置docker服务
- 请在root权限执行
- 通过
docker ps获取正在运行的mt-photos镜像ID
docker ps
- 参数说明：1. 容器ID， 2. clip服务地址 3. 向量长度，默认640 请按选择的clip模型正确修改
- 执行
./up-im-clip.sh（示例：./up-im-clip.sh 1387079e86ad 192.168.3.4:3003 640）
./up-im-clip.sh 1387079e86ad 192.168.3.4:3003 640
实例compose.yaml
version: "3"
services:
mtphotos:
image: mtphotos/mt-photos:latest
container_name: mtphotos
restart: always
ports:
- 8063:8063
volumes:
- /volume1/docker/mtphotos/config:/config
- /volume1/docker/mtphotos/upload:/upload
- /volume1/photo:/photos
environment:
- TZ=Asia/Shanghai
- LANG=C.UTF-8
depends_on:
- mtphotos_ai
mtphotos_ai:
image: ghcr.io/xiaoranqingxue/mt-ai-cpu:latest
container_name: mt-ai-cpu
restart: always
ports:
- 3003:3003
volumes:
- /volume1/docker/immich/model-cache:/cache
environment:
- API_AUTH_KEY=mt_photos_ai_extra
- FACE_MODEL_NAME=buffalo_l # antelopev2
- CLIP_MODEL_NAME=XLM-Roberta-Large-Vit-B-16Plus
- FACE_THRESHOLD=0.7
- MODEL_TTL=0
- LOG_LEVEL=ERROR
实例compose.yaml (iGPU)
version: "3"
services:
mtphotos:
image: mtphotos/mt-photos:latest
container_name: mtphotos
restart: always
ports:
- 8063:8063
volumes:
- /volume1/docker/mtphotos/config:/config
- /volume1/docker/mtphotos/upload:/upload
- /volume1/photo:/photos
# 个人文件夹路径
environment:
- TZ=Asia/Shanghai
- LANG=C.UTF-8
depends_on:
- mtphotos_ai
mtphotos_ai:
image: ghcr.io/xiaoranqingxue/mt-ai-openvino:latest
container_name: mt-ai-openvino
device_cgroup_rules:
- 'c 189:* rmw'
devices:
- /dev/dri:/dev/dri
restart: always
ports:
- 3003:3003
volumes:
- /dev/bus/usb:/dev/bus/usb
- /volume1/docker/immich/model-cache:/cache
environment:
- DEVICE=/dev/dri/renderD128
- API_AUTH_KEY=mt_photos_ai_extra
- FACE_MODEL_NAME=antelopev2 # antelopev2,buffalo_l
- CLIP_MODEL_NAME=XLM-Roberta-Large-Vit-B-16Plus #nllb-clip-base-siglip__mrl #XLM-Roberta-Large-Vit-B-16Plus
- FACE_THRESHOLD=0.45
- MODEL_TTL=300
- LOG_LEVEL=ERROR
- INTEL_DEVICE_NAME=CPU
v0.9
修复clip/img返回结果中出现的以科学计数法存在的数字
v1.0
功能：同步immich最新代码，增加额外的clip模型
修复：修改脚本中的调整向量长度逻辑，修复v0.9引入的返回结果类型不匹配问题
v1.4
功能：同步immich最新代码
功能：openvino版本增加GPU支持，通过INTEL_DEVICE_NAME传递，默认为CPU，支持GPU、GPU.1（核显效率很差，不如CPU）
注意事项：
- 人脸模型效果未做测试，buffalo_l跟antelopev2都可
mtphotos 默认CLIP向量长度为512，暂时未提供修改长度选项，所有需要执行脚本以修改向量长度（脚本未做大量测试，请自行判断可行性，后果自负）- mtphotos V1.32.2 #82C6E版本提供了自定义CLIP向量长度功能，现在无需使用本脚本，直接修改为正常向量长度即可
未实现 OCR 功能，默认返回"",因为我用不到……增加使用mtphotos自带OCR- OCR有已知内存泄漏问题，暂时无法解决；如果内存较少或长时间运行OCR导致内存溢出，请自行重启服务，或者设置MODEL_TTL参数，定时重启服务
- 只需人脸时，无需执行脚本，直接部署即可
- 不给openvino镜像传入IGPU相关参数时，会自动降级为CPU
效果自测，可联系
项目仓库 README（补充）
MT-AI
本仓库仅为个人学习交流使用，如作他用所承受的***责任一概与作者无关（下载使用即代表你同意上述观点）
使用immich开源的人脸及clip，供个人mt-photos使用
！！！ 修复V1.2出现的clip错误 ！！！
docker ENV 说明
| ENV | 含义 | 默认值 |
|---|---|---|
| FACE_MODEL_NAME | 人脸识别模型 | antelopev2 |
| CLIP_MODEL_NAME | CLIP模型 | XLM-Roberta-Large-Vit-B-16Plus |
| FACE_THRESHOLD | 人脸置信度 | 0.7 |
| MODEL_TTL | 模型卸载间隔(s) | 0 |
| LOG_LEVEL | 日志等级 | ERROR |
| INTEL_DEVICE_NAME | intel设备名 | CPU |
mtphotos中，人脸置信度建议修改为0.70.55，人物匹配差异值建议修改为0.50.35左右！
脚本说明
- 确保已成功配置docker服务
- 请在root权限执行
- 通过
docker ps获取正在运行的mt-photos镜像ID - 参数说明：1. 容器ID， 2. clip服务地址 3. 向量长度，默认640 请按选择的clip模型正确修改
- 执行
./up-im-clip.sh（示例：./up-im-clip.sh 1387079e86ad 192.168.3.4:3003 640）
实例compose.yaml
version: "3"
services:
mtphotos:
image: mtphotos/mt-photos:latest
container_name: mtphotos
restart: always
ports:
- 8063:8063
volumes:
- /volume1/docker/mtphotos/config:/config
- /volume1/docker/mtphotos/upload:/upload
- /volume1/photo:/photos
environment:
- TZ=Asia/Shanghai
- LANG=C.UTF-8
depends_on:
- mtphotos_ai
mtphotos_ai:
image: ghcr.io/xiaoranqingxue/mt-ai-cpu:latest
container_name: mt-ai-cpu
restart: always
ports:
- 3003:3003
volumes:
- /volume1/docker/immich/model-cache:/cache
environment:
- API_AUTH_KEY=mt_photos_ai_extra
- FACE_MODEL_NAME=buffalo_l # antelopev2
- CLIP_MODEL_NAME=XLM-Roberta-Large-Vit-B-16Plus
- FACE_THRESHOLD=0.7
- MODEL_TTL=0
- LOG_LEVEL=ERROR
实例compose.yaml (iGPU)
version: "3"
services:
mtphotos:
image: mtphotos/mt-photos:latest
container_name: mtphotos
restart: always
ports:
- 8063:8063
volumes:
- /volume1/docker/mtphotos/config:/config
- /volume1/docker/mtphotos/upload:/upload
- /volume1/photo:/photos
# 个人文件夹路径
environment:
- TZ=Asia/Shanghai
- LANG=C.UTF-8
depends_on:
- mtphotos_ai
mtphotos_ai:
image: ghcr.io/xiaoranqingxue/mt-ai-openvino:latest
container_name: mt-ai-openvino
device_cgroup_rules:
- 'c 189:* rmw'
devices:
- /dev/dri:/dev/dri
restart: always
ports:
- 3003:3003
volumes:
- /dev/bus/usb:/dev/bus/usb
- /volume1/docker/immich/model-cache:/cache
environment:
- DEVICE=/dev/dri/renderD128
- API_AUTH_KEY=mt_photos_ai_extra
- FACE_MODEL_NAME=antelopev2 # antelopev2,buffalo_l
- CLIP_MODEL_NAME=XLM-Roberta-Large-Vit-B-16Plus #nllb-clip-base-siglip__mrl #XLM-Roberta-Large-Vit-B-16Plus
- FACE_THRESHOLD=0.45
- MODEL_TTL=300
- LOG_LEVEL=ERROR
- INTEL_DEVICE_NAME=CPU
v0.9
修复clip/img返回结果中出现的以科学计数法存在的数字
v1.0
功能：同步immich最新代码，增加额外的clip模型
修复：修改脚本中的调整向量长度逻辑，修复v0.9引入的返回结果类型不匹配问题
v1.4
功能：同步immich最新代码
功能：openvino版本增加GPU支持，通过INTEL_DEVICE_NAME传递，默认为CPU，支持GPU、GPU.1（核显效率很差，不如CPU）
注意事项：
- 人脸模型效果未做测试，buffalo_l跟antelopev2都可
mtphotos 默认CLIP向量长度为512，暂时未提供修改长度选项，所有需要执行脚本以修改向量长度（脚本未做大量测试，请自行判断可行性，后果自负）- mtphotos V1.32.2 #82C6E版本提供了自定义CLIP向量长度功能，现在无需使用本脚本，直接修改为正常向量长度即可
未实现 OCR 功能，默认返回"",因为我用不到……增加使用mtphotos自带OCR- OCR有已知内存泄漏问题，暂时无法解决；如果内存较少或长时间运行OCR导致内存溢出，请自行重启服务，或者设置MODEL_TTL参数，定时重启服务
- 只需人脸时，无需执行脚本，直接部署即可
- 不给openvino镜像传入IGPU相关参数时，会自动降级为CPU
效果自测，可联系
轩辕镜像配置手册
探索更多轩辕镜像的使用方法，找到最适合您系统的配置方式
Docker 配置
登录仓库拉取
通过 Docker 登录认证访问私有仓库
专属域名拉取
无需登录使用专属域名
K8s Containerd
Kubernetes 集群配置 Containerd
K3s
K3s 轻量级 Kubernetes 镜像加速
Dev Containers
VS Code Dev Containers 配置
Podman
Podman 容器引擎配置
Singularity/Apptainer
HPC 科学计算容器配置
其他仓库配置
ghcr、Quay、nvcr 等镜像仓库
Harbor 镜像源配置
Harbor Proxy Repository 对接专属域名
Portainer 镜像源配置
Portainer Registries 加速拉取
Nexus 镜像源配置
Nexus3 Docker Proxy 内网缓存
系统配置
需要其他帮助？请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单
镜像拉取常见问题
使用与功能问题
配置了专属域名后，docker search 为什么会报错？
docker search 限制
Docker Hub 上有的镜像，为什么在轩辕镜像网站搜不到？
站内搜不到镜像
机器不能直连外网时，怎么用 docker save / load 迁镜像？
离线 save/load
docker pull 拉插件报错（plugin v1+json）怎么办？
插件要用 plugin install
WSL 里 Docker 拉镜像特别慢，怎么排查和优化？
WSL 拉取慢
轩辕镜像安全吗？如何用 digest 校验镜像没被篡改？
安全与 digest
第一次用轩辕镜像拉 Docker 镜像，要怎么登录和配置？
新手拉取配置
轩辕镜像合规吗？轩辕镜像的合规是怎么做的？
镜像合规机制
轩辕镜像支持 docker push 上传本地镜像吗？
不支持 push
错误码与失败问题
docker pull 提示 manifest unknown 怎么办？
manifest unknown
docker pull 提示 no matching manifest 怎么办？
no matching manifest（架构）
镜像已拉取完成，却提示 invalid tar header 或 failed to register layer 怎么办？
invalid tar header（解压）
Docker pull 时 HTTPS / TLS 证书验证失败怎么办？
TLS 证书失败
Docker pull 时 DNS 解析超时或连不上仓库怎么办？
DNS 超时
docker 无法连接轩辕镜像域名怎么办？
域名连通性排查
Docker 拉取出现 410 Gone 怎么办？
410 Gone 排查
出现 402 或「流量用尽」提示怎么办？
402 与流量用尽
Docker 拉取提示 UNAUTHORIZED（401）怎么办？
401 认证失败
遇到 429 Too Many Requests（请求太频繁）怎么办？
429 限流
docker login 提示 Cannot autolaunch D-Bus，还算登录成功吗？
D-Bus 凭证提示
为什么会出现「单层超过 20GB」或 413，无法加速拉取？
413 与超大单层
账号 / 计费 / 权限
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"