Home Assistant 镜像加速避坑docker pull 超时先把地址前缀换掉【免费下载链接】public-image-mirror很多镜像都在国外。比如 gcr 。国内下载很慢需要加速。致力于提供连接全世界的稳定可靠安全的容器镜像服务。项目地址: https://gitcode.com/GitHub_Trending/pu/public-image-mirrorDaoCloud 开源的 public-image-mirror 是个公益容器镜像加速项目专治 Home Assistant 这类海外镜像拉取失败、docker pull 一直转圈的老毛病。做 Home Assistant Docker 部署的国内用户给镜像地址加一行前缀就能把拉取跑通。先跑起来一条命令拉取再启动不用改网络、不用装代理直接在镜像地址前面拼m.daocloud.io/请求就先走 DaoCloud 的加速节点。我让面板跑起来时用的就是下面两条命令docker pull m.daocloud.io/docker.io/homeassistant/home-assistantdocker run -d --name home-assistant \ --restartunless-stopped \ -e TZAsia/Shanghai \ -v /homeassistant/config:/config \ -p 8123:8123 \ m.daocloud.io/docker.io/homeassistant/home-assistant跑完浏览器打开http://localhost:8123能看到登录页就成了。以前这条docker pull经常在下载阶段直接断掉现在几分钟内就能拉完。换地址就提速加速前缀加在哪推荐的做法就是「加前缀」规则很直白原地址原样保留前面拼上m.daocloud.io/。它相当于把请求先打到这套国内镜像源节点没货时才回源拉所以国内链路更稳首包也更快。原地址 docker.io/homeassistant/home-assistant 改地址 m.daocloud.io/docker.io/homeassistant/home-assistant想直接换域名前缀替换对照表习惯直接改域名的话也可以走「前缀替换」把原域名换成加速域名即可原域名加速域名docker.iodocker.m.daocloud.iogcr.iogcr.m.daocloud.ioghcr.ioghcr.m.daocloud.io替换后就是docker.m.daocloud.io/homeassistant/home-assistant。注意这套替换规则是人工维护的只有表里这些源站能这么写其他镜像还是用加前缀的方式更保险。 拉取卡在 0% 或报 404 怎么办遇到拉取卡在 0% 或新镜像报 404先别急着下结论多半是懒加载还没拉回来。它只在没人拉过某个镜像时才现去源站拉一遍再缓存所以第一次请求偶尔会慢源站的 tag 更新后加速节点大约 1 小时才同步新数据。因此新镜像拉不到就隔半小时到一小时再试也可以到同步队列页面看它当前状态。长时间不行的话把具体地址提到项目 issues 里反馈。⏰ 固定版本号 闲时拉取把镜像锁死两个习惯能明显少踩坑。一是别用latest优先用sha256:固定摘要和源站完全一致其次用明确版本号 tag最后才考虑可变 tag这样镜像变了也不会悄悄影响正在跑的服务。二是把拉活放到北京时间 01:00–07:00 的闲时这段时间节点不拥挤、速度最稳缓存内容保留约 30 天过期后才会重新同步。docker pull m.daocloud.io/docker.io/homeassistant/home-assistant:2024.12.3这份白名单还能覆盖谁它只加速被「点名」过的镜像名单维护在 allows.txt支持通配符匹配比如docker.io/homeassistant/*就覆盖了 homeassistant 整个命名空间。现在名单里已经超过 1300 条规则Kubernetes、Ollama、MySQL 这些热门项目基本都在里面。你要的镜像若不在名单里去项目仓库的 issues 提个申请维护方会按需评估添加。【免费下载链接】public-image-mirror很多镜像都在国外。比如 gcr 。国内下载很慢需要加速。致力于提供连接全世界的稳定可靠安全的容器镜像服务。项目地址: https://gitcode.com/GitHub_Trending/pu/public-image-mirror创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考