nginx 多租户 gzip 与缓存隔离需按租户划分 server 块:各租户独立配置 gzip 指令、专属 proxy_cache_path 与 keys_zone、带 $tenant_id 的 cache_key、透传 x-tenant-id 及定制响应头与日志。

要在 Nginx 中实现多租户环境的 Gzip 与缓存策略完全隔离,核心是“按租户划分作用域”——每个租户独占自己的 server 块,并在其中独立定义压缩行为和缓存逻辑,不依赖全局配置兜底。
为每个租户配置专属 server 块并启用独立 Gzip
Gzip 指令支持在 http、server、location 三级生效,子级会覆盖父级。因此只需把压缩相关指令写进对应租户的 server 块内:
-
启用本租户压缩:在 tenant-a.example.com 的 server 块中加
gzip on; -
限定压缩类型:用
gzip_types text/css application/javascript image/svg+xml;只对该租户高频资源压缩(比如 tenant-b 不压 SVG,就删掉这一项) -
控制压缩粒度:设
gzip_min_length 2048;避免小文件开销;gzip_comp_level 5;平衡 CPU 与体积 -
确保代理兼容:必须开启
gzip_vary on;,让 CDN 或浏览器根据Vary: Accept-Encoding正确缓存不同版本
为每个租户分配独立缓存区与缓存键
缓存隔离不是靠 if 判断,而是靠物理分离:
-
定义专属缓存路径:在 http 块中为每个租户声明互不重名的
proxy_cache_path,例如:proxy_cache_path /var/cache/nginx/tenant_a levels=1:2 keys_zone=tenant_a:30m max_size=2g inactive=4h;
路径和keys_zone名称必须一一绑定,且目录需chown nginx:nginx -
在 server 块中绑定缓存区:用
proxy_cache tenant_a;明确指定使用哪个 zone -
构造带租户标识的 cache_key:避免仅用
$request_uri,改用:proxy_cache_key "$tenant_id|$scheme|$host|$request_uri|$args";
其中$tenant_id可通过map $host提取,确保 dev 和 prod 即便共用域名也不会混缓存
结合租户上下文统一注入响应头与日志
增强可观测性,让隔离可验证:
-
透传租户身份:在 server 块中加
proxy_set_header X-Tenant-ID $tenant_id;,供后端和日志识别 -
定制 Cache-Control 头:用
add_header Cache-Control "public, max-age=31536000, tenant-id=$tenant_id";把租户信息嵌入响应头 -
租户专属访问日志:定义含变量的 log_format,再在 server 块中指定:
access_log /var/log/nginx/tenant-a.log tenant_with_id;
日志格式里包含$http_x_tenant_id和$upstream_cache_status,便于排查缓存命中情况
补充:路径或 Header 方式租户识别时的注意事项
若无法用子域名(如遗留系统),改用路径前缀(/t/a/)或请求头(X-Tenant)识别,仍需坚持隔离原则:
- 用
map将识别出的租户映射到唯一keys_zone名,再动态设置proxy_cache - 所有敏感路径(如
/admin、/api/v1/user)应显式proxy_cache_bypass $http_authorization;或proxy_no_cache - 非法租户值必须拦截:
if ($tenant_id = "") { return 400; },不能 fallback 到默认缓存区











