Files

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

5.3 KiB

Raw Blame History

Nginx SSL配置指南（PayPal Webhook必需）

问题说明

PayPal Webhook **只接受HTTPS（端口443）**的URL，不接受HTTP或其他端口。

当前配置：

❌ http://175.178.252.59:8082/api/paypal/webhook - PayPal不接受
✅ https://175.178.252.59/api/paypal/webhook - PayPal接受

解决方案

需要通过Nginx配置SSL证书，将HTTPS请求转发到后端的HTTP服务。

配置步骤

1. 在宝塔面板中配置SSL证书

进入网站设置
- 宝塔面板 → 网站 → 选择你的网站（175.178.252.59）
- 点击"设置" → "SSL"
申请或配置SSL证书

选项A：使用Let's Encrypt免费证书（推荐）
- 点击"Let's Encrypt"
- 输入域名（如果有）或使用IP地址
- 点击"申请"
- 等待证书申请完成
选项B：使用自签名证书（仅测试用）
- 点击"自签证书"
- 生成自签名证书
- ⚠️ 注意：自签名证书PayPal可能不接受，建议使用Let's Encrypt
启用HTTPS
- 证书申请成功后，点击"强制HTTPS"
- 保存配置

2. 配置Nginx反向代理（SSL）

在宝塔面板中：

网站 → 设置 → 配置文件
找到 location /api/ 配置块
确保配置如下：

# HTTP请求重定向到HTTPS（可选，如果启用了强制HTTPS）
# server {
#     listen 80;
#     server_name 175.178.252.59;
#     return 301 https://$server_name$request_uri;
# }

# HTTPS服务器配置
server {
    listen 443 ssl http2;
    listen [::]:443 ssl http2;
    server_name 175.178.252.59;
    
    # SSL证书配置（宝塔会自动配置）
    ssl_certificate /www/server/panel/vhost/cert/175.178.252.59/fullchain.pem;
    ssl_certificate_key /www/server/panel/vhost/cert/175.178.252.59/privkey.pem;
    
    # SSL配置（宝塔会自动配置）
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ciphers HIGH:!aNULL:!MD5;
    ssl_prefer_server_ciphers on;
    
    root /www/wwwroot/175.178.252.59;
    index index.html index.htm;
    
    # 前端路由配置
    location / {
        try_files $uri $uri/ /index.html;
    }
    
    # API反向代理（关键配置）
    location /api/ {
        proxy_pass http://127.0.0.1:8082;  # 转发到后端HTTP服务
        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;  # 传递原始协议（HTTPS）
        
        # WebSocket支持（如果需要）
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        
        # 超时配置
        proxy_connect_timeout 60s;
        proxy_send_timeout 60s;
        proxy_read_timeout 60s;
    }
    
    # 静态资源缓存
    location ~ .*\.(gif|jpg|jpeg|png|bmp|swf)$ {
        expires 30d;
    }
    
    location ~ .*\.(js|css)?$ {
        expires 12h;
    }
}

3. 修改后端配置

后端配置文件已更新：

application-dev.yml: paypal.webhook-url: https://175.178.252.59/api/paypal/webhook

4. 更新PayPal控制台

在PayPal控制台中配置Webhook URL：

Webhook URL: https://175.178.252.59/api/paypal/webhook
✅ 使用HTTPS（不是HTTP）
✅ 不指定端口（默认443）
✅ 通过Nginx转发到后端

5. 验证配置

测试HTTPS访问
```
curl https://175.178.252.59/api/health
```

测试Webhook端点

curl -X POST https://175.178.252.59/api/paypal/webhook \
  -H "Content-Type: application/json" \
  -d '{"test": "data"}'

检查PayPal Webhook配置
- 在PayPal控制台测试Webhook
- 应该不再显示端口错误

重要提示

SSL证书是必需的
- PayPal只接受HTTPS
- 建议使用Let's Encrypt免费证书
- 自签名证书PayPal可能不接受
Nginx配置要点
- 监听443端口（HTTPS）
- 将 /api/ 请求转发到 http://127.0.0.1:8082
- 设置 X-Forwarded-Proto 头，让后端知道原始请求是HTTPS
后端不需要修改
- 后端仍然监听8082端口（HTTP）
- Nginx负责SSL终止和转发
防火墙配置
- 确保443端口已开放
- 80端口可以重定向到443

常见问题

Q1: 没有域名，只有IP地址，能申请SSL证书吗？

A: Let's Encrypt需要域名，不能为IP地址签发证书。解决方案：

使用自签名证书（PayPal可能不接受）
使用内网穿透服务（如ngrok、cpolar）提供HTTPS
申请一个域名并解析到服务器IP

Q2: 使用自签名证书PayPal会接受吗？

A: 通常不会。PayPal会验证SSL证书的有效性，自签名证书会被拒绝。建议：

使用Let's Encrypt免费证书（需要域名）
或使用内网穿透服务

Q3: 如何测试Webhook是否正常工作？

在PayPal控制台发送测试Webhook
查看后端日志，确认收到请求
检查Nginx访问日志和错误日志

配置检查清单

SSL证书已申请并配置
Nginx监听443端口
/api/ 路径正确转发到 http://127.0.0.1:8082
后端配置中的webhook URL已改为HTTPS
PayPal控制台Webhook URL已更新为 https://175.178.252.59/api/paypal/webhook
443端口已开放防火墙
测试HTTPS访问正常

5.3 KiB Raw Blame History Unescape Escape