proxy_download_rate 是 OpenResty/Tengine 等增强版 Nginx 支持的四层限速指令，官方 Nginx stream 模块不支持，直接使用会报“unknown directive”错误；需通过 nginx -V 确认变体，仅在 stream 块中生效，单位支持 k/m，控制上游→客户端的下行速率。
proxy_download_rate 是 Nginx 的一个四层（TCP/UDP）代理限速指令，但它**并不属于官方开源版 Nginx**，而是 OpenResty 或 Tengine 等增强版 Nginx 分支才支持的特性。标准 Nginx（nginx.org 官方版本）在 stream 模块中没有该指令，因此直接使用会报错 “unknown directive”。要实现四层限速下载，必须确认运行环境是否支持。
确认 Nginx 变体与模块支持
执行以下命令检查当前 Nginx 是否支持 proxy_download_rate：
nginx -V 2>&1 | grep -o "openresty\|tengine"
若输出含 openresty 或 tengine，再查看 stream 模块配置文档是否列出该指令；否则需升级或切换到兼容版本。常见不支持场景：Ubuntu/Debian 官方源安装的 nginx-full 或 nginx-core 默认不含此功能。
在 stream 块中配置限速下载
该指令仅在 stream { ... } 上下文中生效，作用于后端 TCP 连接的下行（客户端接收）速率。典型配置如下：
stream {
upstream fast_backend {
server 192.168.1.100:8080;
}
<pre class="brush:php;toolbar:false;">server {
listen 8000;
proxy_pass fast_backend;
proxy_download_rate 100k; # 限制客户端下载速度为 100KB/s
proxy_timeout 30s;
}}
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
-
单位可选：支持
k（KB/s）、m（MB/s），如512k、1m - 作用方向明确：只控制从上游服务器发往客户端的数据流速率，不影响上传或连接建立
- 非请求级控制：对整个 TCP 连接生效，不区分 URL 或用户，适合粗粒度带宽管控
替代方案：标准 Nginx 中的可行做法
若无法更换 Nginx 变体，可在七层（HTTP）用 limit_rate 实现类似效果，但需满足：后端服务暴露 HTTP 接口、且客户端直连 Nginx 的 80/443 端口。示例：
location /download/ {
proxy_pass http://backend;
proxy_cache off;
limit_rate 100k;
}
注意：这已脱离“四层”范畴，且依赖 HTTP 协议解析，对纯 TCP 下载（如 FTP、自定义协议）无效。
验证与调试要点
限速生效需结合实际测试，避免被缓存或客户端缓冲干扰：
- 用
wget -v --limit-rate=0 http://ip:8000/file.bin（关闭客户端限速）测服务端限速效果 - 检查 Nginx error log，确认无
unknown directive "proxy_download_rate"报错 - 使用
iftop -P 8000或ss -i观察实时连接的发送速率（TX）是否接近设定值 - 注意 Linux 内核 TCP 缓冲区可能造成瞬时突发，限速是平滑后的平均效果
不复杂但容易忽略：限速值过小（如 1k）可能导致连接异常中断，建议不低于 10k 起步测试；同时确保后端服务本身不主动限速，以免叠加导致远低于预期。
