Docker 镜像加速完整指南2 条命令跑通 Home Assistant原理与避坑一次讲清【免费下载链接】public-image-mirror很多镜像都在国外。比如 gcr 。国内下载很慢需要加速。致力于提供连接全世界的稳定可靠安全的容器镜像服务。项目地址: https://gitcode.com/GitHub_Trending/pu/public-image-mirror国内拉取 docker.io、gcr.io 等海外容器镜像经常超时。public-image-mirror 是 DaoCloud 开源的公益镜像加速项目白名单精选常用开源镜像同步至国内加速节点拉取时只需加一个前缀。先看 2 条命令跑通 Home Assistant再拆解原理与坑。快速上手2 条命令跑通 Home Assistant结论先行把原镜像地址前加上m.daocloud.io/其余流程与官方文档完全一致。# 第 1 条拉取加速镜像 docker pull m.daocloud.io/docker.io/homeassistant/home-assistant:latest # 第 2 条启动容器 docker run -d --name home-assistant \ --privileged \ --restartunless-stopped \ -e TZAsia/Shanghai \ -v /path/to/config:/config \ -p 8123:8123 \ m.daocloud.io/docker.io/home-assistant:latest浏览器打开http://localhost:8123出现登录界面即部署成功。✅ 想先验证通道可拉一个轻量镜像docker run -d -P m.daocloud.io/docker.io/library/nginx这是官方 README「快速开始」给出的最小示例。加速原理白名单匹配、地址写法与懒同步机制分三层各说一段。白名单准入allows.txt 两级通配符可加速的镜像全部由 allows.txt 声明当前共 1327 条规则新增镜像不需要改代码。规则有三种形式规则形式匹配范围示例完整名称精确到单个镜像docker.io/library/nginx结尾/*该命名空间下一级全部镜像docker.io/homeassistant/*结尾/**整站递归匹配gcr.io/**判定逻辑在 hack/verify-allows.sh 中**直接做前缀匹配*要求去掉后缀后剩余部分不再包含/即恰好一层。所以 Home Assistant 靠docker.io/homeassistant/*一条规则全量覆盖而docker.io/*一条规则就放行了整个 Docker Hub 命名空间。两种加速地址写法写法一加前缀推荐覆盖全部白名单docker.io/homeassistant/home-assistant:latest → m.daocloud.io/docker.io/homeassistant/home-assistant:latest写法二域名替换人工配置按需提 Issue 增补源站替换为docker.iodocker.m.daocloud.iogcr.iogcr.m.daocloud.ioghcr.ioghcr.m.daocloud.ioquay.ioquay.m.daocloud.ioregistry.k8s.iok8s.m.daocloud.io⚠️ 注意Docker 的registry-mirrors只能配置 docker.io 对应的docker.m.daocloud.io其他源站配置到 Podman 的 registries mirror 才生效。懒加载同步与三个缓存周期不做全量预同步。首次有人请求某镜像时才从源站回源并缓存sha256 与源站严格一致。三个周期决定行为缓存整体保留30 天过期后需重新同步Manifest 内存缓存1 小时tag 指向更新后约 1 小时才同步到新内容Blob 内存缓存1 分钟期间 blob 若满 30 天被清理会短暂 404。另外同步队列仅保留1 小时的同步记录排查问题要趁早。避坑指南拉取时段、版本钉死与 404 处理四个高频问题按踩坑频率排序。1. 拉取安排在闲时。官方建议把拉取任务放在北京时间01:00–07:00其余时段并发拥挤、速度不稳定。2. 版本钉死优先 digest。推荐顺序sha256:摘要 明确版本号 tag latest。latest属于可变 tag变更后会先响应旧数据、后台再重新同步行为不可预期。生产部署直接写死版本例如m.daocloud.io/docker.io/homeassistant/home-assistant:2023.12.3。3. 新镜像约有 1 小时同步延迟。源站刚发布的 tag 拉不到属正常现象重试无效时到项目仓库 Issues 反馈或核对同步队列状态。4. 404 先等再查。多由缓存过期或 blob 清理窗口引起稍后重拉通常恢复持续 404 再核对 allows.txt 是否真的覆盖目标镜像匹配规则可对照 hack/verify-image-match.sh 与 hack/correct-image.sh 的归一化逻辑自查。支持范围Home Assistant 之外的开源项目白名单远不止智能家居。1327 条规则覆盖 12 个以上源站典型场景Kuberneteskubeadm 将imageRepository改为k8s.m.daocloud.io即可加速安装kind 用m.daocloud.io/docker.io/kindest/node:v1.22.1建集群repimage Webhook 可免改 YAML 批量改写新建 Pod 的镜像地址AI 工具链Ollama 直接docker pull docker.m.daocloud.io/ollama/ollamaDeepSeek 模型支持走ollama.m.daocloud.io实验内测中数据库与中间件MySQL、Redis、PostgreSQL、Elasticsearch、Kafka、Jenkins、Grafana 等均在docker.io/*覆盖范围内内网环境参考 docs/local-cache/ 部署本地缓存代理把前缀m.daocloud.io/换成内网 registry 地址写法完全复用。完整清单以仓库内 allows.txt 为准本地克隆后按docker.io前缀过滤即可快速定位git clone https://gitcode.com/GitHub_Trending/pu/public-image-mirror目标镜像不在白名单中直接到项目仓库提 Issue 申请维护方按社区需求评估增补。结语public-image-mirror 把海外镜像拉不动收敛成两个动作改一行前缀、避开高峰时段。规则开源可查、同步机制透明是个人与团队都能长期依赖的镜像加速底座。觉得有用请点赞、收藏并关注 DaoCloud 的 public-image-mirror 仓库第一时间获取白名单与源站更新。【免费下载链接】public-image-mirror很多镜像都在国外。比如 gcr 。国内下载很慢需要加速。致力于提供连接全世界的稳定可靠安全的容器镜像服务。项目地址: https://gitcode.com/GitHub_Trending/pu/public-image-mirror创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考