新版官网模板

content/docs/deploy/docker.md

@@ -0,0 +1,195 @@
+---
+title: Docker Compose 部署
+description: 一键部署全套服务（前端+后端+数据库+AI），本地与云端通用。
+category: deploy
+order: 1
+---
+
+# Docker Compose 部署
+
+> 一键部署全套服务（前端+后端+数据库+AI），本地与云端通用。
+
+## 🐳 什么是 Docker Compose？
+
+Docker Compose 是一个工具，用于定义和运行多容器 Docker 应用。通过一个 `docker-compose.yml` 文件，你可以一键启动所有相关服务。
+
+## 📋 前提条件
+
+- Docker 20.10+
+- Docker Compose 2.0+
+- 至少 4GB 内存
+
+## 🚀 快速开始
+
+### 第一步：下载模板
+
+```bash
+# 克隆模板仓库
+git clone https://github.com/websopy/deploy-templates.git websopy-deploy
+cd websopy-deploy
+
+# 选择版本
+git checkout v2.3.0
+```
+
+### 第二步：配置环境
+
+```bash
+# 复制环境变量文件
+cp .env.example .env
+
+# 编辑配置
+nano .env
+```
+
+关键配置：
+
+```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
+```
+
+### 第三步：启动服务
+
+```bash
+# 一键启动所有服务
+docker-compose up -d
+
+# 查看服务状态
+docker-compose ps
+
+# 查看日志
+docker-compose logs -f
+```
+
+### 第四步：验证部署
+
+```bash
+# 检查服务健康状态
+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服务) │
+         └────────┘  └──────────┘  └────────┘
+```
+
+## 🔧 常用命令
+
+### 启动与停止
+
+```bash
+# 启动所有服务
+docker-compose up -d
+
+# 停止所有服务
+docker-compose down
+
+# 重启所有服务
+docker-compose restart
+
+# 重启指定服务
+docker-compose restart api
+```
+
+### 日志查看
+
+```bash
+# 查看所有日志
+docker-compose logs -f
+
+# 查看特定服务日志
+docker-compose logs -f api
+docker-compose logs -f web
+
+# 查看最近 100 行
+docker-compose logs --tail=100
+```
+
+### 进入容器
+
+```bash
+# 进入 API 容器
+docker-compose exec api sh
+
+# 进入数据库
+docker-compose exec postgres psql -U websopy
+```
+
+## 💾 数据持久化
+
+数据存储在 Docker volumes 中：
+
+```bash
+# 查看 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
+```
+
+## 🐛 故障排查
+
+### 服务无法启动
+
+```bash
+# 1. 检查 Docker 是否运行
+docker info
+
+# 2. 查看详细日志
+docker-compose up
+
+# 3. 检查端口占用
+lsof -i :80
+```
+
+### 数据库连接失败
+
+```bash
+# 1. 检查 postgres 是否运行
+docker-compose ps postgres
+
+# 2. 查看数据库日志
+docker-compose logs postgres
+
+# 3. 测试连接
+docker-compose exec postgres psql -U websopy -c "SELECT 1"
+```