Nginx 用 include 指令拆分配置本质是按逻辑切分混杂配置，实现功能分离、问题定位便捷、协作高效与扩展灵活；支持按功能类型（如 upstreams、log_formats、ssl、rewrites）集中定义并全局引入，或按业务/站点拆分为独立 server 块文件，还可将重定向规则单独归档便于维护；需注意 include 静态插入、路径正确、语法严谨、禁止循环引用，并须 nginx -t 测试后 reload 生效。
Nginx 用 include 指令拆分配置，本质是把一大段混杂的配置按逻辑切开，让每个文件只管一件事，既方便定位问题，也利于多人协作和后续扩展。
按功能类型分文件，统一放在全局或 http 块里引入
这类配置跨多个站点共用，适合集中定义、一次写好、到处引用：
-
upstreams.conf：只放upstream块，比如后端服务地址、健康检查、负载策略 -
log_formats.conf：定义log_format，后续所有server可直接用名称调用 -
ssl.conf：包含证书路径、TLS协议版本、密钥交换算法等，HTTPS站点 include 就能复用 -
rewrites.conf：放强制跳转 HTTPS、URL标准化、旧路径重定向等全局规则
这些文件应放在 /etc/nginx/conf.d/ 下（或其他你指定的目录），然后在 nginx.conf 的 http { } 块顶部或全局块中引入：
http {
include /etc/nginx/conf.d/upstreams.conf;
include /etc/nginx/conf.d/log_formats.conf;
include /etc/nginx/conf.d/ssl.conf;
include /etc/nginx/conf.d/rewrites.conf;
# 其他 http 级配置...
}按业务或站点拆，每个域名一个独立配置文件
适合多站点部署场景，每个 .conf 文件对应一个 server 块：
-
/etc/nginx/sites-enabled/example.com.conf -
/etc/nginx/sites-enabled/api.company.dev.conf -
/etc/nginx/sites-enabled/admin.internal.conf
在 http 块末尾用通配符统一加载：
include /etc/nginx/sites-enabled/*.conf;
注意：确保这些文件里只包含 server { ... } 或 map、geo 等允许在 http 上下文中使用的指令，不能出现 events、http 这类顶层块。
重定向规则单独归档，便于维护和审计
大量 301/302 跳转容易堆满主配置。建议建子目录专门管理：
/etc/nginx/conf.d/redirects/ ├── legacy-urls.conf # 旧产品路径迁移 ├── campaigns.conf # 临时活动页跳转 └── seo-fixes.conf # SEO 优化相关重定向
然后在对应 server 块里按需引入：
server {
listen 80;
server_name example.com;
include /etc/nginx/conf.d/redirects/legacy-urls.conf;
include /etc/nginx/conf.d/redirects/campaigns.conf;
# ...
}几个关键细节不能漏
-
include是启动时静态插入，不支持变量（比如include $env.conf;会报错） - 被引入的文件必须语法正确，哪怕一行少个分号也会导致
nginx -t失败 - 路径可以是绝对路径，也可以是相对路径（相对于 Nginx 配置根目录，默认是
/etc/nginx） - 不要循环引用，比如 A.conf include B.conf，B.conf 又 include A.conf
- 修改后必须执行
nginx -t测试语法，再nginx -s reload生效
不复杂但容易忽略。
