菜鸟教程

主题

Nginx 教程：目录结构与配置文件详解 ​

在安装 Nginx 后，理解其目录结构与配置文件非常重要。Nginx 的灵活性与性能很大程度上来源于其模块化配置设计。

一、Nginx 目录结构 ​

以下以 Linux 系统为例说明常见的 Nginx 目录结构：

bash
/etc/nginx/
├── nginx.conf          # 主配置文件
├── conf.d/             # 默认加载的附加配置目录
├── sites-available/    # 可用站点配置
├── sites-enabled/      # 启用站点配置
├── modules/            # 模块配置目录
├── logs/               # 访问与错误日志
└── html/               # 默认静态页面目录

关键目录说明 ​

  • nginx.conf：主配置文件，定义全局参数与包含子配置。
  • conf.d/：存放虚拟主机或模块配置。
  • logs/：记录 access.log 与 error.log。
  • html/：默认站点文件目录。

二、nginx.conf 配置文件结构 ​

主配置文件通常包含以下三个主要部分：

nginx
# 全局块
user  nginx;
worker_processes  auto;

# events 块
events {
    worker_connections  1024;
}

# http 块
http {
    include       mime.types;
    default_type  application/octet-stream;
    sendfile      on;
    keepalive_timeout  65;

    include /etc/nginx/conf.d/*.conf;
}

三、常见配置文件位置（按系统） ​

系统配置路径服务管理命令
CentOS / Rocky Linux/etc/nginx/nginx.confsystemctl restart nginx
Ubuntu / Debian/etc/nginx/nginx.confservice nginx reload
macOS (brew)/usr/local/etc/nginx/nginx.confbrew services restart nginx
Windowsconf/nginx.confnginx.exe -s reload

四、快速验证配置文件 ​

修改配置后，应使用以下命令验证：

bash
nginx -t

若输出 syntax is ok 和 test is successful，则表示配置文件语法正确。