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

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

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

101 lines
4.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 部署层 · 反向代理片段(脱敏版)
> 后端**只绑本机回环**,对外全部由 nginx 反代。这一份是跟 `/order/` 相关的路由与限流,
> 给你看**路由是怎么接的、限额是怎么设的**。值已按脱敏规则替换,**照形状看,别照字面抄**。
---
## 一、限流区(定义在 nginx 的 http 层)
```nginx
# 下单相关:一般接口 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/` 的路由
```nginx
# ① 提交接口:单独限流 + 单独放宽请求体
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 这层再缓存一份(小机器内存受不住)。
---
## 三、买家那边的路由(订单链接)
```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 用自动签发的证书**,续期自动化,没有额外动作。