Nginx可通过server_name正则捕获子域名、rewrite重写URI并追加subdomain参数实现二级域名到查询参数的隐式转换，如a.example.com→/path?subdomain=a，需配合$host提取、$args保留原参数及break终止重写。
nginx rewrite 本身不直接“把二级域名转成参数”，但可以通过 结合 server_name 匹配 + rewrite 捕获 + 变量引用 的方式，实现二级域名到请求参数的隐式转换（即用户访问 user1.example.com，后端实际收到 /path?subdomain=user1 这类效果）。这不是真正的参数注入，而是通过重写 URI 并携带子域信息，让后端能感知来源。
核心思路：用 $host 提取子域，再拼入 query string
关键在于利用 Nginx 内置变量 $host（客户端请求的 Host 头），配合正则提取二级域名部分，再用 rewrite 把它作为查询参数追加到 URI 中。整个过程对用户透明，浏览器地址栏不变（属于内部重写，非重定向）。
- 假设主域是
example.com，允许任意二级域名如a.example.com、blog.example.com - 目标：将
https://a.example.com/api/list→ 内部重写为/api/list?subdomain=a - 必须确保 DNS 已将所有
*.example.com解析到该 Nginx 服务器（泛解析或通配符 A/CNAME 记录）
配置示例：提取二级域名并追加为 subdomain 参数
在 server 块中匹配泛域名，并用 rewrite 实现隐式转换：
server {
listen 80;
server_name ~^(?<sub>.+)\.example\.com$; # 捕获二级域名到命名变量 $sub
root /var/www/html;
<pre class="brush:php;toolbar:false;">location / {
# 将原始 URI 重写为带 subdomain 参数的形式（内部重写）
rewrite ^(.*)$ $1?subdomain=$sub&$args break;
# 注意：$args 是原有查询参数，&$args 确保不丢失原参数
# break 表示停止 rewrite，继续执行当前 location 内其他指令（如 try_files）
}
}
-
server_name ~^(?<sub>.+)\.example\.com$</sub>使用正则捕获二级域名到变量$sub（如访问api.example.com，则$sub = "api"） -
rewrite ^(.*)$ $1?subdomain=$sub&$args break：把完整路径$1后追加?subdomain=xxx，同时保留原有参数（$args） -
break是关键——它表示重写后不再匹配其他 rewrite 规则，且不重新搜索 location，避免循环
注意事项与常见问题
这种转换是服务端内部行为，后端应用需主动读取 subdomain 参数（如 PHP 的 $_GET['subdomain']，Node.js 的 req.query.subdomain）才能生效。不是所有场景都适合，需注意：
-
HTTPS 场景需额外处理：若用 HTTPS，server_name 正则仍有效，但需确保 SSL 证书支持泛域名（如
*.example.com）或使用 SNI -
避免覆盖原有参数：务必用
&$args（HTML 实体）或&$args（配置文件中）拼接，否则原 query 会丢失 -
root 或 proxy_pass 需兼容新 URI：如果后端是静态文件，
root路径不受影响；如果是反向代理，proxy_pass会自动带上新 URI（含参数） - 不推荐用于 SEO 敏感路径：因为真实 URL 已含参数，可能造成重复内容；如需 SEO 友好，应配合 canonical 标签或用 location 分离路由
替代方案：用 map 指令更清晰地提取子域
对于复杂逻辑（如白名单校验、映射到不同后端），建议用 map 指令预处理 $host，比在 rewrite 中硬编码更易维护：
map $host $subdomain {
~^(?<captured>.+)\.example\.com$ $captured;
default "";
}
<p>server {
listen 80;
server_name *.example.com;</p>
<pre class="brush:php;toolbar:false;">location / {
if ($subdomain) {
rewrite ^(.*)$ $1?subdomain=$subdomain&$args break;
}
# 其他处理...
}
}
-
map在 http 块中定义，提前计算出$subdomain值，性能更好、逻辑更清晰 -
if在 location 中仅作条件判断，避免正则重复执行 - 注意：
if在 location 中是安全的，但在 server 级别慎用（Nginx 官方不推荐）
