- backend-site/cms.py(新):账号(scrypt 加盐哈希)、服务端会话(只存哈希,30 天滑动,可撤销)、 admin/admin 首次登录强制改密(改密前其它接口一律 403)、CSRF / 来源 / https / 登录冷却、 内容校验、发布写 content/ 与 prices.json / payinfo.json、版本与回滚、传图核验 + 去元数据 + ffmpeg 缩略图 - server.py 把 /api/cms/* 交给 cms.py;admin.py 加 user list/add/passwd/reset/disable/enable/sessions - portal/admin/(新):内容后台页面;门户顶栏加不带字的淡色铅笔入口 - 门户 / 下单页读 content/site.js、order/content/order.js(代码里的数据降级为兜底);?preview=1 预览草稿 - portal/assets/universe/layout.js(新):新点亮的世界线自动排到中圈不挤的位置、补给线接附近的星、已有的都不动 - planets.js:加 10 种卡通预设(类地 / 海洋 / 丛林 / 荒漠 / 冻原 / 熔岩 / 毒雾 / 荒芜岩球 / 冰巨星 / 带环巨星) - galaxy.js:名牌 / 档案卡文字一律转义 - tests/内容后台测试.py(75 条);回归 27 + 数据库 38 照旧全过;端到端浏览器 36 条 - 文档:交接文档-2026-10.md(变更 / 接口 / 部署 7.1b / 测试 / 第 10 节)、内容后台设计.md(实现对照)、星系图交接说明、nginx 片段 ④ Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
131 lines
5.6 KiB
Markdown
131 lines
5.6 KiB
Markdown
# 部署层 · 反向代理片段(脱敏版)
|
||
|
||
> 后端**只绑本机回环**,对外全部由 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;
|
||
# ...
|
||
}
|
||
```
|
||
|
||
### ④ 内容后台(2026-10-05 加)
|
||
|
||
```nginx
|
||
# 登录 / 内容接口。⚠️ 必须带 X-Forwarded-Proto —— 后端看它判断是不是 https,不带一律拒绝(内容后台只走 https)
|
||
location /order/api/cms/ {
|
||
limit_req zone=<ZONE_ORDER> burst=20 nodelay;
|
||
limit_req_status 429;
|
||
client_max_body_size 16m; # 画展传图:单张 10MB,base64 后约 13.4MB
|
||
proxy_pass http://localhost:<PORT>/api/cms/;
|
||
proxy_set_header Host $host;
|
||
proxy_set_header X-Real-IP $remote_addr;
|
||
proxy_set_header X-Forwarded-Proto $scheme;
|
||
}
|
||
|
||
# 后台发布出来的内容文件:文件名不变、内容会变 → 让浏览器每次都问一下有没有新的
|
||
location /content/ { add_header Cache-Control "no-cache"; }
|
||
location /order/content/ { add_header Cache-Control "no-cache"; }
|
||
# 后台页面本身不缓存(改版后别人拿到旧页面会调错接口)
|
||
location /admin/ { add_header Cache-Control "no-store"; }
|
||
# 画展上传的图(文件名是随机的,可以长缓存)
|
||
location /uploads/ { add_header Cache-Control "public, max-age=2592000"; }
|
||
|
||
# 整站 http → https,并加 HSTS(登录页绝不能走 http)
|
||
server { listen 80; server_name shop.example.com; return 301 https://$host$request_uri; }
|
||
# 在 443 的 server 块里加:
|
||
# add_header Strict-Transport-Security "max-age=31536000" always;
|
||
```
|
||
|
||
> 没配好证书之前**不要开放内容后台**:后端会拒绝所有非 https 的请求(返回 403「内容后台只能用 https 打开」)。
|
||
|
||
⚠️ **打包下载(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 用自动签发的证书**,续期自动化,没有额外动作。
|