应配置腾讯云tcr镜像加速地址，编辑/etc/docker/daemon.json添加"registry-mirrors": ["https://mirror.ccs.tencentyun.com"]，重启docker后验证生效；若失效，可切换科大或阿里云镜像源，或手动替换镜像前缀为tcr兼容地址。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在安装 WorkBuddy 过程中遇到无法拉取所需 Docker 镜像的问题，通常是因为默认连接 Docker Hub 时受网络限制导致超时或失败。以下是解决此问题的步骤：
一、配置腾讯云容器镜像服务（TCR）加速地址
腾讯云 TCR 提供对 Docker Hub 等境外仓库的代理加速能力，适用于 TKE 集群及支持 registry-mirrors 配置的 Docker 客户端。该方式无需魔法，直接通过官方可信域名实现镜像拉取提速。
1、访问腾讯云容器镜像服务控制台：打开 https://cr.console.aliyun.com（注：此处为阿里云地址，实际应使用腾讯云 TCR 控制台；若未开通，请先登录腾讯云搜索“容器镜像服务 TCR”并进入）。
2、在左侧导航栏点击「镜像加速器」，系统将自动生成专属加速地址，格式类似 https://mirror.ccs.tencentyun.com（注意：该地址已于2024年失效，当前有效地址需以控制台实时显示为准）。
3、编辑 Docker 守护进程配置文件：/etc/docker/daemon.json（Linux/macOS）或通过 Docker Desktop 设置界面（Windows/macOS GUI）修改。
4、在 daemon.json 中添加 registry-mirrors 字段，例如：
{
"registry-mirrors": ["https://mirror.ccs.tencentyun.com"]
}
5、保存文件后执行命令重启 Docker 服务：sudo systemctl daemon-reload && sudo systemctl restart docker。
6、验证配置是否生效：运行 docker info，检查输出中 Registry Mirrors 是否包含刚配置的地址。
二、切换至科大镜像源作为备用方案
当腾讯云加速地址不可用或返回 404 时，可立即切换至中国科学技术大学提供的稳定镜像源，该镜像站长期维护且无需账号登录即可使用。
1、获取科大镜像地址：https://docker.mirrors.ustc.edu.cn/。
2、替换 daemon.json 中的 registry-mirrors 值为上述地址。
3、执行 sudo systemctl restart docker 使配置生效。
4、运行 docker pull hello-world 测试基础镜像拉取是否成功。
三、使用阿里云镜像加速器（需登录获取专属地址）
阿里云为每个用户分配独立的镜像加速地址，具备高可用性与低延迟特性，适合作为第二优先级备选方案。
1、登录阿里云容器镜像服务控制台：https://cr.console.aliyun.com/cn-hangzhou/instances/mirrors。
腾讯云跨账号资源迁移工具，支持将账号A的VPC、CLB、NAT、CVM、安全组等资源迁移至账号B，通过CCN云联网实现跨账号网络互通，提供自动扫描、配置生成、Terraform部署功能。
2、在「镜像加速器」页面查看并复制您的专属加速地址，格式为 https://xxxxxx.mirror.aliyuncs.com。
3、将该地址填入 daemon.json 的 registry-mirrors 数组中，覆盖原有地址。
4、重启 Docker 服务：sudo systemctl restart docker。
5、执行 docker info | grep -A 1 "Registry Mirrors" 确认地址已加载。
四、手动替换镜像仓库前缀（绕过 docker.io 限制）
针对 WorkBuddy 安装脚本中硬编码调用 gcr.io 或 quay.io 镜像的情况，Docker 原生不支持多仓库加速，需通过域名重写方式将请求导向腾讯云 TCR 加速节点。
1、确认目标镜像原始地址，例如 gcr.io/google_containers/pause:3.6。
2、将其替换为腾讯云 TCR 兼容格式：ccr.ccs.tencentyun.com/google_containers/pause:3.6。
3、在 WorkBuddy 安装环境变量或启动脚本中设置 IMAGE_PREFIX 变量指向该地址。
4、重新触发镜像拉取流程，观察日志是否跳过原始域名直连。
五、启用本地代理转发（适用于 WSL2 或企业受限网络）
当宿主机已配置 HTTP 代理（如 127.0.0.1:1080），但 WSL2 内 Docker 未继承时，需显式注入代理配置以打通镜像下载链路。
1、在 WSL2 中执行：echo 'export HTTP_PROXY="http://127.0.0.1:1080"' >> ~/.bashrc。
2、执行：echo 'export HTTPS_PROXY="http://127.0.0.1:1080"' >> ~/.bashrc。
3、运行 source ~/.bashrc 加载新环境变量。
4、重启 WSL2 中的 Docker 服务：sudo service docker restart。
5、测试拉取：docker pull nginx，观察是否出现代理连接日志。
