252 lines
4.8 KiB
Markdown
252 lines
4.8 KiB
Markdown
# 🚀 DesignerCEP 完整部署指南
|
||
|
||
## 📊 最终架构
|
||
|
||
```
|
||
app.aidg168.uk → 前端应用（Caddy 静态文件）
|
||
backend.aidg168.uk → 后端 API（FastAPI + MySQL）
|
||
```
|
||
|
||
---
|
||
|
||
## 📁 项目目录结构
|
||
|
||
```
|
||
DesignerCEP/
|
||
│
|
||
├── Designer/ ← 前端源代码
|
||
│ ├── src/ ← Vue 源码
|
||
│ ├── dist_core/ ← ⭐ 构建输出（需要复制到 Server）
|
||
│ ├── package.json
|
||
│ └── vite.config.ts
|
||
│
|
||
├── Server/ ← 后端 + 部署配置
|
||
│ ├── app/ ← 后端代码（FastAPI）
|
||
│ │ ├── api/ ← API 路由
|
||
│ │ ├── models/ ← 数据模型
|
||
│ │ └── main.py ← 入口文件
|
||
│ │
|
||
│ ├── static/ ← ⭐ 前端文件放这里
|
||
│ │ └── app/ ← ⭐ Designer/dist_core/ 复制到这里
|
||
│ │ ├── index.html
|
||
│ │ ├── assets/
|
||
│ │ └── ...
|
||
│ │
|
||
│ ├── archives/ ← Core 版本压缩包
|
||
│ ├── docker-compose.yml ← Docker 配置
|
||
│ ├── Dockerfile ← 后端镜像
|
||
│ ├── requirements.txt ← Python 依赖
|
||
│ └── mysql.cnf ← MySQL 配置
|
||
│
|
||
├── Caddyfile ← Caddy 配置
|
||
└── AdminTool/ ← 自动化部署工具
|
||
```
|
||
|
||
---
|
||
|
||
## 🔧 本地准备（您现在要做的）
|
||
|
||
### 步骤 1：构建前端
|
||
|
||
```bash
|
||
cd Designer
|
||
npm install
|
||
npm run build:core
|
||
```
|
||
|
||
**输出**：`Designer/dist_core/` 目录
|
||
|
||
### 步骤 2：复制前端到 Server
|
||
|
||
```powershell
|
||
# 在项目根目录执行
|
||
xcopy /E /Y Designer\dist_core\* Server\static\app\
|
||
```
|
||
|
||
**验证**：
|
||
```bash
|
||
dir Server\static\app\
|
||
# 应该看到：
|
||
# - index-core.html
|
||
# - assets/
|
||
# - CSInterface.js
|
||
# - vite.svg
|
||
```
|
||
|
||
### 步骤 3：配置环境变量
|
||
|
||
复制 `Server/.env.example` 为 `Server/.env`，并修改：
|
||
|
||
```env
|
||
ENV=production
|
||
SECRET_KEY=修改为随机密钥
|
||
ALLOWED_ORIGINS=https://app.aidg168.uk,https://backend.aidg168.uk
|
||
SMTP_USER=您的邮箱
|
||
SMTP_PASSWORD=您的邮箱密码
|
||
```
|
||
|
||
---
|
||
|
||
## 📤 上传到服务器
|
||
|
||
### 方法 A：打包上传（推荐）
|
||
|
||
```powershell
|
||
# 1. 压缩 Server 文件夹
|
||
Compress-Archive -Path Server\* -DestinationPath DesignerCEP-Server.zip
|
||
|
||
# 2. 上传到服务器
|
||
scp DesignerCEP-Server.zip root@103.97.201.136:/root/
|
||
|
||
# 3. 上传 Caddyfile
|
||
scp Caddyfile root@103.97.201.136:/etc/caddy/Caddyfile
|
||
```
|
||
|
||
### 方法 B：使用自动化脚本
|
||
|
||
```bash
|
||
cd AdminTool
|
||
python auto_deploy_core.py --version 1.0.0 --deploy
|
||
```
|
||
|
||
---
|
||
|
||
## 🐳 服务器部署
|
||
|
||
### SSH 登录服务器
|
||
|
||
```bash
|
||
ssh root@103.97.201.136
|
||
```
|
||
|
||
### 步骤 1：解压文件
|
||
|
||
```bash
|
||
cd /root
|
||
unzip DesignerCEP-Server.zip -d /var/www/DesignerCEP/Server
|
||
cd /var/www/DesignerCEP/Server
|
||
```
|
||
|
||
### 步骤 2：配置 Caddy
|
||
|
||
```bash
|
||
# Caddyfile 已上传到 /etc/caddy/Caddyfile
|
||
|
||
# 验证配置
|
||
caddy validate --config /etc/caddy/Caddyfile
|
||
|
||
# 重启 Caddy
|
||
systemctl restart caddy
|
||
systemctl status caddy
|
||
```
|
||
|
||
### 步骤 3：启动 Docker 服务
|
||
|
||
```bash
|
||
cd /var/www/DesignerCEP/Server
|
||
|
||
# 启动所有服务（Caddy + FastAPI + MySQL）
|
||
docker-compose up -d
|
||
|
||
# 查看日志
|
||
docker-compose logs -f
|
||
|
||
# 查看运行状态
|
||
docker-compose ps
|
||
```
|
||
|
||
---
|
||
|
||
## ✅ 验证部署
|
||
|
||
### 1. 检查服务状态
|
||
|
||
```bash
|
||
# Caddy
|
||
systemctl status caddy
|
||
|
||
# Docker 服务
|
||
docker-compose ps
|
||
```
|
||
|
||
### 2. 测试 API
|
||
|
||
```bash
|
||
curl https://backend.aidg168.uk/health
|
||
# 期望：{"status":"healthy"}
|
||
```
|
||
|
||
### 3. 测试前端
|
||
|
||
浏览器访问：
|
||
```
|
||
https://app.aidg168.uk/
|
||
```
|
||
|
||
**期望**：能看到登录页面
|
||
|
||
---
|
||
|
||
## 📋 完整部署清单
|
||
|
||
- [ ] 前端已构建：`Designer/dist_core/`
|
||
- [ ] 前端已复制到：`Server/static/app/`
|
||
- [ ] Server 文件夹已打包
|
||
- [ ] Caddyfile 已上传到服务器
|
||
- [ ] Server 已上传并解压
|
||
- [ ] `.env` 已配置
|
||
- [ ] Caddy 已重启
|
||
- [ ] Docker 服务已启动
|
||
- [ ] `https://app.aidg168.uk/` 可访问
|
||
- [ ] `https://backend.aidg168.uk/health` 可访问
|
||
|
||
---
|
||
|
||
## 🎯 快速命令汇总
|
||
|
||
### 本地准备
|
||
|
||
```powershell
|
||
# 1. 构建前端
|
||
cd Designer
|
||
npm run build:core
|
||
|
||
# 2. 复制前端到 Server
|
||
cd ..
|
||
xcopy /E /Y Designer\dist_core\* Server\static\app\
|
||
|
||
# 3. 检查文件
|
||
dir Server\static\app\
|
||
|
||
# 4. 打包 Server
|
||
Compress-Archive -Path Server\* -DestinationPath Server.zip
|
||
```
|
||
|
||
### 服务器部署
|
||
|
||
```bash
|
||
# 1. 上传文件
|
||
scp Server.zip root@103.97.201.136:/root/
|
||
scp Caddyfile root@103.97.201.136:/etc/caddy/Caddyfile
|
||
|
||
# 2. SSH 登录
|
||
ssh root@103.97.201.136
|
||
|
||
# 3. 解压并部署
|
||
cd /root
|
||
unzip Server.zip -d /var/www/DesignerCEP/Server
|
||
cd /var/www/DesignerCEP/Server
|
||
|
||
# 4. 启动服务
|
||
systemctl restart caddy
|
||
docker-compose up -d
|
||
|
||
# 5. 查看日志
|
||
docker-compose logs -f
|
||
```
|
||
|
||
---
|
||
|
||
**完成后访问 https://app.aidg168.uk/ 测试！** 🎉
|
||
|