NGINX：如何将URL变量重写为虚拟子域名？

当然可以实现这个需求！这在NGINX里完全可行，我帮你梳理一下具体的配置步骤和注意事项：

前提条件 #

在开始配置前，你需要先搞定两个基础项：

• 泛域名解析：在你的DNS服务商后台，配置*.domain.com的A记录指向你的NGINX服务器IP，这样所有动态生成的子域名才能被正确解析到服务器。
• 泛域名SSL证书：因为要处理HTTPS请求，必须申请一张*.domain.com的泛域名SSL证书（比如用Let's Encrypt免费申请），否则访问动态子域名时会出现SSL报错。

配置步骤 #

1. 处理原始URL的重定向（将参数转成子域名） #

这个server块负责匹配用户访问的原始URL（https://subdomain.domain.com/index.html?id=123），并将其重定向到目标子域名URL：

server {
    listen 443 ssl;
    server_name subdomain.domain.com;

    # 替换成你的SSL证书路径
    ssl_certificate /path/to/your/subdomain-cert.crt;
    ssl_certificate_key /path/to/your/subdomain-cert.key;

    # 匹配带有id参数的index.html请求
    location = /index.html {
        # 这里假设id是数字格式，如果你需要支持其他字符，可调整正则，比如^[a-zA-Z0-9_-]+$
        if ($arg_id ~ ^\d+$) {
            # 用301永久重定向（对SEO友好），如果是临时需求可换成302
            return 301 https://$arg_id.domain.com/;
        }
        # 如果没有id参数或格式不符合，正常处理原请求
        try_files $uri $uri/ =404;
    }

    # 其他静态资源或业务逻辑的location配置
}

2. 处理动态子域名的请求（确保新URL能正常服务） #

接下来需要配置一个server块来处理所有动态子域名的请求，将子域名再转回参数，对应到原来的业务逻辑：

server {
    listen 443 ssl;
    server_name *.domain.com;

    # 这里要用泛域名SSL证书
    ssl_certificate /path/to/your/wildcard-domain.crt;
    ssl_certificate_key /path/to/your/wildcard-domain.key;

    # 用map模块提取子域名（比if更高效，避免NGINX的if陷阱）
    map $host $subdomain_id {
        ~^(.+)\.domain\.com$ $1;
        default "";
    }

    location / {
        # 如果你的业务是反向代理到后端服务，用proxy_pass
        proxy_pass https://subdomain.domain.com/index.html?id=$subdomain_id;
        # 如果是本地静态文件或直接处理，用try_files
        # try_files $uri /index.html?id=$subdomain_id;

        # 可选：传递必要的请求头给后端
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

关键注意事项 #

• 正则匹配准确性：根据你的id参数的实际格式调整正则表达式，避免非法字符生成无效子域名。
• NGINX配置测试：每次修改配置后，用nginx -t检查语法是否正确，没问题再用systemctl reload nginx重载配置。
• 重定向状态码：301永久重定向适合长期固定的URL转换，302临时重定向适合临时场景，按需选择。

内容的提问来源于stack exchange，提问作者Nilessss