AI Agent Docker Compose部署：单机多服务编排

📘 教程 2026-07-17 · 更新于 2026-08-27 约 2 分钟阅读

💡 你将学到

AI Agent Docker Compose部署：单机多服务编排

📜 目录

一、为什么用Compose
二、目录结构
三、完整的docker-compose.yml
四、常用命令
五、生产化注意
常见问题
相关文章

AI Agent Docker Compose部署：单机多服务编排

一个正经的Agent系统很少只有一个进程：API服务、向量库、缓存、任务队列、模型运行器，往往要五六个服务一起跑。手动一个个启动既容易漏又难管理。Docker Compose用一份YAML声明所有服务，一条命令拉起、一条命令停止，是单机部署的事实标准。这篇给出一套可以直接抄的完整配置。

一、为什么用Compose

方案	优点	缺点
裸进程（systemd）	无额外依赖	依赖顺序自己管、环境不一致
单个Docker容器	环境隔离	多服务时启动顺序、网络、日志全靠手
Docker Compose	一份文件管全部、可复现	只适合单机（多机用K8s）

二、目录结构

my-agent/
├── docker-compose.yml
├── .env                    # 密钥、端口等配置
└── agent/
    ├── Dockerfile
    └── app.py

三、完整的docker-compose.yml

services:
  api:                                # Agent API服务
    build: ./agent
    ports: ["8000:8000"]
    env_file: .env
    depends_on:
      redis:
        condition: service_healthy
      postgres:
        condition: service_healthy
    restart: unless-stopped

  redis:                              # 缓存 + 限流计数
    image: redis:7-alpine
    volumes: ["redis-data:/data"]
    healthcheck:
      test: ["CMD", "redis-cli", "ping"]
      interval: 5s
      retries: 5

  postgres:                           # 业务数据 + 向量数据
    image: postgres:16-alpine
    environment:
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
    volumes: ["pg-data:/var/lib/postgresql/data"]
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U postgres"]
      interval: 5s
      retries: 5

  ollama:                             # 本地模型（可选）
    image: ollama/ollama
    volumes: ["ollama-data:/root/.ollama"]
    ports: ["11434:11434"]

volumes:
  redis-data:
  pg-data:
  ollama-data:

关键点：

depends_on + healthcheck：保证redis和postgres就绪后再启动api，避免启动即报错
数据全部挂volume：容器删了数据还在
env_file: .env：密钥不进代码仓库
restart: unless-stopped：进程崩了自动拉起

四、常用命令

命令	作用
`docker compose up -d`	后台启动全部服务
`docker compose logs -f api`	跟踪某个服务的日志
`docker compose ps`	查看各服务状态
`docker compose restart api`	重启单个服务
`docker compose pull && docker compose up -d`	升级镜像
`docker compose down`	停止并删除容器（数据卷保留）

五、生产化注意

资源限制：给每个服务设mem_limit，防止Ollama把内存吃光连累API服务
日志轮转：加 logging: {options: {max-size: "10m", max-file: "3"}}，防止日志撑爆磁盘
密钥管理：.env不要提交git，服务器上单独放一份
升级策略：先 docker compose pull 看镜像更新，再 up -d；出问题用 docker compose down && docker compose up -d 回滚