用 public-image-mirror 解决国内 Home Assistant 镜像拉取失败上手指南【免费下载链接】public-image-mirror很多镜像都在国外。比如 gcr 。国内下载很慢需要加速。致力于提供连接全世界的稳定可靠安全的容器镜像服务。项目地址: https://gitcode.com/GitHub_Trending/pu/public-image-mirrordocker pull 进度条卡住的成因docker pull卡住数分钟后报context deadline exceeded这是从 docker.io 等海外源仓库拉取 Home Assistant 镜像时的常见状态。public-image-mirror 是 DaoCloud 开源的容器镜像同步服务把白名单内的海外镜像同步到国内加速节点拉取地址加上m.daocloud.io/前缀即可走国内链路。支持哪些源站四维能力速览直接决定用不用得上的四个维度如下维度说明支持的源站docker.io、gcr.io、ghcr.io、quay.io、mcr.microsoft.com、registry.k8s.io 等共 11 个加速地址形式加m.daocloud.io/前缀推荐或按源站替换为docker.m.daocloud.io等加速域名同步机制懒加载首次请求才从源站回源并缓存内容缓存 30 天manifest 内存缓存 1 小时blob 内存缓存 1 分钟白名单规模allows.txt 共 1300 条规则随社区需求持续扩充机制拆解白名单匹配规则与懒加载同步的代价白名单是唯一入口能加速的镜像以 allows.txt 为准不在名单内会被直接拒绝。hack/verify-allows.sh 的匹配逻辑可以压缩成 6 行if [[ ${line} *** ]]; then [[ ${image} ${line%\*\*}* ]] return 0 elif [[ ${line} ** ]]; then [[ ${image} ${line%\*}* ]] || continue [[ ${image#${line%\*}} ! */* ]] return 0 fi*只匹配前缀下的一级路径**匹配任意深度的子目录。以 Home Assistant 为例规则docker.io/homeassistant/*恰好覆盖该命名空间下的官方镜像homeassistant/home-assistant。不做全量同步用到才回源它不预先存储任何镜像而是国内用户首次请求时由代理从源站拉取sha256 与源仓库完全一致。代价也写得很明确内容缓存只保留 30 天过期重新回源manifest 内存缓存 1 小时新 tag 发布约 1 小时后才同步blob 在 1 分钟缓存窗口内恰好到期则会报 404。地址改写就两行docker.io/homeassistant/home-assistant:2025.6.1 m.daocloud.io/docker.io/homeassistant/home-assistant:2025.6.1第二行即加前缀后的地址生产环境直接用它拉取。最小可用命令拉取并启动 Home Assistantdocker pull m.daocloud.io/docker.io/homeassistant/home-assistant:2025.6.1从国内节点拉取该 tag 若首次被请求会触发从源站回源同步稍等片刻或重试即可。docker run -d --name home-assistant --privileged --restartunless-stopped -e TZAsia/Shanghai -v /path/to/ha-config:/config -p 8123:8123 m.daocloud.io/docker.io/homeassistant/home-assistant:2025.6.1后台常驻并挂载配置目录浏览器访问http://localhost:8123即可完成初始化。常见疑问同步延迟、标签选择与拉取时段Q镜像刚发布就去拉报 404 或内容偏旧怎么办Amanifest 内存缓存 1 小时新 tag 发布约 1 小时后才同步缓存内容 30 天未命中会被清理再次拉取会重新回源。生产环境优先用sha256:摘要其次明确版本号避免latest这类可变 tag。Q什么时段拉取最稳AREADME 建议把大批量拉取放在北京时间 01:00–07:00 闲时白天队列拥挤同步进度可在同步队列 queue.m.daocloud.io/status 观察队列只保留 1 小时记录。Q我要的镜像不在白名单里A先按命名空间关键字在 allows.txt 里自查1300 行规则覆盖面已不小确实没有再到仓库提 Issue由维护者评估后加入名单。一句话收束public-image-mirror 把跨境拉镜像变成改一行地址换来的是国内链路的稳定拉取。【免费下载链接】public-image-mirror很多镜像都在国外。比如 gcr 。国内下载很慢需要加速。致力于提供连接全世界的稳定可靠安全的容器镜像服务。项目地址: https://gitcode.com/GitHub_Trending/pu/public-image-mirror创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考