include
'include' 指令允许在 NGINX 配置文件中包含配置文件,从而便于实现模块化配置。 — NGINX HTTP Core
include
语法include path;
默认值none
上下文
模块NGINX HTTP Core
参数1
说明
'include' 指令旨在通过允许包含其他配置文件来增强 NGINX 配置的模块化性和可维护性。这有助于将大型配置文件拆分为易于管理的部分,便于更新和组织。通过使用 'include' 指令,用户可以在单独的文件中定义公共设置,并在不同的配置上下文中按需包含这些文件,从而促进 DRY (Don't Repeat Yourself) 原则。 'include' 指令的参数由一个或多个配置文件的路径组成。该路径可以指定为绝对路径,也可以相对于当前工作目录的相对路径。也支持通配符,从而能够包含匹配指定模式的多个文件。当 NGINX 处理主配置文件时,会按出现的顺序解析并读取 'include' 指定的文件。这些文件中的指令随后会合并到当前上下文中,允许它们相应地影响配置设置。 'include' 包含的配置文件可以定义 NGINX 的各个方面,例如 location 块、server 设置或 upstream 配置。但是,应注意避免与主配置文件中现有设置发生冲突。如果包含的文件包含更改已定义配置的指令,则在合并后的配置中最后定义的值将优先。该灵活性使 'include' 指令成为结构化复杂 NGINX 配置的强大工具。
配置示例
# Example of using the 'include' directive include /etc/nginx/conf.d/*.conf;
⚠
确保包含的文件不含可能导致配置产生歧义的冲突指令。
⚠
如果当前工作目录发生变化,包含文件的相对路径可能会导致意外行为。
⚠
如果不仔细指定,使用通配符可能会包含意外的文件。