Docker 进阶配置

普通用户首次安装只需要完成 Docker 安装。本页用于修改端口、选择其他镜像、挂载宿主目录、更新版本或迁移旧数据。

镜像类型

AgentDock 发布三种 linux/amd64 和 linux/arm64 镜像：

标签	适用场景
`latest` / `vX.Y.Z`	默认运行镜像，包含 Node.js、Python、Git、pnpm 等常用工具
`dev-latest` / `dev-vX.Y.Z`	额外包含 Go、C、C++ 和 `pkg-config` 构建链
`browser-latest` / `browser-vX.Y.Z`	额外包含 Chromium 和 browser runner

默认 Compose 使用正式运行镜像。需要在容器内编译 Go 或原生扩展时，可以在 .env 中增加：

AGENTDOCK_IMAGE=ghcr.io/uvwt/agentdock:dev-vX.Y.Z

然后重建容器：

docker compose up -d --force-recreate

dev 和 browser 是不同用途的镜像；browser 镜像不默认包含 Go 编译器。

启用浏览器自动化

下载与当前 Release 配套的浏览器 Compose 文件：

macOS / Linux：

curl -fL https://github.com/uvwt/agentdock/releases/latest/download/docker-compose.browser.yml \
  -o docker-compose.browser.yml

Windows PowerShell：

Invoke-WebRequest `
  https://github.com/uvwt/agentdock/releases/latest/download/docker-compose.browser.yml `
  -OutFile docker-compose.browser.yml

启动浏览器镜像：

docker compose -f docker-compose.yml -f docker-compose.browser.yml up -d

该镜像会启用 browser_* 工具，并把浏览器共享内存提高到 1 GB。浏览器 profile、截图和会话状态仍保存在 AgentDock 数据卷中。

浏览器会话应使用独立 profile_id，不要挂载日常浏览器的完整用户目录。

修改本机端口

默认 MCP 地址是 http://127.0.0.1:18766/mcp。端口冲突时，在 .env 中增加：

AGENTDOCK_PUBLISH_PORT=18767

然后重新启动：

docker compose up -d --force-recreate

新的 MCP 地址将变为 http://127.0.0.1:18767/mcp。

默认只监听本机回环地址。不要为了方便直接改成 0.0.0.0；需要局域网或公网访问时，先阅读安全模型。

数据保存在哪里

默认 Compose 使用两个 Docker named volume：

agentdock_home       -> /home/agentdock/.agentdock
agentdock_workspace  -> /home/agentdock/AgentDock

agentdock_home：任务、Skill、动态 MCP、环境配置和运行产物。
agentdock_workspace：文件、命令和 Git 工具的默认工作目录。

查看实际卷名：

docker compose config --volumes

docker compose down 不会删除这些数据。

挂载宿主项目目录

需要让 AgentDock 直接操作宿主项目时，可以把工作目录改成 bind mount：

services:
  agentdock:
    volumes:
      - agentdock_home:/home/agentdock/.agentdock
      - ./AgentDock:/home/agentdock/AgentDock

Linux 主机应确保容器用户 UID/GID 10001 可以写入该目录：

mkdir -p AgentDock
sudo chown -R 10001:10001 AgentDock

只挂载任务需要的目录。AgentDock 不把工作目录当成安全沙箱；容器能访问哪些文件，取决于你实际挂载了什么。

固定版本

从 GitHub Release 下载的 Compose 文件已经固定到对应版本，不会隐式切换到新的 latest。

需要下载指定版本时：

VERSION=vX.Y.Z
curl -fL "https://github.com/uvwt/agentdock/releases/download/$VERSION/docker-compose.yml" \
  -o docker-compose.yml
curl -fL "https://github.com/uvwt/agentdock/releases/download/$VERSION/docker-compose.browser.yml" \
  -o docker-compose.browser.yml

Windows 用户可把 curl -fL ... -o ... 换成 Invoke-WebRequest ... -OutFile ...。

更新 AgentDock

普通镜像：

curl -fL https://github.com/uvwt/agentdock/releases/latest/download/docker-compose.yml \
  -o docker-compose.yml
docker compose pull
docker compose up -d --force-recreate

浏览器镜像还需要重新下载 docker-compose.browser.yml，随后继续同时传入两份 Compose 文件。

更新后执行：

docker compose ps

确认状态重新变为 healthy。

从 v0.4.1 或更早版本迁移

旧版 Compose 默认把 ./AgentDockHome 和 ./AgentDock 直接挂载到容器。已有数据时不要直接删除这两个目录。

可以继续使用原目录，但要把容器内路径改成新版位置：

services:
  agentdock:
    volumes:
      - ./AgentDockHome:/home/agentdock/.agentdock
      - ./AgentDock:/home/agentdock/AgentDock

Linux 主机还需要调整目录所有权：

sudo chown -R 10001:10001 AgentDockHome AgentDock

确认新容器能看到原任务、Skill、MCP 配置和项目文件后，再决定是否迁移到 named volume。不要让两个运行中的 AgentDock 实例同时使用同一份状态目录。

查看日志与停止服务

# 持续查看日志
docker compose logs -f

# 停止并移除容器，保留数据
docker compose down

浏览器部署执行这些命令时，应继续同时传入两份 Compose 文件。

删除全部 Docker 数据

只有确认不再需要任务、Skill、MCP 配置和项目文件后，才执行：

docker compose down -v

危险

镜像类型​

启用浏览器自动化​

修改本机端口​

数据保存在哪里​

挂载宿主项目目录​

固定版本​

更新 AgentDock​

从 v0.4.1 或更早版本迁移​

查看日志与停止服务​

删除全部 Docker 数据​