tiantian-system/public/docs/docker.md

Docker Compose 部署

一键部署全套服务（前端+后端+数据库+AI），本地与云端通用。

🐳 什么是 Docker Compose？

Docker Compose 是一个工具，用于定义和运行多容器 Docker 应用。通过一个 docker-compose.yml 文件，你可以一键启动所有相关服务。

📋 前提条件

• Docker 20.10+
• Docker Compose 2.0+
• 至少 4GB 内存

🚀 快速开始

第一步：下载模板

# 克隆模板仓库
git clone https://github.com/websopy/deploy-templates.git websopy-deploy
cd websopy-deploy

# 选择版本
git checkout v2.3.0

第二步：配置环境

# 复制环境变量文件
cp .env.example .env

# 编辑配置
nano .env

关键配置：

# 版本
WEBSOPY_VERSION=2.3.0

# 数据库
POSTGRES_DB=websopy
POSTGRES_USER=websopy
POSTGRES_PASSWORD=your-strong-password

# Redis
REDIS_PASSWORD=your-redis-password

# JWT 密钥（生成随机字符串）
JWT_SECRET=$(openssl rand -hex 32)

# 域名（可选）
DOMAIN=your-domain.com

第三步：启动服务

# 一键启动所有服务
docker-compose up -d

# 查看服务状态
docker-compose ps

# 查看日志
docker-compose logs -f

第四步：验证部署

# 检查服务健康状态
curl http://localhost:3000/api/health

# 预期输出
{"status":"ok","version":"2.3.0","services":{"db":"up","redis":"up","ai":"up"}}

🏗️ 服务架构

                    ┌─────────────┐
                    │   Nginx     │
                    │  (反向代理)   │
                    └──────┬──────┘
                           │
           ┌───────────────┼───────────────┐
           │               │               │
      ┌────▼────┐    ┌─────▼────┐    ┌────▼────┐
      │  Web    │    │   API    │    │  Worker │
      │ (前端)   │    │ (后端)    │    │ (异步)   │
      └─────────┘    └─────┬────┘    └─────────┘
                           │
              ┌────────────┼────────────┐
              │            │            │
         ┌────▼───┐  ┌─────▼────┐  ┌───▼────┐
         │Postgres│  │  Redis   │  │  AI    │
         │(数据库) │  │ (缓存)    │  │(AI服务) │
         └────────┘  └──────────┘  └────────┘

📁 目录结构

websopy-deploy/
├── docker-compose.yml     # 服务编排文件
├── .env                   # 环境变量
├── nginx/
│   └── conf.d/           # Nginx 配置
├── postgres/
│   └── init.sql          # 数据库初始化脚本
└── backups/              # 备份目录

🔧 常用命令

启动与停止

# 启动所有服务
docker-compose up -d

# 停止所有服务
docker-compose down

# 重启所有服务
docker-compose restart

# 重启指定服务
docker-compose restart api

日志查看

# 查看所有日志
docker-compose logs -f

# 查看特定服务日志
docker-compose logs -f api
docker-compose logs -f web

# 查看最近 100 行
docker-compose logs --tail=100

进入容器

# 进入 API 容器
docker-compose exec api sh

# 进入数据库
docker-compose exec postgres psql -U websopy

💾 数据持久化

数据存储在 Docker volumes 中：

# 查看 volumes
docker volume ls | grep websopy

# 备份数据
docker-compose exec postgres pg_dump -U websopy > backup.sql

# 恢复数据
docker exec -i $(docker-compose ps -q postgres) psql -U websopy < backup.sql

🔄 常用配置

调整资源

# docker-compose.yml
services:
  api:
    deploy:
      resources:
        limits:
          cpus: '2'
          memory: 4G

  worker:
    deploy:
      resources:
        limits:
          cpus: '4'
          memory: 8G

自定义端口

services:
  nginx:
    ports:
      - "80:80"
      - "443:443"
  # 改成本地其他端口
  # - "8080:80"

启用 HTTPS

# 复制 SSL 证书
mkdir -p nginx/ssl
cp your-cert.crt nginx/ssl/cert.pem
cp your-cert.key nginx/ssl/key.pem

# 编辑 nginx 配置
nano nginx/conf.d/default.conf

🐛 故障排查

服务无法启动

# 1. 检查 Docker 是否运行
docker info

# 2. 查看详细日志
docker-compose up

# 3. 检查端口占用
lsof -i :80

数据库连接失败

# 1. 检查 postgres 是否运行
docker-compose ps postgres

# 2. 查看数据库日志
docker-compose logs postgres

# 3. 测试连接
docker-compose exec postgres psql -U websopy -c "SELECT 1"

前端无法访问

# 1. 检查 nginx 日志
docker-compose logs nginx

# 2. 检查 web 容器
docker-compose logs web

# 3. 重建前端
docker-compose up -d --force-recreate web

🧹 清理

# 停止并删除容器
docker-compose down

# 删除数据卷（谨慎！）
docker-compose down -v

# 完全清理
docker system prune -a

---

上一步： AI 工作流配置
下一步： 版本升级与回滚