# 部署指南（VPS + Cloudflare 域名）

目标：`https://pay.你的域名/` 对外提供收银页、体验页与商户 API。

## 0. 选 VPS 的唯一硬要求：能直连币安 API

币安对部分地区 IP（如美国）返回 `451 Service unavailable from a restricted location`。
香港、新加坡、日本等机房通常可用。开机后先验：

```bash
curl -s https://api.binance.com/api/v3/ping && echo OK
```

配置 1 核 1G 足够；网关是单进程、SQLite、每 3–4 秒一次 API 调用。

## 1. 安装

```bash
# 在 VPS 上（Debian/Ubuntu 为例）
sudo useradd -r -s /usr/sbin/nologin bpg
sudo mkdir -p /opt/bpaygate && sudo chown bpg:bpg /opt/bpaygate
# 方式一：本机交叉编译后上传
#   cd server && GOOS=linux GOARCH=amd64 CGO_ENABLED=0 go build -trimpath -buildvcs=false -ldflags="-s -w" -o bpaygate-linux .
#   （-trimpath 与 -buildvcs=false 使构建可复现：同一提交在任何机器上得到相同哈希，便于核对线上版本）
#   scp bpaygate-linux vps:/opt/bpaygate/bpaygate
# 方式二：VPS 上有 Go 直接 git clone 后 go build
```

## 2. 配置

```bash
sudo -u bpg cp config.example.env /opt/bpaygate/config.env
sudo -u bpg /opt/bpaygate/bpaygate -gen-key   # 得到 API_AUTH_KEY
sudo -u bpg nano /opt/bpaygate/config.env
sudo chmod 600 /opt/bpaygate/config.env
```

必填：`BASE_URL=https://pay.你的域名`、`API_AUTH_KEY`、`BINANCE_API_KEY/SECRET`（只读，**绑定 VPS 出口 IP**）、`BINANCE_UID`。
对外体验建议：`DEMO_ENABLED=true`、`DEMO_AMOUNTS=0.5,1`、`RECEIVE_LINK=<收款二维码解码内容>`（见下）。

### 拿到 RECEIVE_LINK

币安 App → 支付 → 收款 → 保存二维码，用任意扫码工具读出内容，通常是 `https://app.binance.com/...` 形式的链接。
填入后网关会：① 服务端生成同样的二维码给桌面端扫；② 在手机端收银页放「打开币安 App」按钮直接唤起。
不填则只提供手动转账模式（或用 `QR_IMAGE` 指向二维码图片文件，仅提供扫码）。

## 3. 起服务

```bash
sudo cp deploy/bpaygate.service /etc/systemd/system/
sudo systemctl daemon-reload && sudo systemctl enable --now bpaygate
sudo journalctl -u bpaygate -f      # 看到「监听 0.0.0.0:8080」即正常
```

网关只监听本机即可（`LISTEN=127.0.0.1:8080`），对外由下面的入口层负责 HTTPS。

## 4. 对外 HTTPS（二选一）

**方案 B · Cloudflare Tunnel（推荐）**：不开公网端口、证书全托管、VPS 防火墙可以全关。
按 `deploy/cloudflared.yml` 头部注释五步走完，Cloudflare DNS 里会自动出现 `pay.你的域名` 的 CNAME。

**方案 A · Caddy**：`deploy/Caddyfile` 改域名后 `caddy run`，Cloudflare DNS 记录开代理时把 SSL/TLS 设为 **Full (strict)**。

## 5. 上线检查

- `curl https://pay.你的域名/healthz` 返回 `{"ok":true}`
- 打开 `https://pay.你的域名/demo`，手机与桌面各走一遍
- 币安后台确认 API Key 已绑定 VPS IP、仅读取权限
- 定期把收款账户余额转走，收款专号不放大额

## 6. 升级

替换二进制后 `sudo systemctl restart bpaygate`。数据库 schema 自动迁移（`CREATE IF NOT EXISTS`）。
核对线上版本：本机从目标提交用上面的可复现命令构建，`sha256sum` 与服务器上 `/opt/bpaygate/bpaygate` 一致即为同一份代码。