Home Assistant 镜像加速避坑：docker pull 超时？先把地址前缀换掉
【免费下载链接】public-image-mirror很多镜像都在国外。比如 gcr 。国内下载很慢，需要加速。致力于提供连接全世界的稳定可靠安全的容器镜像服务。项目地址: https://gitcode.com/GitHub_Trending/pu/public-image-mirror
DaoCloud 开源的 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 \ --restart=unless-stopped \ -e TZ=Asia/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.io | docker.m.daocloud.io |
| gcr.io | gcr.m.daocloud.io |
| ghcr.io | ghcr.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），仅供参考
