jczxw-pc/content/docs/deploy/docker.md

title, description, category, order

title	description	category	order
Docker Compose 部署	一键部署全套服务（前端+后端+数据库+AI），本地与云端通用。	deploy	1

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服务) │
         └────────┘  └──────────┘  └────────┘

🔧 常用命令

启动与停止

# 启动所有服务
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

🐛 故障排查

服务无法启动

# 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"