✨ 前言：

作为一名从零开始学习Nginx配置的开发者，我在初次部署静态网站时，面对Nginx复杂的配置文件结构感到十分困惑。nginx.conf、sites-available、sites-enabled等目录和文件各自承担着什么职责？它们之间又是如何协同工作的？经过深入研究和实践验证，我整理出了一些初学nginx时的常见问题，以问题的形式为新手建立对nginx的整体认识，希望能帮助初学者快速掌握Nginx的核心配置逻辑。

🛠️环境：

操作系统：Ubuntu 22.04 LTS🐧

nginx版本：nginx/1.18.0 (Ubuntu)

❓常见问题解答：

Q1：nginx配置文件有哪些 ?

📂Nginx 配置文件结构总览

配置文件/目录 路径示例 主要作用 核心配置项/内容 使用说明
nginx.conf (主配置文件) /etc/nginx/nginx.conf 全局配置入口，定义Nginx运行的基础参数 - user, worker_processes - events块 - http块 - include指令 相当于程序的 main 函数，不应将站点配置直接写入此文件
sites-available/ (可用站点目录) /etc/nginx/sites-available/ 存储所有可用的虚拟主机（站点）配置模板 - 各站点的 server块配置 - 默认包含 default模板文件 1. 新增配置时推荐复制 default模板修改 2. 此目录中的配置不会自动生效
sites-enabled/ (启用站点目录) /etc/nginx/sites-enabled/ 存储实际生效的站点配置的符号链接 - 指向 sites-available目录的软链接 - 被主配置文件通过 include引入 1. 通过 ln -s创建软链接来启用配置 2. 删除软链接即可禁用站点 3. 只有这里的配置才会被加载
conf.d/ (配置片段目录) /etc/nginx/conf.d/ 存放模块化配置片段和通用配置 - SSL/TLS 相关配置 - 反向代理通用设置 - 全局重写规则 - 自定义日志格式 1. 通常被主配置文件优先加载 2. 适合存放跨站点共享的配置 3. 文件通常以 .conf结尾

⚖️配置加载顺序与优先级关系

加载顺序 配置文件/目录 优先级说明
1 nginx.conf中的直接配置 基础设置，作为后续配置的框架
2 conf.d/*.conf 通用配置片段，可被后续配置覆盖
3 sites-enabled/* 最终生效的站点配置，优先级最高

Q2：nginx有哪些模块，组织结构是什么？

nginx.conf是配置文件的入口，一个完整的nginx.conf模块组织结构如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
user www-data;
worker_processes auto;
pid /run/nginx.pid;
include /etc/nginx/modules-enabled/*.conf;

events {
  ...  
}

http {
    #server模块1
    server {
        ...
    }
    #server模块2
    server {
        ...
    }
}

结构图示：

Q3：在sites-available目录中新增了一个配置文件，怎么让其生效？

要让sites-available目录中新建的配置文件生效，需要创建一个符号链接到/etc/nginx/sites-enabled目录中。这样做可以启用你的新配置文件。使用以下命令来创建符号链接：

1
sudo ln -s /etc/nginx/sites-available/your_config_file /etc/nginx/sites-enabled/

在这个命令中，your_config_file是你在sites-available目录中新建的配置文件的名称。创建了符号链接后，重新加载Nginx配置文件，使得新的配置生效：

1
sudo systemctl reload nginx

Q4：怎样禁用sites-enabled目录中的某个配置文件?

要禁用sites-enabled目录中的某个配置文件，删除它即可，符号链接类似于windows系统中的快捷方式，删除掉以后，原文件还是存在于sites-availabled目录中。

1
sudo rm /etc/nginx/sites-enabled/your_config_file #删除配置文件符号链接

Q5：在sites-enabled中有一个文件名是黑底粉红色的，这代表什么意思?

在Linux系统中，黑底粉红色的文件名表示该符号链接指向的原始文件或目录不存在。这会导致nginx启动配置文件失败。

Q5: 修改nginx配置文件后，怎么使其生效？

与新增配置文件相同，修改配置文件后，也需要重新加载nginx以使更改生效🔄，使用如下命令重载nginx服务：

1
sudo systemctl reload nginx

Q6：可以举一个nginx网站代理的示例配置吗？

以下是一个nginx web服务的server模块基础配置模版📋，该服务监听了本机80端口

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
server {
    listen 80;
    server_name example.com www.example.com;
    
    root /var/www/html; # 静态资源服务
    index index.html index.htm; 
    
    # 处理请求的逻辑：
    # 1. 先尝试访问$uri对应的文件
    # 2. 如果不存在则尝试访问$uri/目录
    # 3. 都失败则返回404
    location / {
        try_files $uri $uri/ =404;
    }
    
    # 静态资源缓存策略
    location ~* \.(jpg|jpeg|png|gif|ico|css|js)$ {
        expires 365d;
        add_header Cache-Control "public, no-transform";
    }
}

Q7：nginx配置后启动失败，如何排查错误？

1.首先排查是否有语法错误，使用如下命令：

1
sudo nginx -t

2.如果没有语法错误，则查看nginx错误日志进一步排查：

1
tail -f /var/log/nginx/error.log

希望这篇指南能帮助你快速上手Nginx配置！🎉 如果还有其他问题，欢迎在评论区留言讨论💬