docker桌面版镜像源

### 如何在 Docker Desktop 中配置 Docker Engine 使用自定义镜像源 为了使 Docker Desktop 能够更高效地拉取容器镜像，尤其是在网络条件不佳的情况下，可以通过配置 `Docker Engine` 的 JSON 文件来指定国内或其他加速镜像源。以下是详细的说明： #### 配置方法 1. 打开 **Docker Desktop** 应用程序并进入其设置界面。 2. 在设置窗口中找到 **Docker Engine** 选项卡，并点击它以访问高级配置功能[^1]。 3. 编辑 JSON 配置文件，在其中添加或修改 `"registry-mirrors"` 字段的内容。例如： ```json { "registry-mirrors": [ "https://hub-mirror.c.163.com", "https://mirror.ccs.tencentyun.com", "https://docker.m.daocloud.io" ] } ``` 上述字段中的 URL 列表即为可用的国内镜像源地址列表[^4]。 4. 完成编辑后保存更改，并重启 Docker Desktop 服务以应用新的配置。 #### 常见问题处理 如果遇到诸如 **Docker Engine Stopped (Docker引擎停止)** 这样的错误消息，则可能是因为配置文件存在语法错误或者某些特定的镜像源不可达所致[^3]。此时可以尝试以下措施解决： - 检查 JSON 格式的正确性； - 删除部分不稳定或无法连接的镜像站点链接； - 确认本地计算机与所选镜像服务器之间的连通状态良好。 通过上述操作即可成功完成对 Docker Desktop 下 Docker Engine 组件关于自定义镜像源方面的调整工作。 ```python import json # 示例代码展示如何动态更新 registry-mirrors 参数 config_path = "/path/to/docker-desktop-settings.json" with open(config_path, 'r') as f: config_data = json.load(f) if not isinstance(config_data.get('registry-mirrors'), list): config_data['registry-mirrors'] = [] new_mirrors = ["https://hub-mirror.c.163.com", "https://mirror.ccs.tencentyun.com"] for mirror in new_mirrors: if mirror not in config_data['registry-mirrors']: config_data['registry-mirrors'].append(mirror) with open(config_path, 'w') as f: json.dump(config_data, f, indent=4) ``` 此脚本可以帮助自动化管理这些镜像源条目。 ---

### 配置 Docker Desktop 使用自定义镜像仓库 为了使 Docker 能够从指定的私有仓库拉取镜像，需配置 Docker 的 `daemon.json` 文件来设置镜像仓库地址[^1]。 #### 修改 Daemon Configuration File 对于 Windows 和 Mac 用户来说，可以通过图形界面访问此配置： - 打开 **Docker Desktop** - 进入菜单中的 **Settings (设置)** 选项卡 - 寻找并点击左侧边栏里的 **Daemon** 或者 **Resources** 在高级模式下编辑 JSON 格式的配置文件。如果要添加多个可信的私有注册表，则可以在 `insecure-registries` 字段内加入这些 URL 地址: ```json { "insecure-registries" : ["my.custom.registry:5000"] } ``` 上述操作完成后保存更改，并重启 Docker 服务以应用新设定[^4]。 #### 测试连接至新的镜像源 确认修改生效的方法之一就是尝试推送或拉取来自该自定义仓库内的镜像资源。假设已有一个名为 `example-app` 的本地构建好的镜像，可以执行如下命令将其打上标签并与远端关联： ```bash docker tag example-app my.custom.registry:5000/example-app:v1 ``` 随后利用 push 命令上传至目标服务器： ```bash docker push my.custom.registry:5000/example-app:v1 ``` 最后验证是否可以从这个新增加的镜像库成功下载相同版本的应用程序包： ```bash docker pull my.custom.registry:5000/example-app:v1 ```