Nginx 中 rewrite 怎么实现多租户系统的独立路径重写规则

落磊小哥_5877

落磊小哥_5877

2026-11-18

728人浏览

原创

在 nginx 中实现多租户系统的独立路径重写,核心做法是利用正则表达式捕获 url 中的租户标识(如子域名或路径前缀),将其存入变量,随后通过 `if` 指令判断该变量并应用特定的 `rewrite` 规则。这样做可以将不同租户的请求动态映射到各自的业务目录或后端服务,同时保持主配置的结构化。如果租户标识缺失或未匹配任何已知规则,nginx 会按默认逻辑处理或返回错误,确保请求不迷路。

Nginx 中 rewrite 怎么实现多租户系统的独立路径重写规则

如何根据子域名提取租户 ID 并重写路径

当多租户系统采用子域名模式(如 tenant-a.example.com)时,可以通过 `server_name` 的正则匹配将租户 ID 提取到变量中,并在 `location` 块中使用 `rewrite` 将请求重定向到统一入口或特定目录。这种方法利用了 Nginx 的正则捕获组功能,能够灵活适应不同租户的命名规范。只要子域名格式符合预期,租户 ID 就会被正确识别并用于后续的路径拼接或重写。

Nginx 中 rewrite 怎么实现多租户系统的独立路径重写规则

server {
    listen 80;
    server_name ~^(?<tenant>[a-z0-9-]+)\.example\.com$;

    location / {
        # 将租户ID作为参数传递给后端,或者重写内部路径
        rewrite ^/(.*)$ /app/$tenant/$1 last;
    }
}</tenant>

上述配置中,`server_name` 使用正则表达式 `~^` 来匹配子域名,并将匹配到的 `[a-z0-9-]+` 部分存储为变量 `$tenant`。在 `location /` 块中,`rewrite` 指令将原始请求路径 `/path/to/resource` 重写为 `/app/$tenant/path/to/resource`。这里的 `last` 标志表示重写完成后,Nginx 会重新搜索匹配的 `location` 块,从而可能触发针对 `/app/...` 的进一步处理。这种机制确保了每个子域名的请求都能被隔离到对应的租户目录下。

如何基于路径前缀区分租户并应用独立规则

对于采用路径前缀模式(如 example.com/tenant-a/)的多租户系统,需要在 `location` 块中使用正则匹配来识别租户前缀,并根据不同的租户应用不同的重写规则。这种方式允许在同一域名下通过 URL 路径结构来隔离租户数据。通过定义多个 `location` 或使用带有条件的 `rewrite`,可以精确控制每个租户的请求流向。若未指定租户前缀,可设置默认租户或拒绝访问。

Nginx Reverse Proxy
Nginx Reverse Proxy

配置 Nginx 反向代理,实现域名绑定。用户说“绑定域名”“配置 Nginx”“反向代理”时触发,将域名绑定到指定 IP:端口。

下载

Nginx 中 rewrite 怎么实现多租户系统的独立路径重写规则

server {
    listen 80;
    server_name example.com;

    location ~ ^/(?<tenant>[a-z0-9-]+)/(.*)$ {
        # 假设租户 'alpha' 有特殊规则
        if ($tenant = 'alpha') {
            rewrite ^/alpha/(.*)$ /backend/alpha-service/$1 last;
        }
        # 默认规则:其他租户
        rewrite ^/(?<tenant>[a-z0-9-]+)/(.*)$ /backend/default/$tenant/$2 last;
    }
}</tenant></tenant>

在这个配置中,`location ~ ^/(?[a-z0-9-]+)/(.*)$` 使用正则表达式匹配以租户前缀开头的路径,并将租户名和剩余路径分别存入 `$tenant` 和 `$2` 变量。`if` 指令用于检查租户是否为 'alpha',如果是,则应用特定的重写规则,将其转发到 `/backend/alpha-service/`。对于其他租户,执行默认的 `rewrite` 规则,将请求转发到 `/backend/default/$tenant/$2`。这种结构允许为特定租户定制行为,同时保持通用逻辑的一致性。

当租户变量为空时 rewrite 的行为是什么

当请求路径中不包含有效的租户标识,导致 `$tenant` 变量为空或未定义时,`rewrite` 指令的行为取决于具体的正则匹配结果和 `if` 条件。如果正则表达式未能匹配,请求将不会进入相应的 `location` 块,而是继续尝试其他 `location` 匹配或返回 404。如果在 `location` 块内使用了 `if` 且变量为空,条件判断通常为假,从而跳过特定的重写规则,执行后续的默认逻辑或保持原路径不变。这种机制防止了因缺少租户信息而导致的错误路由。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

nginx

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
nginx 重启
nginx 重启

nginx重启对于网站的运维来说是非常重要的,根据不同的需求,可以选择简单重启、平滑重启或定时重启等方式。本专题为大家提供nginx重启的相关的文章、下载、课程内容,供大家免费下载体验。

2023.07.27

423

5

nginx 配置详解
nginx 配置详解

Nginx的配置是指设置和调整Nginx服务器的行为和功能的过程。通过配置文件,可以定义虚拟主机、HTTP请求处理、反向代理、缓存和负载均衡等功能。Nginx的配置语法简洁而强大,允许管理员根据自己的需要进行灵活的调整。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

4327

6

nginx配置详解
nginx配置详解

NGINX与其他服务类似,因为它具有以特定格式编写的基于文本的配置文件。本专题为大家提供nginx配置相关的文章,大家可以免费学习。

2023.08.04

7265

6

tomcat和nginx有哪些区别
tomcat和nginx有哪些区别

tomcat和nginx的区别:1、应用领域;2、性能;3、功能;4、配置;5、安全性;6、扩展性;7、部署复杂性;8、社区支持;9、成本;10、日志管理。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

601

5

nginx报404怎么解决
nginx报404怎么解决

当访问 nginx 网页服务器时遇到 404 错误,表明服务器无法找到请求资源,可以通过以下步骤解决:1. 检查文件是否存在且路径正确;2. 检查文件权限并更改为 644 或 755;3. 检查 nginx 配置,确保根目录设置正确、没有冲突配置等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.07.09

1516

5

Nginx报404错误解决方法
Nginx报404错误解决方法

解决方法:只需要加上这段配置:try_files $uri $uri/ /index.html;即可。想了解更多Nginx的相关内容,可以阅读本专题下面的文章。

2024.08.07

3998

3

nginx部署php项目教程汇总
nginx部署php项目教程汇总

本专题整合了nginx部署php项目教程汇总,阅读专题下面的文章了解更多详细内容。

2026.01.13

122

12

nginx配置文件详细教程
nginx配置文件详细教程

本专题整合了nginx配置文件相关教程详细汇总,阅读专题下面的文章了解更多详细内容。

2026.01.13

617

23

Nginx跨平台安装实操指南:Windows、macOS与Linux环境快速搭建
Nginx跨平台安装实操指南:Windows、macOS与Linux环境快速搭建

本指南详解Nginx在Windows、macOS及Linux系统的安装全流程。涵盖官方包解压、Homebrew一键部署、APT/YUM源配置及Docker容器化方案。无论新手或开发者,均可快速搭建运行环境,掌握跨平台核心指令,为后续配置与调优奠定坚实基础。

2026.03.16

179

12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
phpEnv手册
phpEnv手册

共0课时 | 0人学习

nginx手册
nginx手册

共0课时 | 0人学习

进程与SOCKET
进程与SOCKET

共6课时 | 0.5万人学习