3分钟解决 Home Assistant 镜像拉取失败DaoCloud 镜像加速完整部署教程【免费下载链接】public-image-mirror很多镜像都在国外。比如 gcr 。国内下载很慢需要加速。致力于提供连接全世界的稳定可靠安全的容器镜像服务。项目地址: https://gitcode.com/GitHub_Trending/pu/public-image-mirror执行拉取命令后进度条原地不动或者终端隔几行就报一次超时——Home Assistant 镜像拉取失败多数时候不是你的配置出了问题。DaoCloud 开源的 public-image-mirror 是一套免费的 DaoCloud 镜像加速服务它把 homeassistant 这类海外开源镜像同步到国内节点拉取时把地址换成加速地址即可其余操作和平时完全一样。为什么拉取总是超时先弄清卡在哪热门开源镜像基本都存放在海外仓库。homeassistant 放在 docker.io 上Kubernetes 相关组件则多在 gcr.io 等海外节点服务器物理位置都在国外。国内访问这些源链路要跨越多层网络节点任何一段拥塞都会丢包。而拉取镜像要按层传输大量数据中间断一次整条传输就得等它恢复表现出来就是卡住不动或反复重试。所以这不是机器性能或 Docker 参数问题而是物理链路问题。解决思路只有一个在拉取路径前面架一个国内中转点让数据从近的节点走。DaoCloud 镜像加速怎么用两种地址写法它不做全量搬运。某个镜像只有被首次请求时才从源站同步到国内节点懒加载机制之后再走本地缓存sha256 与源站保持一致。能否加速由白名单决定allows.txt 里没登记的镜像直接拉不到登记了就放行匹配规则由 hack/verify-allows.sh 脚本校验homeassistant 命名空间已被docker.io/homeassistant/*这条规则覆盖。日常只需要改地址两种写法任选写法怎么改Home Assistant 示例添加前缀推荐在原地址最前面拼上m.daocloud.io/m.daocloud.io/docker.io/homeassistant/home-assistant:latest替换域名把原仓库域名换成对应的加速域名docker.m.daocloud.io/homeassistant/home-assistant:latest替换域名方式的对照关系是人工维护的例如 docker.io 对应 docker.m.daocloud.iogcr.io 对应 gcr.m.daocloud.ioghcr.io 对应 ghcr.m.daocloud.io完整列表见仓库 README。写错域名会直接找不到镜像所以新镜像建议优先用前缀方式。从拉取到启动的最快路径拉取加速镜像docker pull m.daocloud.io/docker.io/homeassistant/home-assistant:latest启动容器挂载配置目录并映射 8123 端口docker run -d --name home-assistant --privileged --restartunless-stopped -e TZAsia/Shanghai -v /path/to/your/config:/config -p 8123:8123 m.daocloud.io/docker.io/homeassistant/home-assistant:latest打开浏览器访问http://localhost:8123看到 Home Assistant 登录页即部署成功。排坑指南常见失败情况与处理方法⏰ 白天下载明显变慢、频繁超时把拉取任务挪到北京时间 01:00–07:00 的闲时执行这个时段服务器负载最低。️ 用latest拉到的版本和行为对不上可变 tag 变更后可能先响应旧数据再后台重新同步。生产环境固定版本号如:2023.12.3更稳妥的做法是直接按摘要固定镜像。 刚发布的新版本拉下来是 404tag 更新后缓存约 1 小时才同步新内容且缓存过期周期是 30 天。遇到 404 先等一会儿重试。 换地址后依然报找不到镜像说明该镜像不在白名单里加速服务不会代拉白名单外的内容需要走 Issues 申请加入。 想看某次同步进行到哪一步项目的同步队列页面只保留最近一小时的记录请求发出后尽快去查。新手最常问的 3 个问题拉取一直 404 怎么办两个常见原因一是 tag 变更后的同步延迟约 1 小时二是缓存 30 天过期后的短暂窗口。等一段时间重试多数情况自行恢复持续失败再向项目反馈。我需要的镜像不在白名单里白名单目前收录了 800 多条规则覆盖主流开源项目但确实不可能全。通过仓库 Issues 提交申请维护方会按需评估添加。能不能把 Docker 整体切到加速源一劳永逸可以但只对 docker.io 有效在/etc/docker/daemon.json的registry-mirrors里加入https://docker.m.daocloud.io即可。注意不要把 gcr.io 等其他仓库的加速域名塞进这个配置每个源站的加速地址是独立对应的配错就失效。把地址改一下拉不动的镜像就变成国内节点直发——这套白名单 懒加载的加速服务由 DaoCloud 开源维护全部规则和脚本都开放在 public-image-mirror 仓库里可自行查证。【免费下载链接】public-image-mirror很多镜像都在国外。比如 gcr 。国内下载很慢需要加速。致力于提供连接全世界的稳定可靠安全的容器镜像服务。项目地址: https://gitcode.com/GitHub_Trending/pu/public-image-mirror创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考