mirror of
https://github.com/jeequan/jeepay.git
synced 2026-09-03 06:34:47 +08:00
1e58fd5490
目标：门面文档只放"最常用"，把"深水区"分到独立文件，按需查阅。 README（299 → 205 行）： - 合并 "为什么选择 Jeepay" + "适用场景" 为 "Jeepay 适合谁" 一节。 - 删除 "系统能力概览"（信息已在项目简介 + Jeepay 适合谁里）。 - 删除 "快速开始"（环境要求 / 代码获取 / 首次启动流程都在 docs/deploy/* 里更详细）。 - 删除 "在线体验" + "版本与兼容性说明"（前者并入"贡献与协作"尾行， 后者内容已散在 CONTRIBUTING.md / upgrade.md 里）。 - "贡献与协作"段一句话指向 CONTRIBUTING.md，不再重复列清单。 docs/deploy/shell.md（248 → 79 行）：只保留"5 分钟上手 + 常用命令 + 卸载 + 高级覆盖项表"。移除宿主端口冲突详解、HTTPS 反代、RocketMQ 排查、 ARM64 说明等细节段，全部外迁。 docs/deploy/compose.md（218 → 63 行）：目录约定 + 启动命令 + 端口 / 账号 + 常用命令；移除镜像发布章节（对终端用户无用）外迁。 docs/deploy/troubleshooting.md（31 → 132 行）：从 shell.md 吸收 RocketMQ 启动失败、brokerIP 缓存问题、WebSocket 101 卡住、application.yml 变目录、 镜像 403、打包排障现场等排障条目，成为统一的故障诊断入口。 新增 docs/deploy/https.md（88 行）：域名 + HTTPS 反代模板（从 shell.md 搬出），含 nginx 配置示例、certbot 申请命令、第三方支付回调 URL 注意 事项、防火墙建议。 新增 docs/deploy/publish.md（62 行）：Docker Hub / 华为云 SWR 镜像发布 脚本说明（从 compose.md 搬出），只给维护者看。 净删除 528 行，新增 211 行；整体更紧凑，每篇文档聚焦单一主题。
89 lines
3.4 KiB
Markdown
89 lines
3.4 KiB
Markdown
# 域名 + HTTPS 反代
|
||
|
||
jeepay 三个平台的公网接入需要在 19216 / 19217 / 19218 前面再架一层 nginx + SSL。本文给出可直接抄的模板。
|
||
|
||
## 代码层面已就绪
|
||
|
||
- 内置 `nginx.conf` 三个 server 都已补 `X-Forwarded-Proto` / `X-Forwarded-Port` / `proxy_http_version 1.1` / WebSocket 头 / 长超时。
|
||
- Spring Boot 已开启 `server.forward-headers-strategy: framework`。
|
||
|
||
外层反代只要照下面模板写，回跳 URL / WebSocket / 微信支付 H5 redirect 都会自动拼对。
|
||
|
||
## 推荐拓扑：三个子域名
|
||
|
||
| 外部域名 | 用途 | 内部回源 |
|
||
|---|---|---|
|
||
| `admin.example.com` | 运营平台 | `http://127.0.0.1:19217` |
|
||
| `mch.example.com` | 商户平台 | `http://127.0.0.1:19218` |
|
||
| `pay.example.com` | 支付网关 + 收银台 | `http://127.0.0.1:19216` |
|
||
|
||
## 外层 nginx 模板
|
||
|
||
```nginx
|
||
server {
|
||
listen 443 ssl http2;
|
||
server_name pay.example.com;
|
||
ssl_certificate /etc/ssl/jeepay/pay.crt;
|
||
ssl_certificate_key /etc/ssl/jeepay/pay.key;
|
||
|
||
location / {
|
||
proxy_pass http://127.0.0.1:19216;
|
||
proxy_http_version 1.1; # 必须，否则 WS 会被隐式关闭
|
||
|
||
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; # 必须，否则 Spring Boot 拼 http:// 回调
|
||
proxy_set_header X-Forwarded-Port $server_port;
|
||
|
||
# WebSocket（商户端支付测试 / 收银台订单推送）
|
||
proxy_set_header Upgrade $http_upgrade;
|
||
proxy_set_header Connection "upgrade";
|
||
proxy_read_timeout 3600s; # 默认 60s，长连接会静默断
|
||
proxy_send_timeout 3600s;
|
||
}
|
||
}
|
||
# admin / mch 域名同构，仅 proxy_pass 换为 19217 / 19218
|
||
```
|
||
|
||
## 快速申请 Let's Encrypt 证书
|
||
|
||
```bash
|
||
# 宿主机（不是容器内）
|
||
yum install -y nginx certbot python3-certbot-nginx # Ubuntu: apt-get -y install ...
|
||
certbot --nginx -d admin.example.com -d mch.example.com -d pay.example.com \
|
||
--agree-tos -m you@example.com --redirect
|
||
```
|
||
|
||
`certbot --nginx` 会自动给你上面写的 server 块加 `listen 443 ssl` + cert 路径 + HTTP→HTTPS 301。
|
||
|
||
## 第三方支付平台回调 URL
|
||
|
||
去微信 / 支付宝 / 云闪付后台，异步通知 / 回跳 URL 必须填**公网域名**，不要填内网 IP：
|
||
|
||
```
|
||
https://pay.example.com/api/pay/notify/...
|
||
https://pay.example.com/api/anon/paySuccess?...
|
||
```
|
||
|
||
## 验证
|
||
|
||
```bash
|
||
# 握手 101 + Spring Boot 能识别 https
|
||
curl -s -I https://admin.example.com/api/anon/auth/vercode?t=$(date +%s) | head -3
|
||
# 收银台
|
||
curl -s -o /dev/null -w "%{http_code}\n" https://pay.example.com/cashier/index.html
|
||
```
|
||
|
||
访问 `https://admin.example.com` 登录、`https://mch.example.com` 发起支付测试，浏览器 DevTools Network 里 WS 连接应该能持续收到订单状态推送。
|
||
|
||
## 防火墙
|
||
|
||
- 公网必须开：`80` `443`
|
||
- 公网建议关：`19216` / `19217` / `19218`（已通过 80/443 反代提供）
|
||
|
||
## 不同拓扑的取舍
|
||
|
||
- **单域名 + 路径前缀**（比如 `https://www.example.com/admin/`）：需要同步改前端 `publicPath` + Spring Boot `context-path`，工作量大，不推荐新手。
|
||
- **只对外暴露收银台**：SaaS / 电商最常用，公网只放 `pay.example.com`，运营 / 商户平台留内网。防火墙只开一个子域对应的 80/443。
|