MTKJPAY/DEPLOYMENT_README.md

# 部署说明

## 快速部署指南

### 后端部署

1. **配置文件已更新**
   - ✅ `app.frontend.url` 已设置为 `http://175.178.252.59`（公网地址，通过Nginx访问）
   - ✅ `paypal.webhook-url` 已设置为 `https://175.178.252.59/api/paypal/webhook`（HTTPS，PayPal要求）
   - ✅ 后端端口已设置为 `8082`
   - ✅ 前端 `.env.production` 已创建，API地址为 `/api`（相对路径）

2. **打包应用**
   ```bash
   cd E:\MTKJPAY
   mvn clean package -DskipTests
   ```

3. **上传并启动**
   ```bash
   # 上传 jar 文件到服务器
   # 启动应用
   java -jar mt-pay-0.0.1-SNAPSHOT.jar --spring.profiles.active=dev
   
   # 或后台运行
   nohup java -jar mt-pay-0.0.1-SNAPSHOT.jar --spring.profiles.active=dev > app.log 2>&1 &
   ```

### 前端部署

1. **构建前端**
   ```bash
   cd E:\MTKJPAY-FRONT
   npm run build
   ```

2. **本地测试打包结果（验证打包是否正确）**
   ```bash
   cd dist
   python -m http.server 3000
   # 或
   npx http-server -p 3000
   # 访问 http://localhost:3000（应该能看到页面，不是空白）
   ```

3. **API地址配置**
   - ✅ `.env.production` 文件已创建
   - ✅ API地址已设置为 `/api`（相对路径，通过Nginx代理）
   - ⚠️ **重要：** 必须使用相对路径 `/api`，不要使用完整URL

4. **上传到服务器**
   ```bash
   # 上传dist目录下的所有文件到服务器
   scp -r dist/* root@175.178.252.59:/path/to/web/root/
   ```

5. **服务器配置**
   - 如果服务器已有Web服务器，将dist内容放到Web根目录
   - 确保支持Vue Router的history模式（配置 `try_files`）

## 配置检查清单

部署前请检查以下配置：

- [x] 后端 `app.frontend.url` 已设置为 `http://175.178.252.59`（公网地址）
- [x] 后端 `paypal.webhook-url` 已设置为 `https://175.178.252.59/api/paypal/webhook`（HTTPS）
- [x] 后端端口已设置为 `8082`
- [x] 前端API地址已配置为 `/api`（相对路径，通过Nginx代理）
- [ ] 数据库连接信息正确
- [ ] 服务器防火墙已开放必要端口（8082等）
- [ ] **Nginx已配置SSL证书（PayPal Webhook必需）**
- [ ] PayPal控制台Webhook URL已更新为 `https://175.178.252.59/api/paypal/webhook`
- [ ] **Nginx配置中的proxy_pass端口已更新为8082**