Files
jinzuanwork/backend/deploy/nginx-片段.md
T
ywsandClaude Opus 5.5 fd72f7192e 全站按设计预览站重做(门户改多页 + 下单页对齐)、新加载动画、金钻宇宙开场星门;站点信息集中到 site-info.js
- 门户:单页改成 index / gallery / tools / universe / links / about 六页,标记 / 样式 / 交互照预览站;内容照旧读 content/site.js
- 画展:预览站作品墙 + 原有全部功能(筛选、排序、看过的、高清、本站视频、B 站、全景、动态壁纸、观展统计、外链);按最矮列投放保证时间顺序
- 加载动画 boot.js:像素钻石垒成形 → 白光 → 店名逐字 → 进度条 → 幕布上收(每个标签页只放一次,减少动效时不放)
- 金钻宇宙开场 gate.js:星门(钻石 + 光谱环 + 世界线格子逐个点亮),星系画好后炸开接镜头俯冲
- 下单页:全站顶栏 / 底栏 / 页脚、宽版面、落地「怎么下单?」两张路卡 + 下过单了 + 模板样图;下单逻辑和按钮 id 不动
- 站点固定信息(域名 / 群号 / 备案号 / 邮箱)只在 assets/site-info.js,仓库是占位,正式服务器只换这一个文件
- 像素字体换成常用 3755 字 + 全部内容的子集(门户和下单页共用);旧链接 /#/板块、/#0001 自动跳新页
- 交接文档 / 星系图说明 / nginx 片段同步更新

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-06 06:15:44 +00:00

135 lines
6.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;
# ...
}
```
### ④ 内容后台(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"; }
# 页面本身(2026-10-06 起门户是多页:index / gallery / tools / universe / links / about.html)不缓存:改版后手机浏览器别老吃旧副本
location ~ \.html$ { add_header Cache-Control "no-cache"; }
# 站点固定信息(群号 / 备案号 / 邮箱):正式服务器上的这份是真实值,部署别用仓库里的占位覆盖
location = /assets/site-info.js { 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 用自动签发的证书**,续期自动化,没有额外动作。