4步解决 Home Assistant 镜像拉取失败DaoCloud 镜像加速完整教程【免费下载链接】public-image-mirror很多镜像都在国外。比如 gcr 。国内下载很慢需要加速。致力于提供连接全世界的稳定可靠安全的容器镜像服务。项目地址: https://gitcode.com/GitHub_Trending/pu/public-image-mirrordocker pull卡住不动、Home Assistant 镜像拉取失败反复超时——原因通常不在你的机器而是 gcr.io、docker.io 这些源站服务器全部部署在海外。public-image-mirror 是 DaoCloud 开源的公益性镜像加速服务。这篇文章带你三步拉取并跑起 Home Assistant再避开新手最容易碰到的 4 个坑。 它是什么一句话理解 public-image-mirror可以把它理解成两个机制配合白名单决定“哪些镜像能加速”懒加载决定“什么时候去拉”。白名单由项目里的 allows.txt 文件维护用通配符匹配——写一行docker.io/homeassistant/*就意味着homeassistant命名空间下的所有镜像都合格目前共收录 800 条规则懒加载则意味着它不做全量预同步而是你第一次拉取某个镜像时服务才去源站拉回来并缓存之后别人再拉就直接命中缓存。某个镜像当前的同步状态可以在项目的同步队列状态页查到。机制工作方式白名单allows.txt 定义哪些镜像可被加速通配符匹配懒加载用户首次请求时才回源拉取并缓存不预先全量同步选哪种地址前缀 vs 域名替换拿到加速地址有两种写法官方更推荐第一种加m.daocloud.io/前缀域名替换写法在原始地址前直接拼上加速域名把源站域名换成对应加速域名docker.io → docker.m.daocloud.io、gcr.io → gcr.m.daocloud.io、ghcr.io → ghcr.m.daocloud.io适用范围白名单内任意镜像仅列表里列出的那几个源站建议✅ 推荐可用同一个 Home Assistant 镜像的两种写法# 前缀方式 m.daocloud.io/docker.io/homeassistant/home-assistant:2023.12.3 # 域名替换方式 docker.m.daocloud.io/homeassistant/home-assistant:2023.12.3 三步跑起 Home Assistant第 1 步拉取加速镜像。指定固定版本号别用latest这样即使源站 tag 变了也不影响你docker pull m.daocloud.io/docker.io/homeassistant/home-assistant:2023.12.3第 2 步启动容器。--privileged给容器完整权限Home Assistant 的 addon 体系需要-v把配置目录挂出来保证数据可持久化-p 8123:8123把访问端口映射到宿主机docker run -d --name home-assistant --privileged \ -e TZAsia/Shanghai -v /path/to/config:/config -p 8123:8123 \ m.daocloud.io/docker.io/homeassistant/home-assistant:2023.12.3第 3 步验证。打开浏览器访问http://localhost:8123看到 Home Assistant 的登录界面就说明部署成功了。避坑清单最容易碰到的 4 种情况如果你的docker pull失败或容器起不来先对照这四种情况404 Not Found。现象拉新发布的版本直接 404原因新镜像发布后回源同步大约需要 1 小时处理过一会儿再试或者去仓库 issues 页反馈。版本漂移。现象一直用latest某天行为突然变了原因latest是可变标签源站更新后会重新同步新数据处理固定明确版本号想锁得更死可以用sha256:指定摘要。拉取速度波动。现象同一镜像有时快有时卡原因服务在高峰时段比较拥挤处理把拉取任务安排在闲时比如北京时间 01:00-07:00 再执行。端口不通。现象容器显示在跑但http://localhost:8123打不开原因宿主机 8123 端口被占用或防火墙拦截处理把-p里宿主机一侧的端口改成一个空闲端口再检查防火墙规则。白名单同样覆盖 Kubernetes、Ollama 等热门开源镜像完整清单直接看 allows.txt。你需要的镜像不在列表里就提 issue 申请觉得有用也欢迎给 GitHub 仓库点个 star。【免费下载链接】public-image-mirror很多镜像都在国外。比如 gcr 。国内下载很慢需要加速。致力于提供连接全世界的稳定可靠安全的容器镜像服务。项目地址: https://gitcode.com/GitHub_Trending/pu/public-image-mirror创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 4步解决 Home Assistant 镜像拉取失败：DaoCloud 镜像加速完整教程
4步解决 Home Assistant 镜像拉取失败DaoCloud 镜像加速完整教程【免费下载链接】public-image-mirror很多镜像都在国外。比如 gcr 。国内下载很慢需要加速。致力于提供连接全世界的稳定可靠安全的容器镜像服务。项目地址: https://gitcode.com/GitHub_Trending/pu/public-image-mirrordocker pull卡住不动、Home Assistant 镜像拉取失败反复超时——原因通常不在你的机器而是 gcr.io、docker.io 这些源站服务器全部部署在海外。public-image-mirror 是 DaoCloud 开源的公益性镜像加速服务。这篇文章带你三步拉取并跑起 Home Assistant再避开新手最容易碰到的 4 个坑。 它是什么一句话理解 public-image-mirror可以把它理解成两个机制配合白名单决定“哪些镜像能加速”懒加载决定“什么时候去拉”。白名单由项目里的 allows.txt 文件维护用通配符匹配——写一行docker.io/homeassistant/*就意味着homeassistant命名空间下的所有镜像都合格目前共收录 800 条规则懒加载则意味着它不做全量预同步而是你第一次拉取某个镜像时服务才去源站拉回来并缓存之后别人再拉就直接命中缓存。某个镜像当前的同步状态可以在项目的同步队列状态页查到。机制工作方式白名单allows.txt 定义哪些镜像可被加速通配符匹配懒加载用户首次请求时才回源拉取并缓存不预先全量同步选哪种地址前缀 vs 域名替换拿到加速地址有两种写法官方更推荐第一种加m.daocloud.io/前缀域名替换写法在原始地址前直接拼上加速域名把源站域名换成对应加速域名docker.io → docker.m.daocloud.io、gcr.io → gcr.m.daocloud.io、ghcr.io → ghcr.m.daocloud.io适用范围白名单内任意镜像仅列表里列出的那几个源站建议✅ 推荐可用同一个 Home Assistant 镜像的两种写法# 前缀方式 m.daocloud.io/docker.io/homeassistant/home-assistant:2023.12.3 # 域名替换方式 docker.m.daocloud.io/homeassistant/home-assistant:2023.12.3 三步跑起 Home Assistant第 1 步拉取加速镜像。指定固定版本号别用latest这样即使源站 tag 变了也不影响你docker pull m.daocloud.io/docker.io/homeassistant/home-assistant:2023.12.3第 2 步启动容器。--privileged给容器完整权限Home Assistant 的 addon 体系需要-v把配置目录挂出来保证数据可持久化-p 8123:8123把访问端口映射到宿主机docker run -d --name home-assistant --privileged \ -e TZAsia/Shanghai -v /path/to/config:/config -p 8123:8123 \ m.daocloud.io/docker.io/homeassistant/home-assistant:2023.12.3第 3 步验证。打开浏览器访问http://localhost:8123看到 Home Assistant 的登录界面就说明部署成功了。避坑清单最容易碰到的 4 种情况如果你的docker pull失败或容器起不来先对照这四种情况404 Not Found。现象拉新发布的版本直接 404原因新镜像发布后回源同步大约需要 1 小时处理过一会儿再试或者去仓库 issues 页反馈。版本漂移。现象一直用latest某天行为突然变了原因latest是可变标签源站更新后会重新同步新数据处理固定明确版本号想锁得更死可以用sha256:指定摘要。拉取速度波动。现象同一镜像有时快有时卡原因服务在高峰时段比较拥挤处理把拉取任务安排在闲时比如北京时间 01:00-07:00 再执行。端口不通。现象容器显示在跑但http://localhost:8123打不开原因宿主机 8123 端口被占用或防火墙拦截处理把-p里宿主机一侧的端口改成一个空闲端口再检查防火墙规则。白名单同样覆盖 Kubernetes、Ollama 等热门开源镜像完整清单直接看 allows.txt。你需要的镜像不在列表里就提 issue 申请觉得有用也欢迎给 GitHub 仓库点个 star。【免费下载链接】public-image-mirror很多镜像都在国外。比如 gcr 。国内下载很慢需要加速。致力于提供连接全世界的稳定可靠安全的容器镜像服务。项目地址: https://gitcode.com/GitHub_Trending/pu/public-image-mirror创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考