nginx -t 命令输出 nginx 当前运行时实际加载的完整合并配置，包含所有 include 文件、预处理指令和默认值补全，需以主进程相同用户权限执行且 nginx 必须已启动，常用于线上配置备份与排查。
nginx -T 是 Nginx 提供的一个非常实用的调试命令，它会输出当前 Nginx 进程实际加载并生效的**完整、合并后的配置内容**（包括所有 include 的文件、经过预处理的指令、默认值补全等），非常适合用于线上环境配置备份、问题排查或迁移前确认。
确保 Nginx 正在运行且权限正确
该命令依赖于正在运行的 Nginx 主进程（master process）读取其当前加载的配置上下文，因此：
- 必须以与 Nginx 主进程相同的用户身份执行（通常是 root 或 nginx 所在用户，如 www-data）；
- Nginx 必须已成功启动（
systemctl status nginx确认 active）； - 若使用非标准配置路径（如
-c /etc/nginx/nginx.conf启动），nginx -T仍会读取运行时实际加载的配置，无需额外指定。
执行 nginx -T 并重定向保存为备份文件
直接运行以下命令即可输出全部合并配置到终端。建议立即重定向保存：
sudo nginx -T > /backup/nginx-config-$(date +%Y%m%d-%H%M%S).conf 2>/dev/null
-
sudo：避免因权限不足导致部分 include 文件无法读取（尤其当配置中包含 root 权限路径的文件时）； -
2>/dev/null：过滤掉警告（如 “deprecated” 提示）或重复的“test is successful”信息，只保留纯净配置； - 时间戳命名便于版本管理和回溯，例如：
nginx-config-20240520-143022.conf。
验证备份配置是否完整可用
备份后建议快速校验，防止因权限/路径问题导致部分配置缺失：
- 检查文件头部是否有
# configuration file /etc/nginx/nginx.conf:类似注释，说明主配置被正确识别； - 搜索
server {或upstream关键字，确认业务相关块存在； - 可选：用
nginx -t -c /path/to/backup.conf测试语法（注意：需确保备份中所有include路径在当前环境可访问，否则会失败；nginx -T输出的是“展开后”的配置，不含未解析的 include 行，所以通常无需再测试）。
补充说明：和 nginx -t、nginx -V 的区别
避免混淆：
-
nginx -t：仅做语法检查和配置路径验证，不输出内容； -
nginx -V：显示编译参数和版本，不涉及运行时配置； -
nginx -T：唯一能真实反映“此刻 Nginx 实际执行哪段配置”的命令，含宏展开、变量默认值、多级 include 合并结果，是线上配置快照的黄金标准。
