Files
jinzuanwork/backend/deploy/nginx-片段.md
T
Suda 1d67fda9d5 backend: 交付网站后端 + 本地自助管理后台 + 测试工程(已脱敏)
范围由店主圈定:网页后端 / 自助后端、本地的自助管理后台、
用于测试的 Blender 工程、以及部署层的反代片段。

出站纪律:所有指向真实环境的值(域名/端口/盘符路径/IP/账户名)已替换为占位;
代码里本来就没有硬编码凭据(令牌走文件与环境变量)。
Blender 工程因内嵌绝对路径,做了等长替换(文件字节数未变,结构完好)。

两份交接文档各含《我们的思路与方法》,并要求对方回:
问题分析 + 改正意见 + 他改了什么(含是否动到接口/字段/数据格式)。
2026-10-05 18:52:33 +08:00

4.0 KiB
Raw Blame History

部署层 · 反向代理片段(脱敏版)

后端只绑本机回环,对外全部由 nginx 反代。这一份是跟 /order/ 相关的路由与限流, 给你看路由是怎么接的、限额是怎么设的。值已按脱敏规则替换,照形状看,别照字面抄。


一、限流区(定义在 nginx 的 http 层)

# 下单相关:一般接口 90 次/分钟,提交接口单独收紧到 10 次/分钟
limit_req_zone $binary_remote_addr zone=<ZONE_ORDER>:1m rate=90r/m;
limit_req_zone $binary_remote_addr zone=<ZONE_SUBMIT>:1m rate=10r/m;

为什么给提交接口单独一条:它是唯一会收上传的入口,也是最值得刷的入口。 别的接口刷快一点无所谓(就是查状态),提交接口必须压住。


二、/order/api/ 的路由

# ① 提交接口:单独限流 + 单独放宽请求体
location = /order/api/submit {
    limit_req zone=<ZONE_SUBMIT> burst=5 nodelay;
    limit_req_status 429;
    client_max_body_size 4m;                 # 皮肤是 base64 进来的
    proxy_pass http://localhost:<PORT>/api/submit;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr; # 后端要拿它做「单 IP 限单」
    proxy_read_timeout 120s;
    add_header Cache-Control "no-store" always;
}

# ② 回传接口:**单独一条**,因为成品一张 1~3MB(base64 后更大)
#    ⚠️ nginx 的 `location =` 精确匹配**优先于**前缀匹配 ——
#       想只给这一个路径放宽体积,不能靠下面那条前缀规则
location = /order/api/finish {
    limit_req zone=<ZONE_ORDER> burst=40 nodelay;
    limit_req_status 429;
    client_max_body_size 16m;
    proxy_pass http://localhost:<PORT>/api/finish;
    # ...
}

# ③ 其余接口
location /order/api/ {
    limit_req zone=<ZONE_ORDER> burst=40 nodelay;
    limit_req_status 429;
    proxy_pass http://localhost:<PORT>/api/;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    # ...
}

⚠️ 打包下载(zip)那条要另外配:proxy_buffering off + 更长的 proxy_read_timeout, 因为它是先落临时文件再边读边发的,不能在 nginx 这层再缓存一份(小机器内存受不住)。


三、买家那边的路由(订单链接)

location ~ "^/order/[A-Za-z0-9]{6,16}$" {
    try_files /order/index.html =404;
    add_header Cache-Control "no-store" always;
    add_header X-Robots-Tag "noindex, nofollow, noarchive" always;
}

# 兜底:/order/ 下面找不到的路径一律给下单页,**绝不给 404**
location /order/ {
    try_files $uri $uri/ /order/index.html;
    add_header Cache-Control "no-store" always;
    add_header X-Robots-Tag "noindex, nofollow, noarchive" always;
}

这两条的用意,请你连做法一起评:

  1. ^/order/<6~16位> 这条必须有。买家拿到的是 /order/<订单号>?t=<取件码>, 没有这条路由会掉到主站规则直接 404 —— 而买家一关页面就再也找不回订单。 (页面文案还写着"请记下订单号用于查询下载",那就成了骗人。)
  2. 兜底那条绝不能返回 404。买家从聊天软件复制链接常夹进不可见字符 (实测踩到:路径里多了个零宽空格 → 404),看着就像网站坏了。 给下单页最差只是"没找到那一单",页面自己会提示。
  3. 正则里的 {6,16} 必须用引号包住,否则 nginx 会把花括号当配置块起始, 报 unknown directive(实测踩到)。
  4. no-store + noindex:订单页带取件码,不该被缓存也不该被搜索引擎收录 (一是降曝光,二是链接本身就是凭证)。

四、这一层我们没做的事(也算"做法",欢迎质疑)

  • 没上 WAF / 没有额外防护层:这台机器很小,装不下重的东西; 防护全在后端自己的限流 + 两把令牌 + 来源 IP 门上。
  • 没做多机/负载均衡:单机单进程,够用。
  • HTTPS 用自动签发的证书,续期自动化,没有额外动作。