Nginx 怎么使用 include 配置管理大量的 URL 重写规则-Nginx-PHP中文网

nginx 的 include 指令可将重写规则模块化拆分到独立文件（如 seo-redirects.conf），需在 server 或 location 块内引入，配合 map 模块可提升百条以上规则的性能与可维护性，修改后须执行 nginx -t 验证、reload 重载并测试响应。

nginx 怎么使用 include 配置管理大量的 url 重写规则

当 URL 重写规则越来越多时，把它们全堆在主配置文件（如 /etc/nginx/sites-available/default）里会变得难以维护、易出错、且不方便团队协作。Nginx 的 include 指令就是为此设计的——它能将外部文件“嵌入”到当前配置上下文中，实现模块化、可复用、易测试的规则管理。

把重写规则单独拆成文件

建议按业务或类型划分，比如：

/etc/nginx/rewrites/seo-redirects.conf：品牌词跳转、旧URL永久重定向（301）
/etc/nginx/rewrites/api-routes.conf：API 路径标准化，如 /v1/users → /api/v1/users
/etc/nginx/rewrites/legacy-pages.conf：老CMS页面迁移映射

每个文件只放 rewrite 或 return 指令，不带 server 或 location 块（除非明确需要局部作用域）。例如：

rewrite ^/about\.html$ /about permanent;<br>rewrite ^/products/(\d+)$ /item?id=$1 last;<br>return 301 https://$host$request_uri;

在 location 或 server 块中 include

不要在顶层直接 include —— 规则必须出现在能生效的作用域内。常见位置有：

在 server 块开头统一加载全局重定向（如域名跳转、HTTPS 强制）
在具体 location / 里 include 路由重写逻辑（如前端 SPA 的 history fallback）
在 location ~ \.php$ 外围 include 参数解析规则（避免干扰 FastCGI）

示例：

Nginx Hosting

通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载

server {<br>    listen 80;<br>    server_name example.com;<br><br>    # 全局 SEO 重定向<br>    include /etc/nginx/rewrites/seo-redirects.conf;<br><br>    location / {<br>        # 静态资源优先，再 fallback 到入口<br>        try_files $uri $uri/ @fallback;<br>    }<br><br>    location @fallback {<br>        # SPA 路由重写规则<br>        include /etc/nginx/rewrites/spa-routes.conf;<br>        rewrite ^(.*)$ /index.html last;<br>    }<br>}