Docker 镜像拉取超时怎么办3 步启用 DaoCloud public-image-mirror 镜像加速【免费下载链接】public-image-mirror很多镜像都在国外。比如 gcr 。国内下载很慢需要加速。致力于提供连接全世界的稳定可靠安全的容器镜像服务。项目地址: https://gitcode.com/GitHub_Trending/pu/public-image-mirror部署 Home Assistant 或 Ollama 服务时镜像拉取进度条卡在 3% 迟迟不动重试几次结果都一样——这多半是源仓库部署在境外导致的。DaoCloud 开源的 public-image-mirror 项目把 1300 多个常用开源镜像同步到国内加速节点改一下前缀就能解决从 docker.io、gcr.io 拉取镜像慢的问题。 快速上手三步拉取加速镜像全程不需要改任何代码最简路径如下。第 1 步改镜像地址。有两种改法加前缀推荐在原地址前拼上m.daocloud.io或者做前缀替换把源域名直接换成对应加速域名如docker.io→docker.m.daocloud.io。第 2 步拉取并运行镜像。# 方式一加前缀推荐以 Home Assistant 2025.6.0 为例 docker pull m.daocloud.io/docker.io/homeassistant/home-assistant:2025.6.0 # 方式二替换源域名效果等价 docker pull docker.m.daocloud.io/homeassistant/home-assistant:2025.6.0第 3 步可选配置全局加速。把加速域名写进 Docker 配置文件之后拉取 docker.io 的镜像会自动走加速节点{ registry-mirrors: [https://docker.m.daocloud.io] }将以上内容写入/etc/docker/daemon.json重启 Docker 服务即可生效。注意全局配置只对 docker.io 生效gcr.io、ghcr.io 等其他源站仍需走前缀方式。完整域名对照表和 Podman、Kubernetes 的配法见 README。 原理加速节点靠什么决定同步哪些镜像加速节点会不会把 docker.io 上所有镜像都同步一遍不会它靠白名单 懒加载两个机制。白名单allows.txt 维护了 1300 多条镜像规则用通配符表达不同粒度比如docker.io/*覆盖整个 docker.iodocker.io/homeassistant/*只覆盖 Home Assistant 命名空间。匹配逻辑写在 hack/verify-allows.sh核心就一句# 双星号规则做前缀匹配规则 docker.io/* 命中 docker.io 下任意镜像 if [[ ${image} ${line%\*\*}* ]]; then return 0; fi镜像命中白名单才会被服务放行没命中则直接拒绝所以新镜像得先加进列表才能用。懒加载不做全量预同步而是国内用户第一次请求某个镜像时才从源站拉回来缓存一份之后所有人拉取都直接命中国内缓存。sha256 校验值与源站保持一致不用担心镜像被改动。代价是缓存有期限内容保留 30 天长期没人拉的 tag 过期后会重新同步一次。⚠️ 避坑4 个常见报错与答案Q1刚发布的新版本拉取报 404。镜像的 manifest 内存缓存约 1 小时新版本上线后存在同步延迟。等 1 小时左右重试即可也可以去同步队列页面查看状态。Q2该用 latest 标签吗不建议。latest 是可变标签上游一变镜像里的旧数据就失效并触发后台重新同步。优先用固定版本号最好直接用sha256:摘要。Q3我需要的镜像不在白名单里。到项目仓库的 Issues 里提交申请维护者评估后会加进 allows.txt加完即可按前缀方式使用。Q4夜里拉取还是很慢。白天节点非常拥挤官方建议把大批量拉取任务安排在凌晨 01:00-07:00北京时间执行。适用人群与边界个人开发者、家庭实验室用户和需要拉取境外镜像仓库的企业都可以直接拿来用它的边界也清楚——只代理白名单内的公开开源镜像私有镜像和商业闭源镜像不在覆盖范围内网部署可再参考 本地缓存文档 做二级缓存。【免费下载链接】public-image-mirror很多镜像都在国外。比如 gcr 。国内下载很慢需要加速。致力于提供连接全世界的稳定可靠安全的容器镜像服务。项目地址: https://gitcode.com/GitHub_Trending/pu/public-image-mirror创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Docker 镜像拉取超时怎么办：3 步启用 DaoCloud public-image-mirror 镜像加速
Docker 镜像拉取超时怎么办3 步启用 DaoCloud public-image-mirror 镜像加速【免费下载链接】public-image-mirror很多镜像都在国外。比如 gcr 。国内下载很慢需要加速。致力于提供连接全世界的稳定可靠安全的容器镜像服务。项目地址: https://gitcode.com/GitHub_Trending/pu/public-image-mirror部署 Home Assistant 或 Ollama 服务时镜像拉取进度条卡在 3% 迟迟不动重试几次结果都一样——这多半是源仓库部署在境外导致的。DaoCloud 开源的 public-image-mirror 项目把 1300 多个常用开源镜像同步到国内加速节点改一下前缀就能解决从 docker.io、gcr.io 拉取镜像慢的问题。 快速上手三步拉取加速镜像全程不需要改任何代码最简路径如下。第 1 步改镜像地址。有两种改法加前缀推荐在原地址前拼上m.daocloud.io或者做前缀替换把源域名直接换成对应加速域名如docker.io→docker.m.daocloud.io。第 2 步拉取并运行镜像。# 方式一加前缀推荐以 Home Assistant 2025.6.0 为例 docker pull m.daocloud.io/docker.io/homeassistant/home-assistant:2025.6.0 # 方式二替换源域名效果等价 docker pull docker.m.daocloud.io/homeassistant/home-assistant:2025.6.0第 3 步可选配置全局加速。把加速域名写进 Docker 配置文件之后拉取 docker.io 的镜像会自动走加速节点{ registry-mirrors: [https://docker.m.daocloud.io] }将以上内容写入/etc/docker/daemon.json重启 Docker 服务即可生效。注意全局配置只对 docker.io 生效gcr.io、ghcr.io 等其他源站仍需走前缀方式。完整域名对照表和 Podman、Kubernetes 的配法见 README。 原理加速节点靠什么决定同步哪些镜像加速节点会不会把 docker.io 上所有镜像都同步一遍不会它靠白名单 懒加载两个机制。白名单allows.txt 维护了 1300 多条镜像规则用通配符表达不同粒度比如docker.io/*覆盖整个 docker.iodocker.io/homeassistant/*只覆盖 Home Assistant 命名空间。匹配逻辑写在 hack/verify-allows.sh核心就一句# 双星号规则做前缀匹配规则 docker.io/* 命中 docker.io 下任意镜像 if [[ ${image} ${line%\*\*}* ]]; then return 0; fi镜像命中白名单才会被服务放行没命中则直接拒绝所以新镜像得先加进列表才能用。懒加载不做全量预同步而是国内用户第一次请求某个镜像时才从源站拉回来缓存一份之后所有人拉取都直接命中国内缓存。sha256 校验值与源站保持一致不用担心镜像被改动。代价是缓存有期限内容保留 30 天长期没人拉的 tag 过期后会重新同步一次。⚠️ 避坑4 个常见报错与答案Q1刚发布的新版本拉取报 404。镜像的 manifest 内存缓存约 1 小时新版本上线后存在同步延迟。等 1 小时左右重试即可也可以去同步队列页面查看状态。Q2该用 latest 标签吗不建议。latest 是可变标签上游一变镜像里的旧数据就失效并触发后台重新同步。优先用固定版本号最好直接用sha256:摘要。Q3我需要的镜像不在白名单里。到项目仓库的 Issues 里提交申请维护者评估后会加进 allows.txt加完即可按前缀方式使用。Q4夜里拉取还是很慢。白天节点非常拥挤官方建议把大批量拉取任务安排在凌晨 01:00-07:00北京时间执行。适用人群与边界个人开发者、家庭实验室用户和需要拉取境外镜像仓库的企业都可以直接拿来用它的边界也清楚——只代理白名单内的公开开源镜像私有镜像和商业闭源镜像不在覆盖范围内网部署可再参考 本地缓存文档 做二级缓存。【免费下载链接】public-image-mirror很多镜像都在国外。比如 gcr 。国内下载很慢需要加速。致力于提供连接全世界的稳定可靠安全的容器镜像服务。项目地址: https://gitcode.com/GitHub_Trending/pu/public-image-mirror创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考