Docker Sandboxes

本页介绍的是本地沙箱。有关云端行为及其限制，请参阅对比本地沙箱与云沙箱。

镜像仓库镜像把沙箱模板和 OCI kit 的 Docker Hub 拉取路由到你的组织镜像基础设施。 如果该镜像满足 Docker Engine 的要求，沙箱内的 Docker 也会使用它。

配置镜像 ​

把 platform.images.registryMirror 设为镜像主机。必要时可以带上端口，但不要写 URL 协议：

console
$ sbx settings set platform.images.registryMirror registry.example.com

对于把镜像后的 Docker Hub 内容存放在某个仓库路径下的镜像仓库，你可以加上路径前缀：

console
$ sbx settings set platform.images.registryMirror registry.example.com/docker-remote

Docker Sandboxes 会重定向解析到 Docker Hub 的镜像引用，并保留它们的仓库路径、标签和 摘要。明确指定了其他镜像仓库的引用保持不变。

如果该镜像需要身份验证，请为镜像主机配置 镜像仓库凭据。

镜像沙箱内的 Docker 拉取 ​

当该设置包含一个不带路径前缀的非回环主机时，Docker Sandboxes 会把沙箱内的 Docker Engine 配置为使用同一个镜像。

镜像设置模板和 OCI kit 拉取沙箱内的 Docker 拉取
registry.example.com走镜像走镜像
registry.example.com:5000走镜像走镜像
registry.example.com/docker-remote走镜像不走镜像
localhost:5000 或 127.0.0.1走镜像不走镜像

回环地址在沙箱自身的网络命名空间中指向沙箱本身，因此 Docker Sandboxes 不会把它们 加入沙箱的 Docker Engine 配置。路径前缀同样被排除，因为 Docker Engine 解释镜像 URL 路径的方式与镜像仓库前缀不同。

Docker Engine 通过 HTTPS 连接镜像，因此沙箱必须信任该镜像呈现的证书。对于使用内部 证书颁发机构的镜像，请把该 CA 添加到沙箱的系统信任存储。请参阅 合并 Kit 之后再运行安装步骤。

模板和 kit 的拉取会立即使用修改后的设置。已有沙箱会保留创建时所用的 Docker Engine 镜像配置。要把修改后的镜像应用到沙箱内的 Docker，请重新创建沙箱。

禁用镜像 ​

取消设置该值即可禁用镜像：

console
$ sbx settings unset platform.images.registryMirror

设置值为空同样会禁用镜像。请重新创建已有沙箱，才能从它们的 Docker Engine 配置中 移除镜像。