在 nginx 中配置泛域名以获取二级参数，核心做法是利用正则表达式匹配 `server_name` 中的子域名部分，并通过捕获组提取参数，随后使用 `return` 或 `proxy_pass` 将提取的值传递给后端。具体而言，需定义一个包含正则的 `server_name` 指令（如 `~^(?
如何配置正则 server_name 捕获子域名
要实现此功能，必须在 `server_name` 中使用正则表达式模式，并以 `~` 开头标识。Nginx 允许在正则中命名捕获组，例如使用 `(?
server {
listen 80;
# 使用正则匹配，捕获第一个子域名部分到 subdomain 变量
server_name ~^(?<subdomain>.+)\.example\.com$;
location / {
# 直接输出捕获的子域名用于验证
return 200 "Subdomain is: $subdomain";
}
}
上述配置中，`~^` 表示开始正则匹配，`(?
如何将捕获的参数传递给后端服务
捕获子域名后，通常需将其作为参数传递给后端应用。可通过 `proxy_pass` 结合 URL 编码或直接拼接路径实现。Nginx 支持在 `proxy_pass` 中使用变量，但需注意变量替换发生在请求处理阶段。若后端依赖查询参数，可将 `subdomain` 值附加到 URL 中；若后端依赖路径段，可使用 `rewrite` 或直接在 `proxy_pass` 中构造路径。关键在于保持变量引用的一致性，避免因上下文不同导致变量未定义。
server {
listen 80;
server_name ~^(?<subdomain>.+)\.example\.com$;
location / {
# 将子域名作为查询参数传递给后端
proxy_pass http://backend_app/?tenant=$subdomain;
proxy_set_header Host $host;
}
}
在此配置中，`proxy_pass` 后的 URL 包含 `?tenant=$subdomain`，Nginx 会将 `$subdomain` 替换为实际捕获的值。例如，请求 `shop.example.com` 将被代理至 `http://backend_app/?tenant=shop`。后端应用可从查询参数 `tenant` 中读取租户信息。若后端期望路径格式，可改用 `rewrite ^/(.*)$ /$subdomain/$1 last;` 并重定向至内部位置。务必测试变量替换结果，确保后端能正确解析传入的参数。
当子域名包含连字符或数字时如何处理
当子域名包含连字符（如 `my-app`）或数字（如 `user123`）时，正则表达式 `.+` 仍能正确捕获，因为 `.` 匹配除换行符外的任意字符，包括字母、数字和连字符。无需额外修改正则模式。然而，需确保后端服务能正确处理这些特殊字符，尤其是当子域名被用作数据库键或文件路径时。若后端对非法字符敏感，应在 Nginx 层进行过滤或转换。此外，正则匹配不区分大小写，除非显式指定 `(?i)` 标志，因此 `My-App` 和 `my-app` 均会被捕获为相同值。
