在 nginx 中配置泛域名以获取二级参数，核心做法是利用正则表达式匹配 `server_name` 中的子域名部分，并通过捕获组提取参数，随后使用 `return` 或 `proxy_pass` 将提取的值传递给后端。具体而言，需定义一个包含正则的 `server_name` 指令（如 `~^(?.+)\.example\.com$`），并在对应的 `location` 块中通过 `$arg_` 变量或重写规则访问该参数，从而实现动态路由。

如何配置正则 server_name 捕获子域名

要实现此功能，必须在 `server_name` 中使用正则表达式模式，并以 `~` 开头标识。Nginx 允许在正则中命名捕获组，例如使用 `(?pattern)` 语法。当请求进入时，Nginx 会将匹配的子域名部分存入名为 `subdomain` 的变量中。配置的关键在于确保正则表达式精确匹配目标域名的结构，避免误匹配其他无关域名。若未正确设置正则前缀，Nginx 将忽略捕获组，导致变量为空。

server {
    listen 80;
    # 使用正则匹配，捕获第一个子域名部分到 subdomain 变量
    server_name ~^(?<subdomain>.+)\.example\.com$;

    location / {
        # 直接输出捕获的子域名用于验证
        return 200 "Subdomain is: $subdomain";
    }
}</subdomain>

上述配置中，`~^` 表示开始正则匹配，`(?.+)` 捕获任意非空字符序列并命名为 `subdomain`，`\.example\.com$` 确保后缀固定。测试时，访问 `test.example.com` 将返回 "Subdomain is: test"，而 `api.example.com` 则返回 "Subdomain is: api"。注意，正则匹配优先级高于普通字符串匹配，因此需确保无冲突的静态 `server_name` 配置。

如何将捕获的参数传递给后端服务

捕获子域名后，通常需将其作为参数传递给后端应用。可通过 `proxy_pass` 结合 URL 编码或直接拼接路径实现。Nginx 支持在 `proxy_pass` 中使用变量，但需注意变量替换发生在请求处理阶段。若后端依赖查询参数，可将 `subdomain` 值附加到 URL 中；若后端依赖路径段，可使用 `rewrite` 或直接在 `proxy_pass` 中构造路径。关键在于保持变量引用的一致性，避免因上下文不同导致变量未定义。

CMIC Skill Scanner (BCLinux 21 / 低版本 glibc Linux x64)

使用内置 Rust 引擎审计待安装的 skill 包或归档，可选桥接外部扫描器。

下载

server {
    listen 80;
    server_name ~^(?<subdomain>.+)\.example\.com$;

    location / {
        # 将子域名作为查询参数传递给后端
        proxy_pass http://backend_app/?tenant=$subdomain;
        proxy_set_header Host $host;
    }
}</subdomain>

在此配置中，`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` 均会被捕获为相同值。