在 nginx 中实现多租户系统的独立静态资源兜底,核心做法是利用 $uri 变量结合 try_files 指令进行层级文件查找。具体而言,将请求路径映射到以租户标识(如子域名或 url 前缀)命名的目录结构中,依次检查该租户专属目录、公共共享目录以及默认兜底页面。这样做能确保每个租户拥有独立的静态资源空间,同时通过 fallback 机制保证服务可用性。

如何根据子域名动态定位租户专属目录
要实现基于子域名的动态路由,需利用 Nginx 内置变量 $host 提取子域名部分,并将其作为路径参数传递给 try_files。例如,对于 tenant-a.example.com,Nginx 会尝试访问 /var/www/tenant-a/public/ 下的资源。若文件存在则直接返回;若不存在,则继续向下匹配公共目录 /var/www/shared/。这种结构避免了为每个租户编写单独的 location 块,实现了配置复用。

server {
listen 80;
server_name ~^(?<tenant>.+).example.com$;
root /var/www/html;
location / {
# 1. 尝试租户专属目录
try_files /$tenant/$uri /shared/$uri /default.html =404;
}
}</tenant>
上述配置中,$tenant 是通过正则捕获组获取的子域名值。try_files 的执行顺序决定了优先级:首先查找 /var/www/html/$tenant/$uri,如果找不到,则查找 /var/www/html/shared/$uri,最后回退到 /var/www/html/default.html。这种方式确保了租户 A 的资源不会干扰租户 B,且所有未找到的请求最终都会落入同一个默认页面,便于统一处理错误。
如何处理 URL 中的路径前缀匹配
当多租户系统采用 URL 前缀(如 /tenant-a/)而非子域名时,处理方式略有不同。此时需要使用 rewrite 或 map 指令解析路径前缀,并将其转换为内部路径。关键在于保持 try_files 中的路径结构与文件系统一致。例如,请求 /tenant-a/style.css 应被映射到 /var/www/html/tenant-a/style.css。

server {
listen 80;
server_name example.com;
root /var/www/html;
location / {
# 假设 $tenant_prefix 已通过 map 或 rewrite 设置
# 例如: /tenant-a/style.css -> /tenant-a/style.css
try_files $uri /$tenant_prefix$uri /shared$uri /default.html =404;
}
}
在这种场景下,$uri 包含完整的请求 URI。通过拼接租户前缀,Nginx 能够正确指向对应的租户目录。需要注意的是,如果租户前缀本身包含特殊字符,需要进行适当的转义或编码处理。此外,公共目录 /shared/ 仍然作为第二级 fallback,确保即使租户目录缺失,共享资源仍能正常加载。最后,=404 明确指定了当所有路径均失败时的 HTTP 状态码,避免返回默认的 404 页面内容混淆用户。
当 try_files 找不到任何文件时会返回什么
当 try_files 列表中所有指定的路径都不存在时,其行为取决于最后一个参数。如果最后一个参数是文件路径(如 /default.html),Nginx 会执行一个内部重定向到该文件,并返回该文件的内容,HTTP 状态码通常为 200。如果最后一个参数是以 = 开头的状态码(如 =404),Nginx 将直接返回该状态码及对应的错误页面,不再进行内部重定向。因此,选择合适的 fallback 策略至关重要。











