Docker 部署

使用 Docker 容器化部署 TaskFlow AI

---

📋 前置要求

• Docker 已安装（≥ 20.0）
• Docker Compose 已安装（可选）

---

🚀 快速开始

拉取镜像

docker pull agions/taskflow-ai:latest

运行容器

docker run --rm -i agions/taskflow-ai:latest mcp start

---

📦 Docker Compose

基本配置

version: '3.8'
services:
  taskflow:
    image: agions/taskflow-ai:latest
    volumes:
      - ./project:/workspace
    working_dir: /workspace
    stdin_open: true
    tty: false

带环境变量

version: '3.8'
services:
  taskflow:
    image: agions/taskflow-ai:latest
    volumes:
      - ./project:/workspace
    working_dir: /workspace
    environment:
      - TASKFLOW_LOG_LEVEL=debug
      - TASKFLOW_TIMEOUT=60
    stdin_open: true
    tty: false

多项目支持

version: '3.8'
services:
  taskflow-project-a:
    image: agions/taskflow-ai:latest
    volumes:
      - ./project-a:/workspace
    working_dir: /workspace
    stdin_open: true
    tty: false

  taskflow-project-b:
    image: agions/taskflow-ai:latest
    volumes:
      - ./project-b:/workspace
    working_dir: /workspace
    stdin_open: true
    tty: false

---

🔧 配置选项

环境变量

变量	说明	默认值
TASKFLOW_LOG_LEVEL	日志级别	info
TASKFLOW_WORK_DIR	工作目录	/workspace
TASKFLOW_TIMEOUT	操作超时 (秒)	30
TASKFLOW_MAX_MEMORY	最大内存 (MB)	512

Docker 运行参数

docker run \
  --rm \
  -i \
  -v /path/to/project:/workspace \
  -e TASKFLOW_LOG_LEVEL=debug \
  agions/taskflow-ai:latest mcp start

---

📊 资源限制

内存限制

docker run --rm -i --memory=512m agions/taskflow-ai:latest mcp start

CPU 限制

docker run --rm -i --cpus="1.0" agions/taskflow-ai:latest mcp start

完整示例

docker run --rm -i \
  --memory=512m \
  --cpus="1.0" \
  -v /path/to/project:/workspace \
  -e TASKFLOW_LOG_LEVEL=debug \
  agions/taskflow-ai:latest mcp start

---

🔗 MCP 客户端配置

Claude Desktop

{
  "mcpServers": {
    "taskflow": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-v",
        "/path/to/project:/workspace",
        "agions/taskflow-ai:latest"
      ]
    }
  }
}

Cursor / Windsurf

{
  "mcpServers": {
    "taskflow": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-v",
        "${workspaceFolder}:/workspace",
        "agions/taskflow-ai:latest"
      ]
    }
  }
}

---

🐛 故障排查

问题	解决方案
镜像拉取失败	检查网络连接，使用国内镜像源
容器启动失败	检查 Docker 版本和权限
权限错误	确保 Docker 有文件访问权限
性能问题	增加资源限制

---

🔗 相关链接

• 安装指南
• Claude Desktop 集成
• Cursor 集成

---

Docker 部署有问题随时问我