利用南大 ghcr 镜像源解决 ghcr.io 国内拉取限速 / 超时，保持配置、compose 文件里镜像地址依然写原版 ghcr.io。SSH登录到安装了HA命令行，下面以更新到“ghcr.io/home-assistant/qemuarm-64-homeassistant:2026.10.4”为例：
1. 拉取国内代理源镜像
Bash / Shell1 line
|
1 |
<span class="cbp-l">docker pull ghcr.nju.edu.cn<span class="sy0">/</span>home-assistant<span class="sy0">/</span>qemuarm-<span class="nu0">64</span>-homeassistant:2026.10.4</span> |
Original Codebox Plus © 2014 o0johntam0o (Huynh Buu Tam)phpBB 3.3 version © 2026 Salvo CortesianoGitHub repository
2. 将南大的标签打上原版 ghcr.io 标签（核心一步，不重复下载）
Bash / Shell1 line
|
1 |
<span class="cbp-l">docker tag ghcr.nju.edu.cn<span class="sy0">/</span>home-assistant<span class="sy0">/</span>qemuarm-<span class="nu0">64</span>-homeassistant:2026.10.4 ghcr.io<span class="sy0">/</span>home-assistant<span class="sy0">/</span>qemuarm-<span class="nu0">64</span>-homeassistant:2026.10.4</span> |
Original Codebox Plus © 2014 o0johntam0o (Huynh Buu Tam)phpBB 3.3 version © 2026 Salvo CortesianoGitHub repository
3. 通过 HomeAssistant 页面点击升级
Docker 检测本地已经存在 ghcr.io/xxx:2026.10.4，不会再访问外网 ghcr.io 拉取，直接进行升级。
4.（可选）清理旧版本镜像、南大源标签
Bash / Shell4 line
|
1 |
<span class="cbp-l"><span class="co0"># 只删除南大的tag，镜像数据不会删（原版tag还在）</span></span><span class="cbp-l">docker rmi ghcr.nju.edu.cn<span class="sy0">/</span>home-assistant<span class="sy0">/</span>qemuarm-<span class="nu0">64</span>-homeassistant:2026.10.4</span><span class="cbp-l"><span class="co0"># 清理不用的旧镜像</span></span><span class="cbp-l">docker image <span class="kw2">prune</span></span> |
Original Codebox Plus © 2014 o0johntam0o (Huynh Buu Tam)phpBB 3.3 version © 2026 Salvo CortesianoGitHub repository
*** 关键点 & 限制 ***
– docker tag **仅本地别名，不会上传镜像到 ghcr.io**；
– 该方案规避了 daemon.json 无法对 ghcr.io 设置 registry-mirrors 的问题；
– 依赖南大公益源，源如果失效，就需要换别的 ghcr 代理地址；
– 区分：dockerd 的 registry-mirrors 只加速 docker.io，对 ghcr.io 无效。
原文作者: BG6RSH | 查看原帖