docs: 补充内存限流与登录防爆破多进程局限及部署建议

2026-09-19 08:49:50 +00:00
parent c0bcf1d851
commit c2c4752856
2 changed files with 65 additions and 0 deletions
@@ -130,6 +130,15 @@ cd frontend && npm install && npm run dev

 后端运行在 `http://localhost:8000`,前端在 `http://localhost:5173`。

+## 安全与限流
+
+- `/api/v1/predict`: 内存滑动窗口限流(10 次/分钟/IP),多 worker 时每进程独立计数
+- 登录防爆破: 进程内内存计数,同上
+- 公网部署建议 Nginx 层限流 + `TRUST_PROXY_HEADERS=True`
+- 生产环境必须配置 `ADMIN_PASSWORD` 或 `ADMIN_API_KEY`(否则管理接口 503)
+
+详见 [docs/06-deployment.md](docs/06-deployment.md#安全与限流)。
+
 ## API 概览

 | 方法 | 路径 | 说明 |