使用 JSON 文件配置设置管理

设置管理功能允许您使用 admin-settings.json 文件在整个组织中配置和强制执行 Docker Desktop 设置。这可以标准化 Docker Desktop 环境，并确保所有用户都采用一致的配置。

先决条件

在开始之前，请确保您已：

• 为您的组织 强制执行登录
• 拥有 Docker Business 订阅

admin-settings.json 文件的存在会在 Docker Desktop 上强制执行登录。这适用于需要身份验证的商业功能。

用户必须已登录并属于 Docker Business 组织。如果任一条件不满足，设置文件将被忽略。

第一步：创建设置文件

您可以通过两种方式创建 admin-settings.json 文件：

• 使用 --admin-settings 安装程序标志自动生成文件：
  • Mac 安装指南
  • Windows 安装指南
• 手动创建（UTF-8 无 BOM）并将其放置在以下位置：
  • Mac: /Library/Application Support/com.docker.docker/admin-settings.json
  • Windows: C:\ProgramData\DockerDesktop\admin-settings.json
  • Linux: /usr/share/docker-desktop/admin-settings.json

Important

将文件放在受保护的目录中，以防止未经授权的更改。使用 Jamf 等移动设备管理 (MDM) 工具在您的组织中大规模分发该文件。

第二步：配置设置

Tip

有关可用设置的完整列表、其支持的平台以及它们适用的配置方法，请参阅设置参考。

admin-settings.json 文件使用结构化键来定义可配置设置以及是否强制执行值。

每个设置都支持一个 locked 字段，用于控制用户权限：

• 当 locked 设置为 true 时，用户无法在 Docker Desktop、CLI 或配置文件中更改该值。
• 当 locked 设置为 false 时，该值充当默认建议，用户仍然可以更新它。

如果用户已在 settings-store.json、settings.json 或 daemon.json 中自定义了该值，则在现有安装上，locked 设置为 false 的设置将被忽略。

分组设置

Docker Desktop 将一些设置组合在一起，使用一个切换开关来控制整个部分。这些包括：

• 增强容器隔离 (ECI)：使用主切换开关 (enhancedContainerIsolation) 来启用/禁用整个功能，并带有特定配置的子设置。
• Kubernetes：使用主切换开关 (kubernetes.enabled) 和用于集群配置的子设置。
• Docker Scout：将设置分组在 scout 对象下。

配置分组设置时：

1. 将主切换开关设置为启用该功能。
2. 在该组内配置子设置。
3. 当您锁定主切换开关时，用户无法修改该组中的任何设置。

enhancedContainerIsolation 示例：

"enhancedContainerIsolation": {
  "locked": true,  // 这会锁定整个 ECI 部分
  "value": true,   // 这会启用 ECI
  "dockerSocketMount": {  // 这些是子设置
    "imageList": {
      "images": ["docker.io/testcontainers/ryuk:*"]
    }
  }
}

示例 admin-settings.json 文件

以下示例是一个配置了常见企业设置的 admin-settings.json 文件。您可以将此示例用作模板，并结合 admin-settings.json 配置：

{
  "configurationFileVersion": 2,
  "exposeDockerAPIOnTCP2375": {
    "locked": true,
    "value": false
  },
  "proxy": {
    "locked": true,
    "mode": "system",
    "http": "",
    "https": "",
    "exclude": [],
    "windowsDockerdPort": 65000,
    "enableKerberosNtlm": false,
    "pac": "",
    "embeddedPac": ""
  },
  "containersProxy": {
    "locked": true,
    "mode": "manual",
    "http": "",
    "https": "",
    "exclude": [],
    "pac": "",
    "embeddedPac": "",
    "transparentPorts": ""
  },
  "enhancedContainerIsolation": {
    "locked": true,
    "value": true,
    "dockerSocketMount": {
      "imageList": {
        "images": [
          "docker.io/localstack/localstack:*",
          "docker.io/testcontainers/ryuk:*"
        ]
      },
      "commandList": {
        "type": "deny",
        "commands": ["push"]
      }
    }
  },
  "linuxVM": {
    "wslEngineEnabled": {
      "locked": false,
      "value": false
    },
    "dockerDaemonOptions": {
      "locked": false,
      "value": "{\"debug\": false}"
    },
    "vpnkitCIDR": {
      "locked": false,
      "value": "192.168.65.0/24"
    }
  },
  "kubernetes": {
    "locked": false,
    "enabled": false,
    "showSystemContainers": false,
    "imagesRepository": ""
  },
  "windowsContainers": {
    "dockerDaemonOptions": {
      "locked": false,
      "value": "{\"debug\": false}"
    }
  },
  "disableUpdate": {
    "locked": false,
    "value": false
  },
  "analyticsEnabled": {
    "locked": false,
    "value": true
  },
  "extensionsEnabled": {
    "locked": true,
    "value": false
  },
  "scout": {
    "locked": false,
    "sbomIndexing": true,
    "useBackgroundIndexing": true
  },
  "allowBetaFeatures": {
    "locked": false,
    "value": false
  },
  "blockDockerLoad": {
    "locked": false,
    "value": true
  },
  "filesharingAllowedDirectories": [
    {
      "path": "$HOME",
      "sharedByDefault": true
    },
    {
      "path": "$TMP",
      "sharedByDefault": false
    }
  ],
  "useVirtualizationFrameworkVirtioFS": {
    "locked": true,
    "value": true
  },
  "useVirtualizationFrameworkRosetta": {
    "locked": true,
    "value": true
  },
  "useGrpcfuse": {
    "locked": true,
    "value": true
  },
  "displayedOnboarding": {
    "locked": true,
    "value": true
  },
  "desktopTerminalEnabled": {
    "locked": false,
    "value": false
  },
  "enableInference": {
    "locked": false,
    "value": true
  },
  "enableInferenceTCP": {
    "locked": false,
    "value": true
  },
  "enableInferenceTCPPort": {
    "locked": true,
    "value": 12434
  },
  "enableInferenceCORS": {
    "locked": true,
    "value": ""
  },
  "enableInferenceGPUVariant": {
    "locked": true,
    "value": true
  },
  "portBindingBehavior": {
    "locked": true,
    "value": "default-port-binding"
  }
}

第三步：应用设置

设置在 Docker Desktop 重启且用户登录后生效。

对于新安装：

1. 启动 Docker Desktop。
2. 使用您的 Docker 帐户登录。

对于现有安装：

1. 完全退出 Docker Desktop。
2. 重新启动 Docker Desktop。

Important

您必须完全退出并重新打开 Docker Desktop。从菜单重新启动是不够的。

admin-settings.json 配置

以下表格描述了 admin-settings.json 文件中的所有可用设置。

Note

某些设置是平台特定的或需要最低 Docker Desktop 版本。请检查"版本"列以了解要求。

常规设置

扩展

文件共享和仿真

Docker Scout

代理设置

Docker Desktop 有两个不同的代理设置，作用范围不同：

• proxy（应用代理）：作用于 Docker Desktop 主机级流量——Desktop 应用程序、Docker CLI 和扩展。当未显式配置 containersProxy 时，它也作为守护进程的回退代理。一旦设置了 containersProxy，proxy 就不再参与守护进程或容器流量。
• containersProxy：始终作用于 docker image pull。所有 docker image pull 和 Compose 拉取操作都经过 containersProxy，包括任何 PAC 文件规则。当配置了 transparentPorts 时，它也作用于运行中的容器出站流量。

Note

代理配置是一个特例，因为它必须在两个地方进行配置：

1. 在 Docker Home 中为您的组织配置。
2. 在安装了 Docker Desktop 的用户系统上配置。

在用户机器上，通过 admin-settings.json 文件或在 Docker Desktop 安装期间使用安装程序标志来配置代理。有关详细说明，请参阅 安装指南。

需要进行此额外配置，是因为 Docker Desktop 必须先知道使用哪个代理服务器，才能完成用户登录并从 Docker Home 获取组织设置。

容器代理

Linux VM 设置

Windows 容器

Note

此设置无法通过 Docker Home 进行配置。

Kubernetes 设置

Note

当将 imagesRepository 与增强容器隔离 (ECI) 一起使用时，请将这些镜像添加到 ECI Docker 套接字挂载镜像列表：

[imagesRepository]/desktop-cloud-provider-kind: [imagesRepository]/desktop-containerd-registry-mirror:

这些容器挂载了 Docker 套接字，因此您必须将它们添加到 ECI 镜像列表中。否则，ECI 会阻止挂载，Kubernetes 将无法启动。

网络设置

有关更多信息，请参阅 网络。

AI 设置

Beta 功能

Important

对于 Docker Desktop 版本 4.41 及更早版本，其中一些设置位于 功能开发 页面的 实验性功能 选项卡下。

增强容器隔离