Files
MTKJPAY/DEPLOYMENT_README.md
qiube a3633577b4 feat(config): 更新配置以支持HTTPS域名访问
- 将所有环境的前端URL从localhost和IP地址更新为https://shopd.mtkj2025.com
- 配置PayPal webhook使用HTTPS域名以满足PayPal安全要求
- 统一后端服务端口从18082调整为8082
- 更新Java代码中的默认URL配置和启动日志信息
- 创建域名配置、Nginx SSL配置和公网访问检查清单文档
- 为商品链接生成和API访问配置HTTPS协议支持
2025-12-26 15:18:34 +08:00

2.3 KiB
Raw Blame History

部署说明

快速部署指南

后端部署

  1. 配置文件已更新

    • app.frontend.url 已设置为 http://175.178.252.59公网地址通过Nginx访问
    • paypal.webhook-url 已设置为 https://175.178.252.59/api/paypal/webhookHTTPSPayPal要求
    • 后端端口已设置为 8082
    • 前端 .env.production 已创建API地址为 /api(相对路径)
  2. 打包应用

    cd E:\MTKJPAY
    mvn clean package -DskipTests
    
  3. 上传并启动

    # 上传 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. 构建前端

    cd E:\MTKJPAY-FRONT
    npm run build
    
  2. 本地测试打包结果(验证打包是否正确)

    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. 上传到服务器

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

    • 如果服务器已有Web服务器将dist内容放到Web根目录
    • 确保支持Vue Router的history模式配置 try_files

配置检查清单

部署前请检查以下配置:

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