跳到主要内容

Docker 安装

使用官方预构建镜像在隔离容器中运行 AgentDock。

Docker 无法控制 macOS 桌面；需要桌面自动化时请改用 macOS 安装。

1. 确认 Docker 可用​

docker --version
docker compose version

两条命令都能显示版本号后再继续。

2. 下载启动配置​

根据当前系统选择一组命令。

macOS / Linux​

mkdir -p agentdock && cd agentdock
curl -fL https://raw.githubusercontent.com/uvwt/agentdock/main/docker-compose.yml \
  -o docker-compose.yml
printf 'AGENTDOCK_AUTH_TOKEN=%s\n' "$(openssl rand -hex 32)" > .env

Windows PowerShell​

New-Item -ItemType Directory -Force agentdock | Out-Null
Set-Location agentdock
Invoke-WebRequest `
  https://raw.githubusercontent.com/uvwt/agentdock/main/docker-compose.yml `
  -OutFile docker-compose.yml
$token = [guid]::NewGuid().ToString("N") + [guid]::NewGuid().ToString("N")
"AGENTDOCK_AUTH_TOKEN=$token" | Set-Content -Encoding ascii .env

.env 中保存的是连接 Token。不要把它提交到 Git 或发给别人。

浏览器镜像、Tunnel、自定义端口等可选变量，可参考仓库中的 .env.example。

3. 启动并检查​

docker compose up -d
docker compose ps

第一次启动需要下载镜像。等待状态变为 healthy；如果仍是 starting，十几秒后再执行一次 docker compose ps。

4. 连接 MCP 客户端​

在客户端的 MCP、Tools 或 Connectors 设置中，新建连接：

传输方式    Streamable HTTP
地址        http://127.0.0.1:8765/mcp
请求头      Authorization: Bearer <你的 Token>

Token 是 .env 文件中 AGENTDOCK_AUTH_TOKEN= 后面的内容。

查看 Token：

# macOS / Linux
cat .env
# Windows PowerShell
Get-Content .env
提示

安装完成： docker compose ps 显示 healthy，并把 MCP 地址与 Token 填入客户端后即可使用。

可选：创建临时公网地址​

需要让其他电脑或手机临时连接时，用同一份 Compose 启动 Quick Tunnel profile：

docker compose --profile cloudflare-quick up -d

查看生成的地址：

docker compose logs -f cloudflared-quick

日志中会出现 https://…trycloudflare.com。在地址后追加 /mcp，并继续使用 .env 中的 Bearer Token 认证。

这个临时地址在容器或 Tunnel 重启后可能变化，适合测试，不适合 OAuth 或长期使用。固定域名配置见 Docker 进阶配置。

更新​

从 main 重新下载最新 docker-compose.yml，然后执行：

docker compose pull
docker compose up -d --force-recreate

使用 Cloudflare Tunnel 时，pull、up、logs 和 down 都带上同一 profile：

docker compose --profile cloudflare-quick pull
docker compose --profile cloudflare-quick up -d --force-recreate

按需继续​

  • 需要浏览器镜像、开发工具镜像、修改端口、挂载项目或迁移旧数据：阅读 Docker 进阶配置。
  • 启动失败：查看 故障排查。
  • 需要局域网或公网访问：先阅读 安全模型。