rmdir.cn

nginx -t

检查配置语法与引用文件

语法

nginx -t [-c 配置文件] [-p 前缀目录]

说明

适用于每次修改配置后的上线前检查。-t 校验语法,并尝试打开配置引用的文件,例如日志或证书。检查不会应用新配置,也不能证明上游应用可用;必须使用与实际服务相同的二进制、配置路径和权限环境。

参数

  • -t

    检查配置,不启动服务

  • -c

    指定完整配置文件路径

  • -p

    设置相对路径使用的前缀目录

示例

检查默认配置

以管理员权限检查服务所需文件是否可访问。

sudo nginx -t

注意事项:只有检查成功后才进入重载步骤;检查通过不代表所有请求都会成功。

检查指定配置

使用实际部署路径替换示例文件。

sudo nginx -t -c /etc/nginx/nginx.conf

注意事项:指定文件必须是完整主配置,不能直接把仅含 server 块的片段当作主配置。

参考资料