Web 服务器与网关 / 系统课时

Nginx 配置文件放在哪里

Nginx 配置文件放在哪里

改了一个看起来正确的配置文件,重载后却没有变化,常见原因是运行实例根本没有读它。本篇从进程参数找到主配置,再沿 include 核对站点文件,最终确认修改确实进入了 Nginx 读取的配置集合。

学习目标

  • 确认当前实例使用的主配置路径。
  • 判断 include 文件被放进了哪个配置上下文。
  • 使用展开配置验证站点文件是否实际加载。

路径要与运行实例对应

发行版软件包常使用 /etc/nginx/nginx.conf,源码安装也可能使用 /usr/local/nginx/conf/nginx.conf。若启动命令带有 -c,它会指定另外的主配置;-p 还可以改变路径前缀。因此不能只凭磁盘上存在某个文件就认定它正在生效。

先查看服务定义 systemctl cat nginx 中的启动命令,再查看 ps -eo pid,args 中的 Master 命令行。对于手动运行的实例,后续检查与重载都应使用相同的二进制、主配置和路径前缀。命令行参数说明列出了 -c、-p 和 -V 的用途。

include 继承插入位置

片段示例:下面是一份主配置的结构示范,绝对路径须按实际机器准备;events 和 http 放在顶层,站点文件则在 http 内被展开。

nginx
events { worker_connections 512; }
http {
    include /etc/nginx/mime.types;
    # 这里的文件应包含 server 块,不能再套一层 http。
    include /etc/nginx/conf.d/*.conf;
}

include 相当于在当前位置读取另一份配置;它不会自动识别“这是站点文件”并改变上下文。include 指令允许文件名或匹配模式,因此 demo.conf.bak 不会被 *.conf 命中,另存的备份若仍以 .conf 结尾则可能被意外加载。

主配置中的 include 将站点文件放入 http 上下文

Debian 系软件包还可能在 http 中 include sites-enabled/*,通过符号链接启用 sites-available 中的文件;这些目录约定不是 Nginx 自动扫描规则。真正决定读取范围的是主配置里的 include,不能假定每一种安装都有同样目录。

展开并核对目标文件

已确认系统实例使用 /etc/nginx/nginx.conf 时执行:

bash
# 同时做配置检查,并将实际读入的文件内容保存到受控临时文件。
sudo nginx -T -c /etc/nginx/nginx.conf > /tmp/nginx-expanded.conf
grep -F '# configuration file /etc/nginx/nginx.conf:' /tmp/nginx-expanded.conf

预期输出:

text
# configuration file /etc/nginx/nginx.conf:

检查成功信息会另外写到终端的标准错误。继续在展开文件中查找目标 server_name 和站点路径;若没有它,应先修正 include、扩展名或启用链接,再重做检查。展开配置可能包含内部地址或凭据,不应公开粘贴完整文件。

检查成功不等于已加载

nginx -T 展示本次命令从磁盘读取的内容,不是从存活 Worker 内存中导出的快照。即使检查成功,运行实例仍可能尚未重载,或你检查的是另一份主配置。最终要使用同实例的重载方式,再用目标域名和路径发送请求验证实际响应。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

Nginx 配置文件放在哪里

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通