快速上手 Docker Agent：让 AI 成为你的容器管理助手
在现代 DevOps 流程中，管理 Docker 容器往往需要记忆大量的 CLI 命令。而 **Docker Agent** 的出现，让我们可以通过自然语言与 Docker 交互，极大提升了开发和运维效率。
本文将分享如何在 Windows 环境下快速安装并配置 Docker Agent，并成功运行起来。
🚀 快速安装
根据你的环境，选择最适合的安装方式：
1. Windows (最快方式)
推荐使用 `winget` 包管理器，一行命令搞定：
```powershell
winget install Docker.Agent
```
安装完成后，可以通过以下命令验证版本：
```powershell
docker-agent version
```
2. Docker Desktop (开箱即用)
如果你安装了 **Docker Desktop 4.63+** 版本，Docker Agent 已经内置其中。直接在终端运行：
```bash
docker agent version
```
3. 其他平台
-
**macOS/Linux (Homebrew):** `brew install docker-agent`
-
**二进制安装:** 从 GitHub Releases(https://github.com/docker/docker-agent/releases) 下载对应系统的二进制文件并添加到环境变量 `PATH` 中。
⚙️ 核心配置
安装完成后，Docker Agent 需要一个"大脑"（LLM API Key）才能工作。
1. 配置文件路径
Docker Agent 在 Windows 上默认读取配置目录：
`C:\Users\<你的用户名>\.config\cagent\`
2. 配置 API Key
你可以通过环境变量或配置文件来设置 API Key。为了持久化，建议创建 `.env` 文件：
**PowerShell 快速配置脚本：**
```powershell
创建配置目录
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.config\cagent"
写入 API Key (以 NVIDIA 为例)
"NVIDIA_API_KEY=你的密钥" | Out-File -FilePath "$env:USERPROFILE\.config\cagent\.env" -Encoding utf8
```
*支持的提供商包括：OpenAI, Anthropic, Google Gemini, NVIDIA 等。*
🏃♂️ 启动与运行
在实际运行中，如果你处于需要代理的网络环境，记得在启动前配置好代理，否则 Agent 可能无法连接到 AI 模型服务器。
启动脚本示例 (`starts.ps1`)
为了方便每次快速启动，建议准备一个简单的 PowerShell 脚本：
```powershell
1. 配置网络代理
$env:HTTPS_PROXY="http://127.0.0.1:10809"
$env:HTTP_PROXY="http://127.0.0.1:10809"
$env:NO_PROXY="127.0.0.1,localhost"
2. 设置 API Key (如果 .env 没生效可以手动指定)
$env:NVIDIA_API_KEY="你的密钥nvapi-xxx"
3. 运行 Agent 并指定模型
推荐尝试 google/gemma-4-31b-it，响应速度与效果平衡较好
docker-agent run --model nvidia/google/gemma-4-31b-it
```
常用模型选择
你可以根据需求在 `run` 命令后通过 `--model` 参数切换模型：
-
`nvidia/google/gemma-4-31b-it` (推荐)
-
`nvidia/nvidia/nemotron-3-super-120b-a12b` (强大但较慢)
-
`nvidia/moonshotai/kimi-k3` (中文能力强)
🛠️ 故障排除
如果你不确定配置是否正确，可以使用内置的诊断命令：
```powershell
docker-agent doctor
```
如果输出显示 `User configuration: ok`，说明你的配置文件路径和权限没有问题。