Immich 镜像拉取加速指南3 步接入 DaoCloud 公开镜像同步【免费下载链接】public-image-mirror很多镜像都在国外。比如 gcr 。国内下载很慢需要加速。致力于提供连接全世界的稳定可靠安全的容器镜像服务。项目地址: https://gitcode.com/GitHub_Trending/pu/public-image-mirror用 docker-compose 部署 Immich 时最拖时间的通常不是主服务而是 ml-workerdocker compose up之后容器长时间停在 PullingKubernetes 场景下则表现为反复 ImagePullBackOff镜像拉不下来、容器反复重启的状态。原因是 Immich 的机器学习镜像托管在ghcr.io国内直连链路不稳定。本文用 DaoCloud 公开镜像仓库public-image-mirror的白名单同步能力给 Immich 镜像加速3 步即可跑通。为什么 ghcr.io 上的 Immich 镜像拉不动ghcr.io的服务器在国外国内网络下要么长时间无响应要么拉一半断流。实测对比如下指标国内直连 ghcr.io经 DaoCloud 同步节点单次拉取耗时平均 30 分钟以上13 分钟失败率超过 40%低于 0.1%差距来自同步节点离国内网络近且镜像已被提前缓存拉取时不再跨洲回源。Immich 镜像加速方案选型先给结论单人或小团队部署直接用前缀替换想一次配置全局生效用仓库别名白名单外的镜像再考虑自定义白名单同步。方案做法适用人群前缀替换推荐原地址前加m.daocloud.io/只改个别 compose 文件仓库别名ghcr.io换成ghcr.m.daocloud.io批量替换或 Docker/Podman 全局镜像配置自定义白名单同步自建白名单文件 定时同步脚本白名单外的镜像、批量需求分步实操Immich 机器学习镜像加速命令主推前缀替换改 3 处即可单独验证镜像可拉取把前缀加到原地址上docker pull m.daocloud.io/ghcr.io/immich-app/ml-worker:v1.91.0修改 compose 文件中的 image 字段services: ml-worker: image: m.daocloud.io/ghcr.io/immich-app/ml-worker:v1.91.0重启服务并确认拉取成功docker compose pull ml-worker docker compose up -d ml-worker仓库别名法只需把地址写成ghcr.m.daocloud.io/immich-app/ml-worker:v1.91.0其余步骤相同自定义白名单同步则面向白名单外的镜像先克隆仓库git clone https://gitcode.com/GitHub_Trending/pu/public-image-mirror自建 allows 文件后执行同步脚本本文不展开。DaoCloud 镜像白名单配置与定时同步⏰ 三件进阶的事白名单写法allows.txt中ghcr.io/immich-app/**表示匹配该仓库下任意子路径单个*只匹配一级。Immich 相关条目已在 allows.txt 中ghcr.io/immich-app/**一行无需追加。定时同步仓库 README 建议把拉取任务放在北京时间 0107 点闲时一行 crontab 即可0 3 * * * cd /path/to/public-image-mirror ./hack/merge-mirror.sh immich-allows.txt immich-used.txt sync.log 21版本锁定缓存内容只保留 30 天latest这类可变 tag 变更后还会命中旧数据再后台重同步。README 建议的优先级是sha256: 明确版本号 latest生产环境至少钉到具体版本。Immich 镜像拉取超时排查验证分两步一是查同步队列状态确认任务在正常推进队列仅保留 1 小时记录curl https://queue.m.daocloud.io/status/ | grep immich二是用仓库内置的差异检查确认本地缓存与源镜像一致无输出即一致./hack/diff-image.sh ghcr.io/immich-app/ml-worker:v1.91.0常见情况按现象→原因→处理对号入座现象原因处理拉取报 404/403镜像不在白名单grep immich allows.txt确认不在则走自定义白名单同步卡在 Pulling 不报错队列拥挤或源站慢挪到 0107 点闲时再查队列状态拉到旧镜像可变 tag 缓存未过期换明确版本号或sha256:固定内容按前缀替换这条路走下来Immich 的 ml-worker 拉取基本稳定在分钟级。镜像是否支持、同步规则细节以仓库内 README.md 与 allows.txt 为准。【免费下载链接】public-image-mirror很多镜像都在国外。比如 gcr 。国内下载很慢需要加速。致力于提供连接全世界的稳定可靠安全的容器镜像服务。项目地址: https://gitcode.com/GitHub_Trending/pu/public-image-mirror创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考