ghcr.io/xiaoranqingxue/mt-ai-openvino:v1.2 Docker 镜像

ghcr.iolinux/amd64v1.2大小: 542.58 MB更新于 2026年6月21日

让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明

如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。

只需在 AI 对话中先发送下面这句话即可：

请先完整阅读并严格遵守以下文档中的全部规则与要求：

https://xuanyuan.cloud/agents.md

在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。

查看 agents.md 用法指南与完整示范。国内用户首推元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。若 AI 无法访问外链，可打开说明文档复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。

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.7~~0.55，人物匹配差异值建议修改为~~0.5~~0.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

Linux Docker 一键安装

AI

用 AI 使用轩辕镜像

agents.md · AI 对话 · 提示词

Docker

登录仓库拉取

登录认证 · 私有仓库

专属域名拉取

免登录 · 高速拉取

Linux

Docker 镜像配置

Windows / Mac

Docker Desktop 配置

MacOS OrbStack

OrbStack 容器

Apple Container

macOS 原生容器

Docker Compose

Compose 项目配置

NAS

群晖

Synology 配置

飞牛

fnOS 镜像配置

绿联

绿联 NAS

威联通

QNAP 配置

极空间

极空间 NAS

Unraid

Unraid NAS

企业仓库

其他仓库

ghcr · Quay · nvcr

Harbor 镜像源

Proxy Repository 对接

Portainer 镜像源

Registries 配置

Nexus 镜像源

Docker Proxy 缓存

开发工具

Dev Containers

VS Code 开发容器

Podman

Podman 配置指南

Singularity / Apptainer

HPC 科学计算容器

Kubernetes

K8s Containerd

Kubernetes · Containerd

K3s

轻量级集群

面板 / 网络

爱快路由

iKuai 镜像加速

宝塔面板

一键配置镜像源

需要其他帮助？请查看我们的常见问题Docker 镜像访问常见问题解答或提交工单

镜像拉取常见问题

功能

版本功能对比

功能对比 · 版本选择

支持的镜像仓库

Docker Hub · GCR · GHCR

新手拉取配置

docker search 限制

专属域名 · Hub 搜索

不支持 push

仅支持 pull · 不支持

拉取速度原因

带宽 · 缓存 · 冷热镜像

错误码

402 与流量用尽

402 · 流量包 · 充值

401 认证失败

401 · docker login

manifest unknown

标签错误 · 镜像不存在

410 Gone 排查

410 · Docker 升级

429 限流

免费版 · 专业版 · 企业版 · 请求频率

其他报错

DNS 超时

DNS 解析 · 网络超时

TLS 证书失败

no matching manifest（架构）

账号

失败是否计费

manifest · blob · 计费

申请开发票（企业 / 个人）

企业 · 个人 · 工单

修改登录密码

网站 · 仓库 · 重置

注销账户

工单 · 数据 · 注销

原理

mirrors 不生效

daemon.json · 重启

去掉域名前缀

docker tag · 重命名

指定架构拉取

ARM64 · AMD64 · 多架构

latest 与「最新」

digest · 版本号 · 标签

查看全部问题→

用户好评

来自真实用户的反馈，见证轩辕镜像的优质服务

oldzhang

运维工程师

Linux服务器

"Docker访问体验非常流畅，大镜像也能快速完成下载。"

ghcr.io/xiaoranqingxue/mt-ai-openvino:v1.2

MT-AI

本仓库仅为个人学习交流使用，如作他用所承受的***责任一概与作者无关（下载使用即代表你同意上述观点）

！！！ 修复V1.2出现的clip错误 ！！！

docker ENV 说明

脚本说明

实例compose.yaml

实例compose.yaml (iGPU)

v0.9

v1.0

v1.4

注意事项：

效果自测，可联系

项目仓库 README（补充）

MT-AI

本仓库仅为个人学习交流使用，如作他用所承受的***责任一概与作者无关（下载使用即代表你同意上述观点）

！！！ 修复V1.2出现的clip错误 ！！！

docker ENV 说明

脚本说明

实例compose.yaml

实例compose.yaml (iGPU)

v0.9

v1.0

v1.4

注意事项：

效果自测，可联系

轩辕镜像配置手册

一键安装

一键安装 Docker

AI

用 AI 使用轩辕镜像

Docker

登录仓库拉取

专属域名拉取

Linux

Windows / Mac

MacOS OrbStack

Apple Container

Docker Compose

NAS

群晖

飞牛

绿联

威联通

极空间

Unraid

企业仓库

其他仓库

Harbor 镜像源

Portainer 镜像源

Nexus 镜像源

开发工具

Dev Containers

Podman

Singularity / Apptainer

Kubernetes

K8s Containerd

K3s

面板 / 网络

爱快路由

宝塔面板

镜像拉取常见问题

功能

版本功能对比

支持的镜像仓库

新手拉取配置

docker search 限制

不支持 push

拉取速度原因

错误码

402 与流量用尽

401 认证失败

manifest unknown

410 Gone 排查

429 限流

其他报错

DNS 超时

TLS 证书失败

no matching manifest（架构）

账号

！！！修复V1.2出现的clip错误！！！

！！！修复V1.2出现的clip错误！！！