Nginx基础教程（4）Nginx开发准备之目录结构：Nginx目录结构详解：从入门到精通实战指南

Nginx目录结构与配置详解
原创 于 2025-11-27 08:01:20 发布 · 152 阅读 · 6 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#nginx #运维

当我们首次踏入Nginx的世界，就像进入一座陌生的建筑，了解它的目录结构是成为管理员的第一步。

初识Nginx：不只是Web服务器

先看一个有趣漫画里的场景：作为新生代的Nginx对已经22岁之老的Apache说，“一边去，老头，这80端口不用你看着了，你得给新人腾腾地方了！”而Apache则回应：“放尊重点，你觉得你已经能取代像我这样的老同志了吗？”

Nginx之所以如此“自信”，是因为它采用事件驱动和异步非阻塞的架构，能够轻松应对C10K（并发上万连接）问题。用一个生动的比喻来说，Nginx有一个master进程（中央政府）和多个worker进程（地方政府）。

master负责监管，worker负责实际处理请求，每个worker都能高效处理大量并发连接。

Nginx目录结构深度解析

让我们拿起手电筒，深入探索Nginx的目录大厦。标准的Nginx目录结构看起来是这样的：

/usr/local/nginx/
├── aaa
├── conf
│   ├── extra
│   ├── nginx.conf
│   ├── nginx.conf.default
│   └── conf.d/
├── fastcgi_temp
├── html
│   ├── 50x.html
│   └── index.html
├── logs
├── sbin
│   └── nginx
├── proxy_temp
└── scgi_temp

核心目录功能解析

1. conf目录：Nginx的大脑

conf目录是Nginx的指挥中心，存放所有配置文件。

在这里，nginx.conf是主配置文件，它就像Nginx的大脑，控制着整个服务器的行为。

配置文件的基本结构是这样的：

# 全局块
worker_processes 1;

# events块
events {
    worker_connections 1024;
}

# http块
http {
    include mime.types;
    default_type application/octet-stream;
    sendfile on;
    keepalive_timeout 65;
    
    # server块
    server {
        listen 80;
        server_name localhost;
        
        # location块
        location / {
            root html;
            index index.html index.htm;
        }
        
        error_page 500 502 503 504 /50x.html;
        location = /50x.html {
            root html;
        }
    }
    
    include /usr/local/nginx/conf.d/*.conf;
}

配置文件采用区块结构组织，从外到内依次是：main（全局）→ events（事件）→ http（HTTP服务）→ server（虚拟主机）→ location（URI定位）。

这种层次结构让配置变得清晰且灵活。

最佳实践：对于多虚拟主机的情况，建议使用include /usr/local/nginx/conf.d/*.conf;方式引入额外配置。这样可以将不同站点的配置分离，便于管理。

示例：创建一个kazihuo.conf虚拟主机配置

server {
    listen 80;
    server_name aaa.kazihuo.com;
    
    location / {
        root aaa;
        index index.html index.htm;
    }
}
2. html目录：静态内容的家

html目录是默认的静态资源存放位置，包括HTML、CSS、JavaScript和图片等。

当我们访问Nginx欢迎页面时，实际上访问的就是html/index.html文件。

3. sbin目录：控制中心

sbin目录存放Nginx的可执行文件，主要是nginx命令。

常用命令包括：

# 启动Nginx
/usr/local/nginx/sbin/nginx

# 重新加载配置
/usr/local/nginx/sbin/nginx -s reload

# 停止Nginx
/usr/local/nginx/sbin/nginx -s stop
4. logs目录：黑匣子

logs目录存放日志文件，包括访问日志（access.log）和错误日志（error.log）。这些日志是故障排查的重要依据。

5. 临时目录：数据处理车间

Nginx有多个临时目录：fastcgi_temp、proxy_temp、uwsgi_temp、scgi_temp，分别用于处理不同类型的动态内容临时文件。

Nginx配置实战：完整示例

基础配置：搭建静态资源服务器

让我们从一个完整的静态资源服务器配置开始：

# 全局配置
user nobody nobody;
worker_processes auto;
error_log logs/error.log info;

# 事件模块配置
events {
    use epoll;
    worker_connections 65535;
    multi_accept on;
}

# HTTP模块配置
http {
    include mime.types;
    default_type application/octet-stream;
    
    # 日志格式
    log_format main '$remote_addr - $remote_user [$time_local] "$request" '
                    '$status $body_bytes_sent "$http_referer" '
                    '"$http_user_agent" "$http_x_forwarded_for"';
    
    access_log logs/access.log main;
    
    # 性能优化设置
    sendfile on;
    tcp_nopush on;
    tcp_nodelay on;
    keepalive_timeout 65;
    server_tokens off;
    
    # 文件扩展名与类型映射
    types {
        application/javascript js mjs;
        text/css css;
        image/svg+xml svg;
    }
    
    # 静态资源服务器
    server {
        listen 80;
        server_name static.example.com;
        root /www/data;
        index index.html index.htm;
        
        # 启用gzip压缩
        gzip on;
        gzip_types text/plain text/css application/json application/javascript text/xml application/xml image/svg+xml;
        
        # 图片资源location
        location ~* \.(jpg|jpeg|png|gif|ico|webp)$ {
            expires 1y;
            add_header Cache-Control "public, immutable";
            try_files $uri $uri/ =404;
        }
        
        # 静态资源location (CSS, JS)
        location ~* \.(css|js)$ {
            expires 1M;
            add_header Cache-Control "public";
            try_files $uri $uri/ =404;
        }
        
        # 主location
        location / {
            try_files $uri $uri/ $uri.html =404;
        }
        
        # 启用目录列表
        location /downloads/ {
            autoindex on;
            autoindex_exact_size off;
            autoindex_localtime on;
        }
    }
}

虚拟主机配置：一站变多站

Nginx的强大之处在于可以轻松配置虚拟主机，实现在一台服务器上托管多个网站。

虚拟主机有三种类型：

  • 基于域名的虚拟主机（最常用，外部网站）
  • 基于端口的虚拟主机（公司内部网站）
  • 基于IP的虚拟主机（几乎不用）
http {
    # 第一个虚拟主机：主站点
    server {
        listen 80;
        server_name example.com www.example.com;
        root /www/example;
        index index.html;
        
        location / {
            try_files $uri $uri/ =404;
        }
    }
    
    # 第二个虚拟主机：博客站点
    server {
        listen 80;
        server_name blog.example.com;
        root /www/blog;
        index index.html;
        
        location / {
            try_files $uri $uri/ =404;
        }
        
        # API代理到后端应用
        location /api/ {
            proxy_pass http://localhost:3000;
            proxy_set_header Host $host;
            proxy_set_header X-Real-IP $remote_addr;
        }
    }
    
    # 第三个虚拟主机：状态监控
    server {
        listen 80;
        server_name status.example.com;
        
        location / {
            stub_status on;  # 启用状态页
            access_log off;
            allow 192.168.1.0/24;  # 只允许内网访问
            deny all;
        }
    }
}

目录映射：root vs alias详解

在Nginx中，root和alias指令都用于目录映射，但有着重要区别：

指令

拼接方式

适用场景

root

root + location + 剩余URI

整站、多层级目录

alias

alias + 剩余URI（location被丢弃）

单一目录、路径扁平化

root示例：

server {
    listen 80;
    server_name localhost;
    
    # 使用root：访问 http://localhost/site/index.html
    # 实际路径：D:/files/site/index.html
    location /site/ {
        root D:/files;  # root会保留location中的/site/
    }
}

alias示例：

server {
    listen 80;
    server_name localhost;
    
    # 使用alias：访问 http://localhost/static/1.jpg
    # 实际路径：D:/files/upload/1.jpg  
    location /static/ {
        alias D:/files/upload/;  # alias会丢弃location中的/static/
    }
}

常见坑：

  • alias末尾必须加斜杠：alias D:/files/upload/;
  • root与alias不要混用在同一location
  • Windows路径注意权限问题

Location规则：Nginx的路由系统

location指令根据用户请求的URI来执行不同的应用，是Nginx配置中最灵活的部分。

location匹配语法：

location [=|~|~*|^~|@] uri { ... }

location匹配优先级：

  1. = 精确匹配（最高优先级）
  2. ^~ 前缀匹配
  3. ~ 和 ~* 正则匹配（区分大小写和不区分大小写）
  4. 普通前缀匹配（最长匹配原则）

完整示例：

server {
    listen 80;
    server_name example.com;
    root /www/example;
    
    # 1. 精确匹配：最高优先级
    location = /logo.png {
        # 仅匹配 /logo.png，不匹配 /images/logo.png
        access_log off;
        expires 30d;
    }
    
    # 2. 前缀匹配
    location ^~ /images/ {
        # 匹配以/images/开头的所有URI
        access_log off;
        expires 30d;
        
        # 启用目录列表
        autoindex on;
        autoindex_exact_size off;
        autoindex_localtime on;
    }
    
    # 3. 正则匹配（区分大小写）
    location ~ \.php$ {
        # 匹配所有以.php结尾的URI
        fastcgi_pass 127.0.0.1:9000;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
    
    # 4. 正则匹配（不区分大小写）
    location ~* \.(jpg|jpeg|png|gif|ico)$ {
        # 匹配所有图片文件，不区分大小写
        expires 1y;
        add_header Cache-Control "public, immutable";
    }
    
    # 5. 普通前缀匹配
    location /api/ {
        # 代理到后端API服务器
        proxy_pass http://localhost:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
    
    # 6. 默认location
    location / {
        try_files $uri $uri/ /index.html;
    }
}

高级功能与性能优化

启用状态监控

想要了解Nginx的运行状态？启用状态模块吧：

server {
    listen 80;
    server_name status.example.com;
    
    location /nginx-status {
        stub_status on;
        access_log off;
        allow 192.168.1.0/24;  # 限制访问IP范围
        deny all;
    }
}

状态页面显示的信息包括：

  • Active connections：当前活动连接数
  • server accepts handled requests：已接受的连接数、已处理的连接数、处理的请求数
  • Reading：正在读取客户端请求头的连接数
  • Writing：正在向客户端写入响应信息的连接数
  • Waiting：等待请求的空闲连接数

性能优化技巧

启用高效文件传输：

location /mp3 {
    sendfile on;           # 启用高效文件传输
    sendfile_max_chunk 1m; # 限制每次sendfile调用传输的数据量
    
    tcp_nopush on;         # 在一个数据包中发送HTTP响应头
    tcp_nodelay on;        # 禁用Nagle算法，立即发送数据
    
    keepalive_timeout 65;  # 保持连接超时时间
}

启用内容压缩：

gzip on;
gzip_types 
    text/plain
    text/css
    text/xml
    text/javascript
    application/json
    application/javascript
    application/xml+rss
    image/svg+xml;
gzip_min_length 1024;
gzip_comp_level 6;

常见问题排查

权限问题

如果遇到403 Forbidden错误，检查目录权限：

# 给目录添加读取权限
chmod -R 755 /www/data
chown -R nginx:nginx /www/data

配置错误排查

# 检查配置文件语法
nginx -t

# 查看错误日志
tail -f /usr/local/nginx/logs/error.log

# 重新加载配置
nginx -s reload

中文目录问题

在Windows系统中，遇到中文目录乱码：

http {
    charset utf-8;  # 设置字符编码
    ...
}

总结：从目录结构到完整配置

通过本文的探索，我们了解了Nginx的目录结构、配置文件组织方式，以及各种实际应用场景的配置方法。

关键要点：

  1. conf目录是配置核心，nginx.conf是入口点
  2. 配置采用层次化区块结构：main → events → http → server → location
  3. root和alias都能实现目录映射，但工作原理不同
  4. location匹配规则有优先级，理解这一点至关重要
  5. 虚拟主机允许单台服务器托管多个网站

Nginx就像一座设计精巧的大厦，每个房间都有其特定用途。理解了它的目录结构和配置原理，你就能充分发挥这座大厦的功能，构建出高性能、高可用的Web服务。

现在，是时候动手实践，搭建属于你自己的Nginx服务器了！

Nginx基础篇（一）；Nginx的模块分类、目录结构、Nginx主配置文件详解
一点一滴铺就人生
11-06 2016
Table of Contents 一、模块分类及其作用 二、Nginx目录结构 三、Nginx主配置文件详解 Nginx Web服务器主要就是各种模块的工作。因此我们需要了解各种模块的大致功能及其分类。 一、模块分类及其作用 1、核心模块：HTTP模块、EVENT模块和MAIL模块等； HTTP 模块：用来发布http web服务网站的模块。 event模块：用来处理nginx ...
《Nginx从入门到精通：第一篇——基础安装与配置详解》
资深全栈架构师，乐于在 优快云 分享技术见解，与大家携手共进，共攀技术巅峰！
03-12 1176
虚拟主机（Virtual Host）是指在一台物理服务器上运行多个网站，每个网站都有自己的域名和独立的配置。Nginx通过server块来实现虚拟主机的配置。反向代理（Reverse Proxy）是指代理服务器接收客户端的请求，然后将请求转发给后端服务器，并将后端服务器的响应返回给客户端。反向代理可以隐藏后端服务器的真实IP地址，提高系统的安全性和可扩展性。通过本篇的学习，你已经掌握了Nginx的基础安装与配置技巧，包括虚拟主机配置、日志管理、静态文件服务、反向代理配置、安全性配置和性能优化等内容。
Nginx配置详解: 从基础入门到高级实战的全面指南
aa_hdkf_vg的博客
05-18 5229
在 Web 服务架构中，Nginx 以其卓越的高性能、高并发处理能力和灵活的配置特性，成为众多开发者和企业的首选 Web 服务器与反向代理工具。无论是静态资源服务、反向代理转发，还是负载均衡、安全防护，Nginx 都能通过合理的配置轻松实现。然而，Nginx 的配置语法相对复杂，不同模块与指令的组合使用方式多样，这也让不少初学者望而却步。本文我将从 Nginx 配置的基本结构出发，逐步深入到高级配置实践，并结合实际案例，帮你全面掌握 Nginx 配置的核心要点与技巧。
Nginx快速入门：安装目录结构详解及核心配置解读（二）
55555的博客
12-19 4402
如上，我们通过upstream定义了要转发的后台tomcat服务的列表，如果不做特殊定义，默认的负载均衡算法就是轮询算法，后续我们会单独开一章来详细说明nginx的负载均衡配置。然后在server中定义了监听的端口是80端口，这样当我们通过80端口进来的访问就会进入到这个转发配置中因为这里没有什么特殊的域名，所以server_name就定义了一个localhostlocation后指定了。
Nginx 配置全指南：从入门到实战
2301_80894737的博客
08-13 2333
Nginx 作为一款高性能服务器，功能强大且配置灵活。通过本文，你已经掌握了：静态资源托管反向代理HTTPS负载均衡💡。
使用Docker安装和配置Nginx：从入门到实践
✨ 欢迎来到【Seal ^_^ 的优快云博客】！✨
07-09 1万+
Docker部署Nginx实践指南 本文详细介绍了使用Docker容器化部署Nginx的完整流程。
深入解析Nginx配置文件：从入门到精通
xycxycooo的博客
08-14 7595
Nginx的配置文件通常位于（包管理器安装）或（源码编译安装）。此外，Nginx还支持通过include指令包含其他配置文件，常见的配置文件目录包括和。Nginx的配置文件是其强大功能的核心，通过灵活的配置指令和模块化设计，Nginx能够适应各种复杂的应用场景。本文详细介绍了Nginx配置文件的结构、常用指令和高级用法，帮助读者全面理解并掌握Nginx的配置技巧。希望本文能帮助读者更好地理解和应用Nginx，构建高效、稳定的Web系统。
【30天精通Prometheus：一站式监控实战指南】第17天：nginx-prometheus-exporter从入门到实战：安装、配置详解与生产环境搭建指南，超详细
大唐有趣的小胡.
06-03 3539
通过访问官网、选择并下载适合版本的nginx-prometheus-exporter，读者可以轻松完成安装并运行。文章还深入探讨了nginx-prometheus-exporter的配置文件和服务，以及在实战演练中，指导读者如何在生产环境中搭建，包括创建管理用户、解压安装包、集成到Prometheus、编辑服务文件等步骤。最后，通过启动服务并验证其正常运行，确保nginx-prometheus-exporter在生产环境中成功部署，为监控Nginx服务器性能提供有力支持。
深入学习Nginx：从入门到实践
热门推荐
聚焦于深度解析最新的编程语言特性、框架升级、架构设计、开发工具和最佳实践，涵盖Web前端（如Vue3, React, Angular等）、后端开发（如Node.js, Java, Python等）、移动端开发（iOS, Android原生及跨平台开发）
03-17 3万+
Nginx的功能远不止于此，还包括SSL/TLS加密传输、限速控制、重写规则、防盗链设置等诸多高级特性。理解并熟练运用Nginx的各项配置和技术，将极大提升您的Web服务架构水平。不断实践与探索，结合业务需求灵活调整Nginx配置，才是持续优化服务性能的关键所在。
Nginx从入门到精通
qq_45443475的博客
09-24 3712
Nginx从入门到精通
Nginx快速入门：负载均衡upstream配置详解（四）
55555的博客
12-21 8651
今天我们学习了nginx的负载均衡模块upstream，包括nginx支持的负载均衡策略以及容灾策略，通过案例实际演示了我们如何实现负载均衡配置和主备节点搭建，要真正掌握知识，还需要大家一起根据文章实际演练。除了多节点的负载均衡转发，我们还有单节点的不同业务转发，根据域名的转发，各种各样的转发、代理配置，下一节，我们将继续讲解nginx的各种转发配置。
负载均衡实战项目搭建指南：Nginx+SpringBoot高可用架构源码教程
11-11
本资源提供完整的负载均衡实战项目搭建指南，基于Nginx和SpringBoot实现高可用架构。内容涵盖负载均衡原理、Nginx配置详解、SpringBoot微服务集成、健康检查机制、会话保持策略等核心技术。通过源码示例和实战部署，...
Nginx入门到精通搭建高可用集群负载均衡
08-14
**Nginx 知识点详解** Nginx 是一款高性能的 HTTP 和反向代理服务器，因其稳定性、高效性能和低资源消耗而受到广泛应用。它最初由伊戈尔·赛索耶夫为 Rambler.ru 站点开发，自 2004 年发布以来，已经发展成为许多...
负载均衡实战项目搭建指南：Nginx+SpringBoot高可用架构教程与源码解析
11-08
本资源提供一套完整的负载均衡实战项目搭建指南，基于Nginx和SpringBoot构建高可用架构。内容涵盖负载均衡核心原理、Nginx配置详解、SpringBoot微服务集成、健康检查机制实现等关键技术点。通过实际项目案例，手把手...
从入门到精通：Nginx运维秘籍大公开
大雨的博客
05-26 1336
Nginx 运维涵盖了从基础操作到进阶技巧，再到实战演练和监控维护的多个层面，每一个环节都紧密相连，共同保障着 Web 服务的稳定高效运行。通过安装 Nginx，我们开启了这一技术之旅，掌握启动、停止与重启的方法，如同掌握了机器运转的开关。深入了解配置文件的结构，让我们能够根据业务需求，灵活调整 Nginx 的行为，使其更好地服务于我们的应用。在进阶技巧部分，负载均衡配置让我们能够合理分配请求，充分利用后端服务器资源；缓存设置提升了访问速度，减轻了服务器压力；
对Docker部署的MySQL中的数据进行备份恢复
2509_94228395的博客
11-25 343
使用Docker部署的MySQL进行备份/恢复与传统方式类似，但需要考虑Docker容器的特殊性。以下是详细的步骤，帮助你在Docker环境中进行MySQL的全量备份。
yum安装redis
最新发布
2509_94010562的博客
11-25 303
如果你没有配置密码，那这个时候你可以使用了，如果配置了密码，还需要授权密码才能使用。如果没有你所需要的版本，那建议你用二进制压缩包方式安装redis。输入info可查看redis信息。
docker部署mqtt之Mosquitto
阿拉斯攀登
11-24 984
本文详细介绍了在CentOS7.9系统上通过Docker部署MQTT服务的完整流程。主要内容包括：使用Eclipse Mosquitto镜像创建容器，配置持久化存储和端口映射；设置MQTT基础配置，支持匿名访问或密码认证；可选SSL加密配置步骤；以及使用MQTTX工具或命令行进行服务测试的方法。文章还提供了容器管理命令、常见问题排查方案，特别强调了生产环境中启用密码认证和SSL加密的重要性。该方案具有轻量、易维护的特点，适合物联网等需要MQTT通信的场景。
Nginx配置详解与虚拟主机实战指南
dfl2504的博客
11-24 586
Nginx的配置核心在于理解主配置文件的三层结构（全局块、events块、http块），而虚拟主机则是通过server块实现多网站隔离部署的关键技术。实际应用中，基于域名的虚拟主机因灵活性高成为主流选择，配合静态资源缓存、错误页面定制等配置，可大幅提升网站性能与用户体验。建议大家在实践中逐步优化配置，如针对高并发场景调整和，针对静态资源配置CDN或浏览器缓存，针对动态服务配置反向代理与负载均衡。后续将继续分享Nginx反向代理、负载均衡等高级配置技巧，敬请关注！
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

值引力

持续创作，多谢支持！

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值