docker engine 实验性功能需在 dockerd 和 docker cli 两端分别启用:修改 daemon.json 设 "experimental": true 并重启服务,再于 ~/.docker/config.json 设 "experimental": "enabled" 或设环境变量 docker_cli_experimental=enabled。
docker engine 的实验性功能需要分别在服务端(dockerd)和客户端(docker cli)两个层面开启,二者独立控制、缺一不可。默认情况下,实验性功能全部关闭,必须显式启用才能使用 --platform、buildx、docker scout 等特性。
开启 Dockerd(守护进程)的实验模式
这是启用 --platform 等底层能力的前提。需修改守护进程配置文件:
- Linux 系统路径为
/etc/docker/daemon.json;Windows Server 或 WSL2 中为C:\ProgramData\Docker\config\daemon.json - 确保文件存在且是合法 JSON,添加或修改
"experimental": true字段,例如:
- 保存后重启 Docker 服务:
sudo systemctl restart docker(Linux)或通过 Windows 服务管理器重启 - 验证是否生效:
docker info | grep "Experimental",输出Experimental: true即成功
开启 Docker CLI 的实验模式
即使 dockerd 已启用,部分命令(如 docker buildx、docker scan)还需 CLI 明确支持:
MiniMax 图片理解 + 网络搜索 MCP 工具。适配 Docker 环境(极空间等),支持图片 OCR 识别、图像内容理解、网络搜索。API Key 安全存储在本地 credentials 文件,不暴露在代码中。
- 编辑用户级配置文件:
~/.docker/config.json - 添加字段
"experimental": "enabled",完整示例:
- 也可临时启用:Linux/macOS 运行
export DOCKER_CLI_EXPERIMENTAL=enabled;Windows PowerShell 执行$env:DOCKER_CLI_EXPERIMENTAL="enabled" - 无需重启,新打开的终端即可识别该设置
禁用实验性功能的方法
若后续需关闭,只需将对应配置设为 false 或 "disabled",并重启服务或重载环境变量:
-
daemon.json中改为"experimental": false,再执行systemctl restart docker -
config.json中改为"experimental": "disabled",或直接删除该字段 - Windows Desktop 用户还可通过图形界面关闭:设置 → 命令行 → 关闭“启用实验性功能”开关
注意事项与常见问题
实验功能不稳定,生产环境慎用。特别注意以下几点:
- JSON 文件中逗号不能遗漏或多余,否则 Docker 启动失败,可通过
jq . /etc/docker/daemon.json校验格式 - 修改
daemon.json后未重启服务,配置不会加载 - CLI 配置仅对当前用户生效;若用
sudo docker,需检查 root 用户的~/.docker/config.json - 某些发行版(如 CentOS Stream)的旧版 Docker 包可能不支持最新实验特性,建议使用官方源安装 24.x+ 版本










