workbuddy安装时镜像拉取失败可借助腾讯云镜像加速源解决：一、配置daemon.json全局生效；二、临时替换镜像地址拉取并重打标签；三、docker desktop图形界面配置；四、通过docker info和pull验证加速生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在安装 WorkBuddy 时遇到容器镜像拉取失败、超时或连接拒绝等问题，通常是因为默认从 Docker Hub 拉取镜像受网络限制影响。以下是通过腾讯云镜像加速源解决该问题的多种配置方法：
一、配置Docker daemon.json使用腾讯云镜像加速
该方法全局生效，适用于所有通过 Docker CLI 或容器运行时发起的镜像拉取请求，是生产环境推荐方式。
1、创建或编辑 Docker 守护进程配置文件 daemon.json。
2、执行命令 sudo mkdir -p /etc/docker。
3、执行命令 sudo nano /etc/docker/daemon.json（如无 nano 可用 vi）。
4、在文件中写入以下 JSON 内容（注意保留原有内容并合并，勿覆盖）：
5、输入 {"registry-mirrors": ["https://mirror.ccs.tencentyun.com"]}。
6、保存并退出编辑器。
7、执行命令 sudo systemctl daemon-reload。
8、执行命令 sudo systemctl restart docker。
二、临时指定腾讯云镜像地址拉取WorkBuddy镜像
该方法无需修改系统配置，适合单次调试或受限权限环境，直接在 docker pull 命令中注入镜像仓库前缀。
1、确认 WorkBuddy 所需镜像原始名称，例如 workbuddy/app:latest。
2、将原始镜像名替换为腾讯云镜像代理地址格式：mirror.ccs.tencentyun.com/workbuddy/app:latest。
3、执行命令 docker pull mirror.ccs.tencentyun.com/workbuddy/app:latest。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
4、拉取成功后，使用 docker tag 命令重打标签：docker tag mirror.ccs.tencentyun.com/workbuddy/app:latest workbuddy/app:latest。
三、通过 Docker Desktop 图形界面配置腾讯云镜像源
该方法适用于 Windows 或 macOS 系统中使用 Docker Desktop 的用户，操作直观且无需命令行干预。
1、点击右下角任务栏/菜单栏中的 Docker 鲸鱼图标。
2、右键选择 Settings（设置）。
3、左侧导航栏点击 Docker Engine。
4、在右侧 JSON 编辑框中找到 registry-mirrors 字段，若不存在则手动添加。
5、确保 registry-mirrors 数组中包含："https://mirror.ccs.tencentyun.com"。
6、点击 Apply & Restart 按钮使配置生效。
四、验证腾讯云镜像加速是否生效
该步骤用于确认配置已正确加载并实际参与镜像拉取过程，避免因配置错误导致加速未启用。
1、执行命令 docker info。
2、在输出内容中查找 Registry Mirrors 字段。
3、确认其值包含：https://mirror.ccs.tencentyun.com。
4、执行命令 docker pull hello-world，观察日志中 Pulling from 后显示的域名是否为 mirror.ccs.tencentyun.com。
