了解清楚:/etc/nginx/nginx.conf 与 /etc/nginx/conf.d 完整区别

一、二者定位与作用

1. /etc/nginx/nginx.conf

Nginx 主核心配置文件，是服务启动时最先读取的总入口文件，存放全局顶层配置。

• 负责定义全局进程、连接、日志、HTTP通用参数；
• 内置导入语句，加载 conf.d 下所有网站配置：

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

该语句会自动读取 conf.d 文件夹下全部 .conf 文件，将所有站点配置合并进主配置。

2. /etc/nginx/conf.d/

它不是单个文件，是存放站点配置的目录，目录内新建 xxx.conf 文件，单独存放单个网站的 server{} 虚拟主机配置（例：你创建的 myweb.conf）。

• 用于拆分多网站配置，一个网站对应一个独立文件；
• 仅允许书写网站 server 块，不能写 events、worker 等全局顶层配置。

二、核心对比表格

对比维度	/etc/nginx/nginx.conf（主配置文件）	/etc/nginx/conf.d/*.conf（站点分片文件）
层级关系	顶层全局主文件	被主文件引入的分片站点配置
可写入内容	全局参数、events、http公共配置、include导入语句	仅单个网站的 server{} 虚拟主机配置
修改影响范围	改动影响整个Nginx服务全局	仅影响当前单个网站，站点之间互不干扰
多站点维护	所有网站写在此处会杂乱，不易管理	一网站一文件，增删站点清晰便捷
出错风险	语法错误会导致整个Nginx无法启动	单个文件出错，其余网站可正常运行

三、Nginx配置加载完整流程

1. Nginx启动或执行 reload 重载，优先读取 nginx.conf；
2. 执行到 include /etc/nginx/conf.d/*.conf;；
3. 自动加载 conf.d 目录下全部 .conf 文件，把所有 server 配置合并到 http 块中；
4. 合并完成后统一校验全部配置语法，配置生效。

四、生产环境实操规范

• 不修改 nginx.conf 默认内容，仅保留系统自带全局配置，不在主文件内写任何网站 server；
• 所有网站配置统一放在 conf.d 目录，每个网站单独新建 conf 文件；
• 新增、修改网站配置后，固定流程：sudo nginx -t 语法校验 → sudo systemctl reload nginx 平滑重载。

五、直观代码示例

nginx.conf 简化结构

# 全局进程配置
worker_processes auto;

events {
    worker_connections 1024;
}

http {
    include mime.types;
    sendfile on;
    # 导入conf.d目录所有站点配置
    include /etc/nginx/conf.d/*.conf;
}

conf.d/myweb.conf 站点配置（仅网站内容）

server {
    listen 80;
    server_name localhost;
    location / {
        root /home/ubuntu/mywebsite;
        index index.html;
    }
}

---

---

一、配置文件组织逻辑

1. 五层分级结构（作用域由大到小：全局块 > events > http > server > location）

# 1.全局块（main）：作用全部Nginx进程，全局生效
worker_processes auto;
pid /run/nginx.pid;
error_log /var/log/nginx/error.log;

# 2.events块：仅控制Worker网络并发、IO模型
events {
    use epoll;
    worker_connections 1024;
}

# 3.http块：所有网站共用的HTTP通用配置，包含全部虚拟主机server
http {
    include mime.types;
    sendfile on;
    gzip on;

    # 虚拟主机1
    server {
        listen 80;
        server_name www.a.com;
        location / {}
    }
    # 虚拟主机2
    server {
        listen 80;
        server_name www.b.com;
        location / {}
    }
}

2. 组织逻辑规则

• 作用域逐级缩小：上层配置是下层默认值，下层配置可覆盖上层参数。
  例：http内开启gzip，单个server写入gzip off，则仅该网站关闭压缩。
• 多站点拆分规范
  不把所有server写入主nginx.conf，在/etc/nginx/conf.d/新建独立站点配置文件，通过 include /etc/nginx/conf.d/*.conf; 统一引入，方便分站点维护。
• 继承覆盖优先级：location > server > http，内层配置优先级高于外层。

二、Server与 Location块详解

（一）Server块：虚拟主机，对应一个独立网站

server {
    listen 80;                # 监听端口，多网站可共用80，靠域名区分
    listen [::]:80;            # 兼容IPv6访问
    server_name test.com www.test.com;  # 匹配访问域名，空格分隔多域名
    server_name _;             # 兜底匹配：所有未匹配域名全部进入此server
    access_log /var/log/nginx/test.log; # 独立站点专属访问日志，覆盖http全局日志
}

Server匹配规则

1. 第一步：匹配客户端请求的 listen 端口；
2. 第二步：相同端口下，优先精准匹配 server_name 域名；
3. 第三步：无匹配域名时，进入 server_name _; 兜底默认站点。

（二）Location块：URL路径规则，单网站内细分请求处理逻辑

1. location匹配优先级（从高到低，越靠前越优先命中）

1. = 精确完全匹配（最高优先级）

location = /login { return 200 "登录页"; }

3. ^~ 前缀匹配，匹配成功后不再检索正则规则

location ^~ /static/ { root /data/html; }

5. ~ 区分大小写正则、~* 不区分大小写正则

location ~* \.(jpg|png|css)$ { expires 7d; }

7. 普通前缀匹配（最低优先级）

location /api { proxy_pass http://127.0.0.1:3000; }

2. 核心路径指令 root / alias 区别

① root：路径拼接模式

location /img {
    root /data/html;
    # 访问 /img/1.jpg → 真实文件路径 /data/html/img/1.jpg
}

② alias：路径替换模式（末尾/必须对齐，否则路径出错）

location /img {
    alias /data/static/;
    # 访问 /img/1.jpg → 真实文件路径 /data/static/1.jpg
}

3. location常用业务场景

• 静态资源发布：root + index + expires 浏览器缓存
• 后端接口转发：proxy_pass 反向代理
• 访问控制：防盗链、IP限流、自定义404页面、rewrite重定向

三、静态网页发布实战

步骤1：准备静态网页资源目录与首页

# 创建站点存放目录
mkdir -p /data/test_html
# 写入测试首页
echo "我的静态网站" > /data/test_html/index.html

步骤2：新建站点独立配置文件 /etc/nginx/conf.d/test.conf

server {
    listen 80;
    server_name test.local;

    # 匹配全部根路径，提供静态首页
    location / {
        root /data/test_html;
        index index.html index.htm;
        expires 1h; # 浏览器缓存静态页面1小时
    }

    # 图片资源单独设置7天长缓存
    location ~* \.(png|jpg|gif)$ {
        root /data/test_html;
        expires 7d;
    }
}

步骤3：遵循强制规范：先测试，后重载（下一节详解）

步骤4：本地验证页面是否正常

curl localhost

浏览器访问服务器公网IP或绑定的域名，即可打开静态页面。

四、强制规范：先测试，后重载

1. 必须先测试的原因

修改配置后直接重载存在线上风险：

1. 轻度语法错误：重载失败，旧配置继续运行，修改完全不生效；
2. 严重语法错误：Nginx进程直接崩溃，网站全站无法访问。

nginx -t 会完整解析全部配置，提前输出错误行数与报错原因，规避故障。

2. 标准完整操作流程

第一步：校验全部配置语法

sudo nginx -t

• 成功提示：test is successful，可以执行重载；
• 失败提示：输出配置文件路径+错误行号，返回修改配置文件。

第二步：平滑重载配置（零停机，不中断在线用户）

sudo systemctl reload nginx

**重载原理：**Master主进程保留旧Worker处理已有请求，同时拉起加载新配置的新Worker；旧Worker处理完现有连接后自动销毁，全程用户无感知。

补充区分 reload 与 restart

• reload：平滑热更新，线上业务修改配置必须使用；
• restart：强制杀死所有进程，断开全部用户连接，仅重装、服务故障修复场景使用。

完整实操示例流程

# 1. 编辑站点配置文件
vim /etc/nginx/conf.d/test.conf
# 2. 语法校验
sudo nginx -t
# 3. 无报错再平滑重载
sudo systemctl reload nginx
# 4. 访问验证页面是否生效
curl localhost

=============

Nginx静态网站部署实操全总结（含细节+踩坑复盘）

Nginx静态网站部署实操全总结（含细节+踩坑复盘）

一、本次实操核心目标

从零完成Linux Ubuntu + Nginx 静态网站部署，掌握目录创建、静态页面编写、Nginx虚拟主机配置、配置校验与热重载、故障排错全套标准流程。

二、完整实操步骤 & 核心细节讲解

1. 网站目录创建（核心参数 -p 详解）

mkdir -p /home/ubuntu/mywebsite

细节知识点：

• mkdir：Linux 创建文件夹命令

• -p 核心作用（重中之重）：

  • 自动创建多级不存在的父目录

  • 目录已存在时，不会报错，避免重复执行命令报错

2. 进入目录 & 编写静态首页

cd /home/ubuntu/mywebsiteecho "hello nginx" > index.htmlcat index.html

细节知识点：

• cd 命令仅能进入文件夹，绝对不能 cd 文件（本次初次操作踩坑点）

• > 重定向符号：创建/覆盖文件内容

• cat：读取文件内容，用于验证文件生成成功

3. 目录权限配置

chmod 755 /home/ubuntu/mywebsite/

权限细节：

• 755 权限：所有者可读可写可执行，其他用户（Nginx）可读可执行，保障服务正常访问文件

• 后续修复核心权限：chmod 755 /home/ubuntu，开放家目录访问权限

4. Nginx站点配置文件编写

sudo vim /etc/nginx/conf.d/myweb.conf

完整标准配置：

server {    listen 80;    server_name localhost;    location / {        root /home/ubuntu/mywebsite;        index index.html;    }}

逐行核心解析：

• server {}：一个独立虚拟主机，对应一个网站

• listen 80：网站监听80默认网页端口，外网无需带端口访问

• server_name localhost：匹配本机访问地址

• root：指定静态网页存放的真实服务器目录

• index index.html：指定网站默认首页文件

5. 行业强制规范：先测试，后重载

sudo nginx -tsudo systemctl reload nginx

核心规范细节：

• nginx -t：校验配置语法，提前排查错误，杜绝线上宕机

• reload：平滑热更新，不中断用户访问

• 禁止直接 restart：会强制断开所有连接

6. 本地访问测试

curl localhost

命令释义：

• curl：客户端URL请求工具（Client+URL）

• localhost：本机地址 127.0.0.1，访问服务器自身网站

三、本次实操所有踩坑记录 + 精准解决方案

踩坑1：cd 进入文件报错

错误命令：cd /home/ubuntu/mywebsite/index.html

报错：No such file or directory

原因：cd 命令只能进入文件夹，不能进入未创建的文件

解决：先 cd 进入目录，再创建文件

踩坑2：vim 路径拼写错误 + 权限不足

错误：/ect/nginx/（ect拼写错误，正确为etc） + 未加sudo

报错：E212: Can't open file for writing

原因：1.路径拼写错误 2.Nginx配置目录需要管理员权限

解决：使用正确命令 sudo vim /etc/nginx/conf.d/myweb.conf

踩坑3：reload 单词拼写错误

错误命令：sudo systemctl relaod nginx

报错：Unknown command verb relaod.

解决：正确拼写 reload

踩坑4：访问网站 403 Forbidden 权限拒绝

现象：curl localhost 返回Nginx 403页面

根本原因：Ubuntu家目录 /home/ubuntu 默认权限过严，Nginx运行用户www-data无法进入读取文件

终极解决：chmod 755 /home/ubuntu 开放家目录访问权限

四、关键知识点区分（必考重点）

1. 静态文件 vs 配置文件修改区别

• 修改 html静态页面：无需重载Nginx，实时生效

• 修改 Nginx .conf配置文件：必须 nginx -t + reload 才生效

2. 两层防火墙区别（外网访问必备）

• 服务器ufw防火墙：终端命令操作，本机层面放行端口

• 腾讯云安全组：网页控制台操作，云端外网第一道防火墙，服务器内无法修改

五、Vim编辑器实操必备技巧（本次常用）

• i：进入编辑模式，可写入代码

• Esc：退出编辑模式

• :wq：保存并退出（标准结束操作）

• :q!：强制退出、不保存（改错放弃用）

• u：撤销上一步操作

六、最终成功状态（本次实操验收标准）

• 网站目录、静态页面创建完成，权限配置正常

• Nginx配置语法检测成功：test is successful

• 配置平滑重载无报错

• curl localhost 正常输出自定义网页内容，无403/404报错

七、标准化固定工作流程（以后建站通用）

1. 创建网站目录 mkdir -p

2. 编写静态资源文件

3. 配置目录权限，规避403报错

4. 编写Nginx虚拟主机配置

5. 先校验：sudo nginx -t

6. 后重载：sudo systemctl reload nginx

7. 本地curl验证 + 外网浏览器验证

八、最后自测问答：

1. 755 权限三段数字分别代表什么？文件夹为什么必须带 x？

标准正确答案：

1. 755分三段：
   第一段7：文件所有者（rwx 读+写+进入）
   第二段5：同组用户（r-x 读+进入）
   第三段5：其他所有人（含nginx的www-data，r-x 读+进入）
2. 文件夹的x权限含义：允许进入目录、读取目录内文件列表；无x权限就算有r也无法访问内部文件，会出现403。

---

2. listen 80 和云安全组 80 端口关系？

标准正确答案：

listen 80：Nginx程序在本机操作系统的80端口监听请求；
云安全组是云平台外层防火墙，控制公网流量能否进入服务器；
两者互不冲突：本机监听80 + 安全组放行80，外网才能正常访问网站。

---

3. root 和 index 各自作用？

标准正确答案：

root：指定网站文件在服务器磁盘上的真实根目录，不会出现在浏览器URL地址栏；
匹配规则：磁盘路径 = root路径 + location匹配的URL路径
index：仅当访问路径是目录（结尾带/）时，自动补充读取index.html作为默认首页文件。

#示例
location / {
    root /home/ubuntu/serverFiles;
    index index.html;
}
#访问 http://IP/ 对应磁盘文件 /home/ubuntu/serverFiles/index.html
#浏览器地址只显示IP/，不会出现本地目录路径

重大理解错误：混淆磁盘路径与浏览器URL，root目录不会拼到网址里。

---

4. nginx -t 检查单文件还是全部配置？

简要：

首先检查的是全局的/etc/nginx/nginx.conf,根据其内容加载/etc/nginx/conf.d/*.conf

标准正确答案：

nginx -t 校验整套完整Nginx配置：

1. 先加载主配置 /etc/nginx/nginx.conf
2. 执行include导入conf.d下所有站点配置
3. 全局统一语法校验，任意一个conf文件报错，整体校验失败。

---

5. reload 和 restart 差别，线上用哪个？

标准正确答案：

reload：平滑热重载，不终止现有连接，旧连接正常完成，新请求加载新配置，生产环境优先使用；
restart：完全重启Nginx进程，强制断开所有用户访问，网站短暂不可用，线上禁止随意使用；
修改html静态资源无需执行任何重载命令；修改.conf配置文件必须执行reload。

回答完全正确。

---

6. 改 html 不用重载，改 conf 必须重载的原理？

标准正确答案：

html静态文件：每次用户发起请求，Nginx实时读取磁盘最新文件，运行期间不会缓存文件内容，修改立即生效；
conf配置文件：Nginx仅在启动、reload时一次性读取加载规则，运行中不会主动重读配置，修改后必须重载才能生效。

7. nginx 配置加载顺序、include 作用？

标准正确答案：

加载顺序：

1. Nginx启动/reload → 读取顶层主配置nginx.conf
2. 依次读取 main全局块 → events块 → http{}块
3. 执行include /etc/nginx/conf.d/*.conf，导入所有server站点配置
4. 全部配置合并完成后统一语法校验
   include作用：拆分多站点配置，一个网站一个conf文件，方便维护；
   配置优先级：http全局配置 < server虚拟主机 < location路径（下层覆盖上层）

---

8. location 四种匹配优先级顺序？

标准正确答案（从高到低）：

1. = 精确匹配（最高优先级）
2. ^~ 前缀匹配，匹配后跳过正则
3. ~（区分大小写正则） / ~*（不区分大小写正则）
4. 普通前缀匹配（最低优先级）

---

9. root 和 alias 路径拼接区别？

标准正确答案：

1. root规则：磁盘路径 = root目录 + location匹配路径

location /img {
    root /home/ubuntu/mywebsite;
}
#访问 /img/1.png → /home/ubuntu/mywebsite/img/1.png

2. alias规则：直接替换location匹配片段，推荐末尾加/

location /pic {
    alias /home/ubuntu/mywebsite/img/;
}
#访问 /pic/1.png → /home/ubuntu/mywebsite/img/1.png

这部分的内容我自己在初学的时候经常没有搞明白，其实代入到实际场景中就很好理解了:

什么时候必须用 alias？

URL 前缀 和 本地文件夹名称不一样，需要做路径映射时

场景举例：

本地图片文件夹叫 /img，但我想让用户访问 /pic 就能打开图片，名字对不上，只能用 alias。

alias 关键注意点：

alias 末尾尽量带 /，否则路径错乱报错

错误示例（无斜杠）：

location /pic {
    alias /home/ubuntu/mywebsite/img;
}
# 访问 /pic/1.png 会拼接成 /home/ubuntu/mywebsite/img1.png，找不到文件

主要记住就是root=拼接，alias=替换

---

10. expires 缓存作用，怎么用 curl 验证？

标准正确答案：

expires作用：告诉浏览器将图片、css、js等静态资源本地缓存指定天数，减少重复请求，提升访问速度、减轻服务器压力；
验证命令：curl -I localhost/img/test.png
-I 参数仅打印响应头，可查看 Cache-Control: max-age=xxx 缓存标识。

---

11. 如何配置自定义 404 页面？

标准正确答案：

1. 在网站根目录创建404.html自定义页面；
2. 在server{}块内添加配置：error_page 404 /404.html;
3. 执行 sudo nginx -t 校验语法，sudo systemctl reload nginx 生效；
   访问不存在路径时自动展示自定义404页面，替代Nginx默认英文报错。