# 宝塔面板部署指南 - 服务器 121.41.52.85

## 部署信息

| 项目 | 值 |
|------|---|
| 服务器 IP | `121.41.52.85` |
| 管理员端域名 | `dda.gaowenbu.cn` |
| 业务员端域名 | `ddy.gaowenbu.cn` |
| 后端端口 | `127.0.0.1:8000` |
| 项目路径 | `/www/wwwroot/order-flow` |

---

## 一、服务器环境准备

### 1.1 安装宝塔面板

```bash
# CentOS/RHEL
yum install -y wget && wget -O install.sh https://download.bt.cn/install/install_6.0.sh && sh install.sh

# Ubuntu/Debian
wget -O install.sh https://download.bt.cn/install/install-ubuntu_6.0.sh && sudo bash install.sh
```

安装完成后，记录宝塔面板的外网地址、用户名和密码。

### 1.2 宝塔面板安装软件

登录宝塔面板后，在「软件商店」中安装以下软件：

| 软件 | 版本建议 | 用途 |
|------|---------|------|
| **Nginx** | 1.24+ | 反向代理 + 前端静态文件 |
| **MySQL** | 5.7 或 8.0 | 数据库（如果用远程数据库可跳过） |
| **Redis** | 7.0+ | 缓存 |
| **Python 项目管理器** | 最新版 | 管理 Python 虚拟环境和后端进程 |

### 1.3 DNS 解析配置

在域名管理后台（阿里云/腾讯云/Cloudflare等）添加两条 A 记录：

```
dda.gaowenbu.cn  →  121.41.52.85
ddy.gaowenbu.cn  →  121.41.52.85
```

---

## 二、上传代码到服务器

### 2.1 创建项目目录

通过宝塔面板「文件」功能或 SSH，创建目录：

```bash
mkdir -p /www/wwwroot/order-flow
```

### 2.2 上传文件

**方式一：Git 拉取（推荐）**

```bash
cd /www/wwwroot/
git clone <你的仓库地址> order-flow
```

**方式二：宝塔面板上传**

1. 在本地将项目打包为 zip（排除 `node_modules`、`__pycache__`、`.git`）
2. 在宝塔「文件」页面上传到 `/www/wwwroot/order-flow/`
3. 在线解压

**方式三：scp 上传**

```bash
# 本地执行
scp -r ./dingdanquanliucheng root@121.41.52.85:/www/wwwroot/order-flow
```

### 2.3 上传后的目录结构

```
/www/wwwroot/order-flow/
├── backend/
│   ├── app/
│   ├── migrations/
│   ├── scripts/
│   ├── .env              ← 生产环境配置
│   ├── requirements.txt
│   └── main.py
├── frontend/
│   ├── web-admin/
│   │   ├── src/
│   │   ├── .env.production
│   │   └── package.json
│   └── web-sales/
│       ├── src/
│       ├── .env.production
│       └── package.json
└── deploy/
    ├── dda.gaowenbu.cn.conf
    └── ddy.gaowenbu.cn.conf
```

---

## 三、配置后端环境

### 3.1 修改后端配置文件

编辑 `/www/wwwroot/order-flow/backend/.env`：

**如果使用本机 MySQL 数据库**，修改以下配置：

```bash
MYSQL_HOST=127.0.0.1
MYSQL_PORT=3306
MYSQL_DATABASE=order_flow
MYSQL_USER=order_flow
MYSQL_PASSWORD=你的数据库密码
```

**如果继续使用远程数据库**（fn.taisan.online），保持现有配置不变。

### 3.2 创建数据库（如果使用本机数据库）

1. 宝塔面板 → 数据库 → MySQL → 添加数据库
2. 填写：
   - 数据库名：`order_flow`
   - 用户名：`order_flow`
   - 密码：`（设置一个强密码）`
   - 访问权限：`本地服务器`

3. 确保 `backend/.env` 中的数据库配置与上一步一致

---

## 四、部署后端（Python 项目管理器）

### 4.1 安装 Python 项目管理器

宝塔面板 → 软件商店 → 搜索「Python项目管理器」→ 安装

### 4.2 创建 Python 项目

1. 打开「Python项目管理器」
2. 点击「添加项目」，填写：

| 配置项 | 值 |
|--------|---|
| 项目名称 | `order-flow` |
| 项目路径 | `/www/wwwroot/order-flow/backend` |
| Python版本 | `3.10` 或 `3.11` |
| 启动文件 | `main.py` |
| 启动方式 | `uvicorn` |
| 端口 | `8000` |
| 绑定地址 | `127.0.0.1` |
| 开机自启 | ✅ 勾选 |

3. 点击「确定」创建项目

### 4.3 安装 Python 依赖

项目创建后，点击项目右侧「终端」按钮，执行：

```bash
pip install -r requirements.txt
```

或者在 Python 项目管理器中：
- 点击项目 → 「模块」→ 「安装依赖」→ 选择 `requirements.txt`

### 4.4 安装 Redis

1. 宝塔面板 → 软件商店 → 搜索「Redis」→ 安装
2. 默认配置即可（127.0.0.1:6379）

### 4.5 启动后端服务

在 Python 项目管理器中点击「启动」按钮。

验证后端是否正常：

```bash
curl http://127.0.0.1:8000/api/health
```

如果返回 JSON 响应，说明后端启动成功。

---

## 五、部署前端

### 5.1 方式一：在本地构建后上传（推荐）

在本地执行：

```bash
# 构建管理员端
cd frontend/web-admin
npm install
npm run build
# 产物在 frontend/web-admin/dist/

# 构建业务员端
cd ../web-sales
npm install
npm run build
# 产物在 frontend/web-sales/dist/
```

然后将 `dist` 目录上传到服务器：
- `web-admin/dist/` → `/www/wwwroot/order-flow/frontend/web-admin/dist/`
- `web-sales/dist/` → `/www/wwwroot/order-flow/frontend/web-sales/dist/`

### 5.2 方式二：在服务器上构建

```bash
# 安装 Node.js（如果未安装）
# 宝塔面板 → 软件商店 → 搜索「Node.js版本管理器」→ 安装

cd /www/wwwroot/order-flow/frontend/web-admin
npm install
npm run build

cd /www/wwwroot/order-flow/frontend/web-sales
npm install
npm run build
```

---

## 六、配置 Nginx 站点

### 6.1 创建管理员端站点（dda.gaowenbu.cn）

1. 宝塔面板 → 网站 → 添加站点
2. 填写：
   - 域名：`dda.gaowenbu.cn`
   - 根目录：`/www/wwwroot/order-flow/frontend/web-admin/dist`
   - PHP版本：`纯静态`
3. 点击「提交」

### 6.2 配置管理员端 Nginx

点击站点 `dda.gaowenbu.cn` 右侧「设置」→「配置文件」，将内容替换为：

```nginx
server
{
    listen 80;
    listen 443 ssl;
    listen 443 quic;
    http2 on;
    http3 on;
    server_name dda.gaowenbu.cn;
    index index.html;
    root /www/wwwroot/order-flow/frontend/web-admin/dist;

    # SSL 证书路径（宝塔自动申请后会生成）
    ssl_certificate    /www/server/panel/vhost/cert/dda.gaowenbu.cn/fullchain.pem;
    ssl_certificate_key    /www/server/panel/vhost/cert/dda.gaowenbu.cn/privkey.pem;
    ssl_protocols TLSv1.1 TLSv1.2 TLSv1.3;
    ssl_ciphers EECDH+CHACHA20:EECDH+CHACHA20-draft:EECDH+AES128:RSA+AES128:EECDH+AES256:RSA+AES256:EECDH+3DES:RSA+3DES:!MD5;
    ssl_prefer_server_ciphers on;
    ssl_session_tickets on;
    ssl_session_cache shared:SSL:10m;
    ssl_session_timeout 10m;
    add_header Strict-Transport-Security "max-age=31536000";

    # HTTP 跳转 HTTPS
    if ($server_port != 443) {
        rewrite ^(/.*)$ https://$host$1 permanent;
    }

    # 禁止访问敏感文件
    location ~* \.(env|git|svn|htaccess|htpasswd)$ {
        return 404;
    }

    # 后端 API 反向代理
    location /api/ {
        proxy_pass http://127.0.0.1:8000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        client_max_body_size 20m;
    }

    # WebSocket 反向代理
    location /ws/ {
        proxy_pass http://127.0.0.1:8000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_read_timeout 86400s;
        proxy_send_timeout 86400s;
    }

    # 健康检查
    location = /health {
        proxy_pass http://127.0.0.1:8000;
        proxy_set_header Host $host;
    }

    # 上传文件代理
    location /uploads/ {
        proxy_pass http://127.0.0.1:8000;
        proxy_set_header Host $host;
    }

    # Vue SPA 路由
    location / {
        try_files $uri $uri/ /index.html;
    }

    # 静态资源缓存
    location ~ .*\.(gif|jpg|jpeg|png|bmp|swf|ico)$ {
        expires 30d;
        error_log /dev/null;
        access_log /dev/null;
    }

    location ~ .*\.(js|css)?$ {
        expires 12h;
        error_log /dev/null;
        access_log /dev/null;
    }

    access_log /www/wwwlogs/dda.gaowenbu.cn.log;
    error_log /www/wwwlogs/dda.gaowenbu.cn.error.log;
}
```

### 6.3 创建业务员端站点（ddy.gaowenbu.cn）

1. 宝塔面板 → 网站 → 添加站点
2. 填写：
   - 域名：`ddy.gaowenbu.cn`
   - 根目录：`/www/wwwroot/order-flow/frontend/web-sales/dist`
   - PHP版本：`纯静态`
3. 点击「提交」

### 6.4 配置业务员端 Nginx

点击站点 `ddy.gaowenbu.cn` 右侧「设置」→「配置文件」，将内容替换为：

```nginx
server
{
    listen 80;
    listen 443 ssl;
    listen 443 quic;
    http2 on;
    http3 on;
    server_name ddy.gaowenbu.cn;
    index index.html;
    root /www/wwwroot/order-flow/frontend/web-sales/dist;

    # SSL 证书路径
    ssl_certificate    /www/server/panel/vhost/cert/ddy.gaowenbu.cn/fullchain.pem;
    ssl_certificate_key    /www/server/panel/vhost/cert/ddy.gaowenbu.cn/privkey.pem;
    ssl_protocols TLSv1.1 TLSv1.2 TLSv1.3;
    ssl_ciphers EECDH+CHACHA20:EECDH+CHACHA20-draft:EECDH+AES128:RSA+AES128:EECDH+AES256:RSA+AES256:EECDH+3DES:RSA+3DES:!MD5;
    ssl_prefer_server_ciphers on;
    ssl_session_tickets on;
    ssl_session_cache shared:SSL:10m;
    ssl_session_timeout 10m;
    add_header Strict-Transport-Security "max-age=31536000";

    # HTTP 跳转 HTTPS
    if ($server_port != 443) {
        rewrite ^(/.*)$ https://$host$1 permanent;
    }

    # 禁止访问敏感文件
    location ~* \.(env|git|svn|htaccess|htpasswd)$ {
        return 404;
    }

    # 后端 API 反向代理
    location /api/ {
        proxy_pass http://127.0.0.1:8000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        client_max_body_size 20m;
    }

    # WebSocket 反向代理
    location /ws/ {
        proxy_pass http://127.0.0.1:8000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_read_timeout 86400s;
        proxy_send_timeout 86400s;
    }

    # 健康检查
    location = /health {
        proxy_pass http://127.0.0.1:8000;
        proxy_set_header Host $host;
    }

    # 上传文件代理
    location /uploads/ {
        proxy_pass http://127.0.0.1:8000;
        proxy_set_header Host $host;
    }

    # Vue SPA 路由
    location / {
        try_files $uri $uri/ /index.html;
    }

    # 静态资源缓存
    location ~ .*\.(gif|jpg|jpeg|png|bmp|swf|ico)$ {
        expires 30d;
        error_log /dev/null;
        access_log /dev/null;
    }

    location ~ .*\.(js|css)?$ {
        expires 12h;
        error_log /dev/null;
        access_log /dev/null;
    }

    access_log /www/wwwlogs/ddy.gaowenbu.cn.log;
    error_log /www/wwwlogs/ddy.gaowenbu.cn.error.log;
}
```

---

## 七、配置 SSL 证书（HTTPS）

### 7.1 方式一：宝塔自动申请 Let's Encrypt 证书（推荐）

1. 宝塔面板 → 网站 → 点击站点 `dda.gaowenbu.cn` → 设置 → SSL
2. 选择「Let's Encrypt」→ 勾选域名 → 点击「申请」
3. 同样操作 `ddy.gaowenbu.cn`
4. 申请成功后，开启「强制HTTPS」开关

### 7.2 方式二：使用已有证书

如果已有 SSL 证书文件（项目中的 `dda.gaowenbu.cn_nginx/` 和 `ddy.gaowenbu.cn_nginx/` 目录）：

1. 将证书文件上传到服务器：
   - `dda.gaowenbu.cn` 的证书 → `/www/server/panel/vhost/cert/dda.gaowenbu.cn/`
   - `ddy.gaowenbu.cn` 的证书 → `/www/server/panel/vhost/cert/ddy.gaowenbu.cn/`

2. 证书文件重命名：
   - `*_bundle.pem` 或 `*_bundle.crt` → `fullchain.pem`
   - `*.key` → `privkey.pem`

---

## 八、防火墙配置

宝塔面板 → 安全 → 防火墙，确保放行以下端口：

| 端口 | 协议 | 用途 |
|------|------|------|
| 80 | TCP | HTTP |
| 443 | TCP | HTTPS |
| 8888 | TCP | 宝塔面板（建议改端口） |

> 后端 8000 端口**不需要**对外开放，只通过 Nginx 反向代理访问。

---

## 九、部署验证

### 9.1 服务验证命令

```bash
# 1. 检查后端是否运行
curl http://127.0.0.1:8000/api/health

# 2. 检查 Nginx 是否正常
curl -I https://dda.gaowenbu.cn
curl -I https://ddy.gaowenbu.cn

# 3. 检查 API 代理是否正常
curl https://dda.gaowenbu.cn/api/health

# 4. 检查 WebSocket 连接
curl -i -N -H "Connection: Upgrade" -H "Upgrade: websocket" https://dda.gaowenbu.cn/ws/test
```

### 9.2 浏览器访问验证

- [ ] `https://dda.gaowenbu.cn` 能打开管理员登录页
- [ ] `https://ddy.gaowenbu.cn` 能打开业务员登录页
- [ ] 登录功能正常（默认管理员账号：`admin01`）
- [ ] API 请求正常（F12 Network 检查，无 CORS 错误）
- [ ] WebSocket 连接正常

### 9.3 微信小程序验证

1. 登录微信公众平台：https://mp.weixin.qq.com
2. 开发管理 → 服务器域名 → 添加：
   - request合法域名：`https://dda.gaowenbu.cn`
   - uploadFile合法域名：`https://dda.gaowenbu.cn`
   - downloadFile合法域名：`https://dda.gaowenbu.cn`
3. 小程序重新提交审核

---

## 十、常见问题排查

### Q1: 页面打开是 404 或空白

```bash
# 检查前端 dist 目录是否存在
ls -la /www/wwwroot/order-flow/frontend/web-admin/dist/
ls -la /www/wwwroot/order-flow/frontend/web-sales/dist/

# 检查是否有 index.html
cat /www/wwwroot/order-flow/frontend/web-admin/dist/index.html
```

### Q2: API 请求 502 Bad Gateway

```bash
# 检查后端进程是否运行
ps aux | grep uvicorn

# 查看后端日志
tail -f /www/wwwroot/order-flow/backend/logs/*.log

# 在 Python 项目管理器中重启项目
```

### Q3: API 请求 CORS 错误

检查 `backend/.env` 中 `CORS_ALLOW_ORIGINS` 是否包含当前域名：

```bash
grep CORS /www/wwwroot/order-flow/backend/.env
```

应包含：`https://dda.gaowenbu.cn,https://ddy.gaowenbu.cn`

### Q4: 数据库连接失败

```bash
# 测试数据库连接
mysql -h 127.0.0.1 -u order_flow -p order_flow

# 检查 MySQL 服务状态
systemctl status mysql
# 或
bt mysql status
```

### Q5: Redis 连接失败

```bash
# 测试 Redis 连接
redis-cli ping

# 检查 Redis 服务状态
systemctl status redis
```

### Q6: WebSocket 连接失败

检查 Nginx 配置中 WebSocket 代理是否正确，确保：
- `proxy_http_version 1.1;`
- `proxy_set_header Upgrade $http_upgrade;`
- `proxy_set_header Connection "upgrade";`

### Q7: 上传文件失败

```bash
# 创建本地上传目录
mkdir -p /tmp/order-flow-oss/local-uploads
chmod 755 /tmp/order-flow-oss/local-uploads
```

---

## 十一、日常维护

### 更新代码

```bash
cd /www/wwwroot/order-flow
git pull

# 重新构建前端
cd frontend/web-admin && npm run build
cd ../web-sales && npm run build

# 重启后端
# 在宝塔 Python 项目管理器中点击「重启」
```

### 查看日志

```bash
# 后端日志
tail -f /www/wwwlogs/dda.gaowenbu.cn.log
tail -f /www/wwwlogs/dda.gaowenbu.cn.error.log

# Nginx 日志
tail -f /www/server/nginx/logs/error.log
```

### 数据库备份

1. 宝塔面板 → 数据库 → 选择 `order_flow` → 备份
2. 设置定时备份（建议每天备份一次）

---

## 十二、部署检查清单

完成部署后，逐项检查：

- [ ] DNS 解析已生效（`ping dda.gaowenbu.cn` 返回 `121.41.52.85`）
- [ ] MySQL 服务运行正常
- [ ] Redis 服务运行正常
- [ ] 后端 Python 项目已启动
- [ ] `curl http://127.0.0.1:8000/api/health` 返回正常
- [ ] Nginx 配置已加载（宝塔面板重启 Nginx）
- [ ] SSL 证书已申请并配置
- [ ] `https://dda.gaowenbu.cn` 可访问
- [ ] `https://ddy.gaowenbu.cn` 可访问
- [ ] 登录功能正常
- [ ] 微信小程序域名已配置

---

**部署完成！** 如有问题，请查看「常见问题排查」部分或检查日志文件。