更改 Docker Desktop 设置

使用 Docker Desktop 的设置来自定义其行为并优化性能和资源使用。

打开 Settings 有两种方式：

• 选择 Docker 菜单 ，然后选择 Settings
• 从 Docker Desktop 仪表板中选择 Settings 图标。

您也可以找到 settings-store.json 文件：

• Mac: ~/Library/Group\ Containers/group.com.docker/settings-store.json
• Windows: C:\Users\[USERNAME]\AppData\Roaming\Docker\settings-store.json
• Linux: ~/.docker/desktop/settings-store.json

有关在组织级别强制执行设置的信息，请参阅 Settings Management。

General

配置 Docker Desktop 的启动行为、UI 外观、终端偏好和功能默认值。

Resources

控制可供 Docker Desktop 使用的 CPU、内存、磁盘、文件共享、代理和网络资源。

Advanced

在 WSL 2 模式下，请在 WSL 2 utility VM 上配置内存、CPU 和交换限制。

Tip

如果您感觉 Docker Desktop 开始变慢或运行多容器工作负载，请增加内存和磁盘映像空间分配。

File sharing

使用文件共享允许您机器上的本地目录与 Linux 容器共享。这对于在主机上的 IDE 中编辑源代码同时在容器中运行和测试代码特别有用。

• 只共享您需要与容器共享的目录。文件共享会引入开销，因为主机上文件的任何更改都需要通知 Linux VM。共享过多文件会导致高 CPU 负载和文件系统性能变慢。
• 共享文件夹设计用于允许应用程序代码在主机上编辑，同时在容器中执行。对于缓存目录或数据库等非代码项，如果它们存储在 Linux VM 中，使用 data volume（命名卷）或 data container 性能会好得多。
• 如果您将整个主目录共享到容器中，Mac 可能会提示您授予 Docker 访问主目录中个人区域（如提醒事项或下载）的权限。
• 默认情况下，Mac 文件系统不区分大小写，而 Linux 区分大小写。在 Linux 上，可以创建两个独立的文件：test 和 Test，而在 Mac 上这些文件名实际上指的是同一个基础文件。这可能导致应用程序在开发人员机器上工作正常（文件内容被共享），但在 Linux 生产环境中运行时失败（文件内容不同）。为避免这种情况，Docker Desktop 坚持所有共享文件必须以其原始大小写访问。因此，如果创建了一个名为 test 的文件，它必须以 test 打开。尝试打开 Test 将失败，错误为 "No such file or directory"。同样，一旦创建了名为 test 的文件，尝试创建名为 Test 的第二个文件将失败。

有关更多信息，请参阅 Volume mounting requires file sharing for any project directories outside of /Users。

Proxies

Docker Desktop 支持 HTTP/HTTPS 和 SOCKS5 代理。SOCKS5 需要 Business 订阅。

要防止开发人员意外更改代理设置，请参阅 Settings Management。

Docker Desktop proxy

用于 Docker Desktop 主机级别的流量：登录 Docker、Desktop 应用程序、CLI 和扩展。仅在未配置 Containers proxy 时，作为 docker image pull 的回退。

Note

如果您使用托管在 Web 服务器上的 PAC 文件，请为 .pac 扩展名添加 MIME 类型 application/x-ns-proxy-autoconfig。否则 PAC 文件可能无法正确解析。请参阅 Hardened Docker Desktop。

Containers proxy

用于 docker image pull（始终强制执行——所有 docker pull 和 Compose 拉取操作都经过此代理）以及在配置了气隙容器强制时来自运行中的容器的出站流量。如果在此配置了 PAC 文件，请确保它为 Docker 注册表端点返回合适的代理服务器，否则镜像拉取将失败。

Note

用于镜像扫描的 HTTPS 代理使用 HTTPS_PROXY 环境变量配置。

Proxy authentication

Network

Note

在 Windows 上，Network 选项卡在 Windows 容器模式下不可用，因为 Windows 管理网络。

在 Windows 和 Mac 上，您还可以设置默认网络模式和 DNS 解析行为。更多信息请参阅 Networking。

WSL integration (Windows only)

有关配置 Docker Desktop 使用 WSL 2 的更多详细信息，请参阅 Docker Desktop WSL 2 backend。

Docker Engine

使用 JSON 配置文件配置 Docker 守护进程。

该文件位于 $HOME/.docker/daemon.json。可直接在 Docker Desktop 仪表板或文本编辑器中编辑它。

要查看可能的配置选项的完整列表，请参阅 dockerd command reference。

Builders

使用 Builders 选项卡在 Docker Desktop 设置中检查和管理构建器。

Inspect

要检查构建器，找到您要检查的构建器并选择展开图标。您只能检查活动构建器。

检查活动构建器会显示：

• BuildKit 版本
• 状态
• 驱动类型
• 支持的功能和平台
• 磁盘使用情况
• 端点地址

Select a different builder

Selected builder 部分显示所选的构建器。 要选择不同的构建器：

1. 在 Available builders 下找到您要使用的构建器
2. 打开构建器名称旁边的下拉菜单。
3. 选择 Use 切换到此构建器。

您的构建命令现在默认使用所选的构建器。

Create a builder

要创建构建器，请使用 Docker CLI。请参阅 Create a new builder

Remove a builder

如果满足以下条件，您可以删除构建器：

• 构建器不是您的 selected builder

• 构建器未 与 Docker 上下文关联。

  要删除与 Docker 上下文关联的构建器，请使用 docker context rm 命令删除上下文。

要删除构建器：

1. 在 Available builders 下找到您要删除的构建器
2. 打开下拉菜单。
3. 选择 Remove 删除此构建器。

如果构建器使用 docker-container 或 kubernetes 驱动，构建缓存和构建器也会被删除。

Stop and start a builder

使用 docker-container 驱动 的构建器在容器中运行 BuildKit 守护进程。 您可以使用下拉菜单启动和停止 BuildKit 容器。

如果容器已停止，运行构建会自动启动容器。

您只能启动和停止使用 docker-container 驱动的构建器。

AI

在 AI 选项卡中，您可以配置以下设置：

• Gordon，可针对您的 Docker 工作流执行操作的 AI 驱动助手。
• Docker Model Runner，让您可以轻松使用 Docker 管理、运行和部署 AI 模型。

Kubernetes

Note

在 Windows 上，Kubernetes 选项卡在 Windows 容器模式下不可用。

启用并配置内置的独立 Kubernetes 集群以测试容器部署。

有关将 Kubernetes 集成与 Docker Desktop 一起使用的更多信息，请参阅 Explore the Kubernetes view。

Software updates

管理 Docker Desktop 检查和下载更新的方式和时间。

Extensions

启用 Docker 扩展并控制哪些扩展可供安装和运行。

有关 Docker 扩展的更多信息，请参阅 Docker Extensions。

Beta features

Beta 功能提供对未来产品功能的访问。 这些功能仅用于测试和反馈，因为它们可能在版本之间更改或完全移除。Beta 功能不得在生产环境中使用。Docker 不为 beta 功能提供支持。

您还可以从 Beta features 选项卡注册 Developer Preview program。

有关 Docker CLI 当前实验功能的列表，请参阅 Docker CLI Experimental features。

Notifications

选择您想要接收的 Docker Desktop 通知类型。

通知会短暂显示在 Docker Desktop 仪表板的右下角，然后移动到可从仪表板右上角访问的 Notifications 抽屉中。

Advanced (Mac only)

重新配置初始安装期间设置的 CLI 工具安装路径和特权系统权限。

Docker Offload

启用 Docker Offload 并配置基于云的工作负载的空闲超时和 GPU 支持。