摘要：在Web服务器配置中，Nginx的域名rewrite功能扮演着至关重要的作用。它不仅能够将用户请求的域名转换为服务器内部处理的路径，还能实现域名主机层面的迁移、SEO优化、安全防护等复杂目标。本文基于全网专业资料，深入解析ngi...
在Web服务器配置中，Nginx的域名rewrite功能扮演着至关重要的作用。它不仅能够将用户请求的域名转换为服务器内部处理的路径，还能实现域名主机层面的迁移、SEO优化、安全防护等复杂目标。本文基于全网专业资料，深入解析nginx域名rewrite的核心机制、语法结构、典型场景及高级技巧，并提供结构化数据供参考。
1. 域名与域名主机的基本概念
在Nginx中，域名是指用户通过浏览器访问的完整地址（如 www.example.com），而域名主机通常指代虚拟主机（server block）中对特定域名的配置上下文。每个域名主机可以绑定一个或多个域名，并通过 server_name 指令识别。当请求到达时，Nginx首先根据请求头中的域名匹配对应的域名主机，然后在该上下文中执行 rewrite 或其他指令。
2. rewrite 指令的语法与参数
Nginx 的 rewrite 指令格式为：rewrite regex replacement [flag];。其中 regex 为正则表达式，匹配请求的URI（不包含域名部分）；replacement 为替换字符串，可包含变量（如 $1 捕获组）；flag 控制执行顺序和行为。常用 flag 包括：
| flag | 作用 |
| last | 停止当前 server 块内的 rewrite 规则检查，并重新进行 location 匹配 |
| break | 停止当前 rewrite 规则检查，但不再进行新的 location 匹配 |
| redirect | 返回 302 临时重定向 |
| permanent | 返回 301 永久重定向 |
值得注意的是，rewrite 默认只在当前域名主机的上下文内生效；若需跨域名重定向，必须显式指定 redirect 或 permanent 标志，并在 replacement 中包含完整 域名（例如 http://newdomain.com$uri）。
3. 典型场景：域名重定向与路径重写
最常见需求是将多个域名统一为单一权威域名。例如，将 www 子域名重定向到不带 www 的主域名，或反之。此外，当更换域名主机时，需将旧域名的所有请求永久重定向至新域名，以保持SEO权重。以下表格汇总了典型配置：
| 场景 | 配置示例 | 说明 |
| www 重定向到非www | server { listen 80; server_name www.example.com; return 301 http://example.com$request_uri; } | 使用 return 指令，避免 rewrite 循环 |
| 非www 重定向到www | server { listen 80; server_name example.com; return 301 http://www.example.com$request_uri; } | 同上，推荐 return 更高效 |
| 旧域名跳转到新域名 | server { listen 80; server_name old.com; rewrite ^(.*)$ http://new.com$1 permanent; } | 适用于域名主机迁移，保留路径 |
| 子域名映射到子目录 | server { listen 80; server_name blog.example.com; rewrite ^(.*)$ /blog$1 last; } | 将 blog 子域名的请求内部重写到主站下的 /blog 目录 |
| 伪静态 URL 美化 | location / { rewrite ^/article-(\d+).html$ /article.php?id=$1 last; } | 将静态化URL重写为动态参数，提升SEO |
4. 高级技巧：正则捕获与条件判断
在域名rewrite中，利用正则表达式捕获组可以实现灵活的域名参数传递。例如，将 http://user.example.com 映射到 /profile?user=user 的配置：
server { listen 80; server_name ~^(?
这里通过正则$username，随后在内置路径中使用。注意，域名的正则匹配必须在 server_name 中完成，而 rewrite 只处理URI部分。
结合 if 条件可实现更复杂的逻辑，但官方文档建议尽量使用 try_files 或 map 代替，以避免性能损耗。例如，根据域名的头部信息拒绝某些来源：
if ($host !~ ^(www\.)?example\.com$) { return 403; }
5. 注意事项与最佳实践
- 避免循环重定向：当多个 rewrite 规则相互触发时，Nginx 会检测并发起错误。建议先用 return 处理简单重定向，再用 rewrite 处理内部路径转换。
rewrite 规则在 域名主机 内按出现顺序执行。若需跨域名，必须在 replacement 中写完整 URL，并加 permanent 或 redirect 标志。
- 性能优化：正则表达式尽量简洁；对于频繁的域名重写，使用 map 指令预定义映射表（例如从旧域名到新域名的字典），再通过 return 301 $map_value$request_uri 实现。这比逐条 rewrite 更高效。
- 测试与调试：在正式部署前，使用 curl 或 wget 检查响应状态码及 Location 头。也可开启 rewrite_log on; 查看错误日志中的重写过程。
6. 扩展：与 SSL 证书配合的域名重写
当域名主机启用了 HTTPS，需特别注意域名重写的方向。例如，强制将 HTTP 请求重定向到 HTTPS 时，应在 80 端口的 域名主机 中使用：
server { listen 80; server_name example.com www.example.com; return 301 https://$host$request_uri; }
这里的 $host 变量保留了原始域名，避免了跨域名证书错误。对于 www 和非www 的切换，建议先统一到 HTTPS，再在 443 端口的 域名主机 中做域名二次重写。
7. 结构化数据：常见 rewrite 规则性能对比
下表汇总了不同实现方式的优缺点：
| 方法 | 适用场景 | 性能 | 可维护性 |
| return 301/302 | 简单跨域名重定向 | 高（Nginx内部处理） | 高 |
| rewrite … permanent | 带正则路径的跨域名重定向 | 中（需正则匹配） | 中 |
| rewrite … last | 内部路径重写（同域名） | 高（无网络开销） | 中 |
| map + return | 大量域名映射 | 高（预编译哈希） | 高 |
| if + rewrite | 复杂条件逻辑 | 低（易触发异常） | 低 |
8. 总结
nginx域名rewrite 是服务器配置中的核心技能，它架起了用户感知的域名与内部域名主机资源之间的桥梁。正确运用 rewrite 与 return 指令，结合正则表达式与变量捕获，可以实现从裸域名迁移到高级URL美化等各类需求。建议优先使用 return 处理跨域名重定向，使用 rewrite … last 处理内部路径转换，并善用 map 简化大量映射。合理规划域名与域名主机的结构，不仅能提升访问速度，还能有效保护SEO排名。通过本文所列举的表格和示例，读者可以快速构建稳健、高效的域名rewrite方案。
