SetOutputFilter RATE_LIMIT 必须嵌套在 等作用域容器内，因该指令是输出过滤器，Apache 不允许在 顶层使用；否则报错“Invalid command”，且需确保模块启用、路径匹配准确，三者缺一不可。
不能直接在 <virtualhost></virtualhost> 根层级写 SetOutputFilter —— 会报 Invalid command 'SetOutputFilter' 错误。 必须嵌套在 <location></location>、<directory></directory> 或 <files></files> 块内，且模块已启用、路径匹配准确，三者缺一不可。
为什么 <virtualhost></virtualhost> 里直接写限流配置会失败
mod_ratelimit 的 SetOutputFilter RATE_LIMIT 是一个「输出过滤器指令」，Apache 要求它只能出现在作用域受限的容器中。直接放在 <virtualhost></virtualhost> 顶层，Apache 解析时找不到上下文，就拒绝加载。
- 错误现象：
Invalid command 'SetOutputFilter', perhaps misspelled or defined by a module not included in the server configuration - 根本原因：模块虽已启用（
a2enmod ratelimit），但指令使用位置非法 - 正确做法：必须包裹在
<location></location>或<directory></directory>等合法容器内
<location> 比 <code><directory></directory> 更适合虚拟主机级限流
虚拟主机常通过 Alias、Redirect 或反向代理跳转，<directory></directory> 匹配的是磁盘路径，而用户请求的是 URI。一旦路径被重写或映射，<directory></directory> 就失效；<location></location> 匹配的是请求 URL，更稳定可靠。
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
- 例如：两个虚拟主机都把
/downloads映射到不同后端，用<location></location>可分别控制 -
SetEnv rate-limit 200中的200单位是 KB/s，不能写200k或0.2m，小数会被截断为 0 - 若需按 IP 区分限速，用
SetEnvIf Remote_Addr "^192\.168\.1\." rate-limit=50，注意正则转义
多个虚拟主机独立限流的最小可行配置
每个 <virtualhost></virtualhost> 内单独定义 <location></location>，互不干扰。以下为两个站点分别限制下载带宽的示例：
<VirtualHost *:80>
ServerName site-a.example.com
DocumentRoot /var/www/site-a
<Location "/downloads">
SetOutputFilter RATE_LIMIT
SetEnv rate-limit 150
</Location>
</VirtualHost>
<VirtualHost *:80>
ServerName site-b.example.com
DocumentRoot /var/www/site-b
<Location "/downloads">
SetOutputFilter RATE_LIMIT
SetEnv rate-limit 50
</Location>
</VirtualHost>
- 重启必须用
systemctl restart apache2（Debian/Ubuntu）或systemctl restart httpd（RHEL/CentOS），reload不生效 - 验证是否走限流：用
curl -sI http://site-a.example.com/downloads/test.zip | grep -i "content-length"，有Content-Length且非transfer-encoding: chunked才算生效 - 注意：如果 ZIP 文件由 PHP 的
readfile()输出且未关闭 output buffering，mod_ratelimit完全不介入
真正容易被忽略的是「内容输出路径」——只要响应没经过 Apache 的原始文件服务流程（比如被 X-Sendfile、mod_xsendfile 或 Nginx 中转），SetOutputFilter 就只是个摆设。
