Nginx配置详细解析与新手指导

最新推荐文章于 2025-11-23 19:53:25 发布
原创 最新推荐文章于 2025-11-23 19:53:25 发布 · 395 阅读 · 7 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#nginx #运维

\conf\nginx.conf


worker_processes 1;

events {
    worker_connections 1024;
}

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

    server {
        listen 8025;
        server_name localhost;

        # 根路径处理
        location / {
            root html;
            index index.html index.htm;

            # 单页应用路由支持（处理点击页面刷新，提示404的问题）
            try_files $uri $uri/ /index.html;

            # 禁用缓存
            add_header Cache-Control "no-cache, no-store, must-revalidate";
            add_header Pragma "no-cache";
            expires -1;
        }

        # 代理设置
        # 处理跨域问题，Nginx 用的是 8025 端口，Tomcat 用的是 8080 端口，这就存在跨域的情况
        # 前端请求：http://localhost:8025/api/users
        # Nginx 转发：http://localhost:8080/users
        location /api/ {
		  proxy_pass http://localhost:8080/;

            # 设置用户客户端的请求头
            proxy_set_header Host $host;
            proxy_set_header X-Real-IP $remote_addr;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
            proxy_set_header X-Forwarded-Proto $scheme;
        }

        # 错误页面处理
        error_page 500 502 503 504 /50x.html;
        location = /50x.html {
            root html;
        }
    }
}

我来为您详细解析这个 Nginx 配置文件，我会从基础概念开始逐步讲解：

1. 全局配置部分

nginx

worker_processes  1;

  • 作用：设置 Nginx 工作进程的数量

  • 说明：数字 1 表示只启动 1 个 worker 进程。在生产环境中，通常设置为 CPU 核心数

nginx

events {
    worker_connections  1024;
}

  • 作用：配置事件处理模型和连接数限制

  • 说明：每个 worker 进程最多可以同时处理 1024 个连接

2. HTTP 模块基础配置

nginx

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

  • include mime.types：引入 MIME 类型定义文件，让 Nginx 能识别不同文件扩展名的 Content-Type

  • default_type：当无法确定文件类型时，默认作为二进制流处理（浏览器会下载而非显示）

  • sendfile on：启用高效文件传输模式，提升静态文件传输性能

  • keepalive_timeout 65：保持客户端连接超时时间为 65 秒

3. Server 块配置

nginx

server {
    listen       8025;
    server_name  localhost;

  • listen 8025：监听 8025 端口

  • server_name localhost：服务器名称为 localhost，匹配访问的域名

4. 主要 Location 块

根路径处理

nginx

location / {
    root   html;
    index  index.html index.htm;
    
    # 单页应用路由支持
    try_files $uri $uri/ /index.html;
    
    # 禁用缓存配置
    add_header Cache-Control "no-cache, no-store, must-revalidate";
    add_header Pragma "no-cache";
    expires -1;
}

详细解释：

  • root html：网站根目录为 Nginx 安装目录下的 html 文件夹

  • index：默认索引文件为 index.html 或 index.htm

  • try_files：解决前端路由刷新 404 问题的关键

    • $uri → 尝试访问请求的文件

    • $uri/ → 尝试作为目录访问

    • /index.html → 都失败则返回 index.html（前端路由接管）

  • 缓存控制：完全禁用浏览器缓存，确保每次都是最新内容

API 代理配置

nginx

location /api/ {
    proxy_pass http://localhost:8080/;
    
    # 请求头传递
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
}

代理工作原理：

text

前端请求：http://localhost:8025/api/users
Nginx 转发：http://localhost:8080/users

请求头作用：

  • Host $host：保持原始请求的 Host 头

  • X-Real-IP $remote_addr：传递客户端真实 IP

  • X-Forwarded-For：记录请求经过的代理链

  • X-Forwarded-Proto：传递原始请求协议（http/https）

5. 错误页面配置

nginx

error_page   500 502 503 504  /50x.html;
location = /50x.html {
    root   html;
}

  • 当出现 500、502、503、504 错误时，显示 html/50x.html 页面

配置文件整体结构总结

text

nginx.conf
├── 全局配置 (worker_processes)
├── 事件配置 (events)
└── HTTP 配置 (http)
    ├── 基础设置 (MIME类型、传输优化等)
    └── 虚拟主机 (server)
        ├── 监听配置 (listen, server_name)
        ├── 静态文件服务 (location /)
        ├── API 代理 (location /api/)
        └── 错误页面处理

使用场景

这个配置非常适合：

  1. 前后端分离项目：前端使用 Vue/React/Angular 等框架

  2. 开发环境：解决跨域问题和前端路由问题

  3. 单页应用部署：确保路由刷新正常显示

增加超时设置，解决请求超过1分钟报错404的问题


worker_processes 1;

events {
    worker_connections 1024;
}

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

    server {
        listen 8025;
        server_name localhost;

        # 根路径处理
        location / {
            root html;
            index index.html index.htm;

            # 单页应用路由支持（处理点击页面刷新，提示404的问题）
            try_files $uri $uri/ /index.html;

            # 禁用缓存
            add_header Cache-Control "no-cache, no-store, must-revalidate";
            add_header Pragma "no-cache";
            expires -1;
        }

        # 代理设置
        # 处理跨域问题，Nginx 用的是 8025 端口，Tomcat 用的是 8080 端口，这就存在跨域的情况
        # 前端请求：http://localhost:8025/api/users
        # Nginx 转发：http://localhost:8080/users
        location /api/ {
		  proxy_pass http://localhost:8080/;

            # 设置用户客户端的请求头
            proxy_set_header Host $host;
            proxy_set_header X-Real-IP $remote_addr;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
            proxy_set_header X-Forwarded-Proto $scheme;

            # 超时设置
            proxy_connect_timeout 90s;    # 连接后端服务器的超时时间
            proxy_send_timeout 300s;      # 向后端发送请求的超时时间  
            proxy_read_timeout 300s;      # 从后端读取响应的超时时间
        }

        # 错误页面处理
        error_page 500 502 503 504 /50x.html;
        location = /50x.html {
            root html;
        }
    }
}

增加 WebSocket 代理


worker_processes 1;

events {
    worker_connections 1024;
}

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

    server {
        listen 8025;
        server_name localhost;

        # 根路径处理
        location / {
            root html;
            index index.html index.htm;

            # 单页应用路由支持（处理点击页面刷新，提示404的问题）
            try_files $uri $uri/ /index.html;

            # 禁用缓存
            add_header Cache-Control "no-cache, no-store, must-revalidate";
            add_header Pragma "no-cache";
            expires -1;
        }

        # 代理设置
        # 处理跨域问题，Nginx 用的是 8025 端口，Tomcat 用的是 8080 端口，这就存在跨域的情况
        # 前端请求：http://localhost:8025/api/users
        # Nginx 转发：http://localhost:8080/users
        location /api/ {
		  proxy_pass http://localhost:8080/;

            # 设置用户客户端的请求头
            proxy_set_header Host $host;
            proxy_set_header X-Real-IP $remote_addr;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
            proxy_set_header X-Forwarded-Proto $scheme;

            # 超时设置
            proxy_connect_timeout 90s;    # 连接后端服务器的超时时间
            proxy_send_timeout 300s;      # 向后端发送请求的超时时间
            proxy_read_timeout 300s;      # 从后端读取响应的超时时间
        }

        # WebSocket代理
        location /ws/ {
            # 保留 /ws/ 路径
            proxy_pass http://localhost:8080/ws/;
            proxy_http_version 1.1;
            proxy_set_header Upgrade $http_upgrade;
            proxy_set_header Connection "upgrade";
            proxy_set_header Host $host;

            # 移除Origin头，让后端认为是同源请求
            proxy_set_header Origin "";

            # 设置用户客户端的请求头
            proxy_set_header X-Real-IP $remote_addr;
            proxy_set_header X-Forwarded-Proto $scheme;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
            proxy_set_header X-Forwarded-Port $server_port;

            # 超时设置
            proxy_connect_timeout 60s;    # 连接后端服务器的超时时间
            proxy_read_timeout 60s;       # 向后端发送请求的超时时间
            proxy_send_timeout 60s;       # 从后端读取响应的超时时间

            # 禁用缓存
            proxy_buffering off;
        }

        # 错误页面处理
        error_page 500 502 503 504 /50x.html;
        location = /50x.html {
            root html;
        }
    }
}

BillKu
关注
后端领域 Nginx 配置优化最佳实践
架构师的AI之路，分享AI应用开发架构的学习与实践。
05-03 650
在后端开发中，Nginx 作为一款高性能的 HTTP 服务器、反向代理服务器及电子邮件（IMAP/POP3）代理服务器，被广泛应用于各种 Web 应用场景。然而，默认的 Nginx 配置往往无法充分发挥其性能优势，因此对 Nginx 进行配置优化至关重要。本文的目的在于深入探讨 Nginx 配置优化的最佳实践，涵盖从基础配置调整到高级性能优化的各个方面，帮助开发者提升 Nginx 服务器的性能、稳定性和安全性。
nginx离线安装资源（包括所有依赖和详细教程）
01-05
4. **PCRE库**：Perl Compatible Regular Expressions (PCRE) 库是Nginx配置文件中正则表达式解析所必需的。`pcre-devel-8.32-17.el7.x86_64.rpm`是PCRE的开发包，适用于Red Hat Enterprise Linux 7系列，如果系统...
nginx配置（很值得新手阅读）
benben0729的专栏
08-01 222
译者注：不知道其他开发者是否和我一样，参与或者写了很多Web项目，但是却没有真正的去完整的部署应用，很多时候都是交给ops即运维的同学帮忙来做。而作为一个有节操的开发者，我认为了解一些服务器方面的知识是很有必要的，读了这篇文章之后，自己对nginx也有了一个初步的认识，对自己很有帮助，不敢独享，遂译之。 如果你是一名Web开发人员，那么你很有可能听过nginx(读音听起来像engine-x). ...
Nginx 下载 安装 配置 新手入门教程
2201_75759195的博客
05-05 1681
这篇文章全面讲解了 Nginx 的特点、下载、安装、配置、网站上线及高级应用。涵盖其高性能、低资源占用等特点，适用于 Web 服务器、反向代理等场景。详细介绍了各系统安装方法，包括源码编译。提供配置文件示例及编辑方法，指导网站部署和上线。解答常见问题，介绍反向代理、动静分离和 HTTPS 配置等高级功能。最后附带教程网站源码示例。
vue3 项目部署，Nginx配置https,重定向，详细流程
潜心
11-14 8727
📚服务器专栏☃️ 个人简介：一个喜爱技术的人。🌞 励志格言: 脚踏实地，虚心学习。
Nginx 入门到实战，新手必懂。
java思维导图
03-04 172
一、环境服务器版本：CentOS 7.2，为了保证学习阶段不遇到奇怪的事情，请保证以下四点（大神选择性无视）确认系统网络确认yum可用确认关闭iptables确认停用selinux#查看i...
腾讯云+ssl证书+nginx.conf配置
boys_w的博客
05-27 384
本文介绍了在Nginx服务器上配置SSL证书实现HTTPS访问的完整流程：首先在域名解析平台添加解析记录，然后申请免费SSL证书并下载证书文件；接着修改Nginx配置文件，设置443端口监听并指定证书路径，同时配置HTTP到HTTPS的重定向；最后通过检测配置文件和重启Nginx服务完成部署。文中包含详细的Nginx配置示例，涵盖了SSL证书路径、协议版本、会话缓存等关键参数设置，以及不同服务的反向代理配置。
Nginx 基础知识点详解（安装到配置文件）
L08130421的博客
08-02 1088
Nginx 是一款强大的 Web 服务器软件，由俄罗斯的伊戈尔·赛索耶夫（Igor Sysoev）创立。Nginx 诞生于互联网高速发展的时代，旨在解决高并发情况下的服务器性能问题。它以其高效的性能、低资源消耗和出色的稳定性而备受赞誉。Nginx 不仅可以作为 Web 服务器，还能充当反向代理、负载均衡器等角色，为各类网站和应用提供了可靠的服务支持。它能够快速处理大量请求，有效提升用户体验。在不断的发展和完善中，Nginx 已成为众多互联网企业和开发者的首选工具之一。
【Nginx】(三) Nginx配置文件精解：从入门到精通的完整指南
JCoder的博客
04-24 678
在本文中，我们将深入探讨 Nginx 配置文件的层次结构，从全局的 main 块到具体的 http、events，乃至 server 块和它们内部的 location 块。逐步解析每个模块的作用，以及如何通过精细的配置来优化 Nginx 的性能，增强其安全性，并实现高级的流量管理功能。
Nginx 入门到实战，新手必懂 !
程序IT圈
12-01 276
一、环境服务器版本：CentOS 7.2，为了保证学习阶段不遇到奇怪的事情，请保证以下四点（大神选择性无视）确认系统网络确认yum可用确认关闭iptables确认停用selinux#查看i...
【Nginx配置全攻略】：新手也能轻松掌握的服务器搭建指南
[【Nginx配置全攻略】：新手也能轻松掌握的服务器搭建指南](https://datascientest.com/wp-content/uploads/2023/07/Illu_BLOG__nginx.png) # 摘要 本文详细介绍了Nginx服务器的安装配置、管理、性能优化、与后端...
《从0到1：Nginx新手的通关秘籍》，涵盖高并发处理、反向代理、负载均衡及静态文件服务
08-27
随后，文章分步骤演示了在Linux和Windows系统中安装Nginx的过程，深入解析了配置文件的结构（包括全局块、events块、http块、server块和location块），并指导读者如何配置基本服务器、发布静态网站、设置静态文件...
Nginx从入门到精通：实战配置与性能优化全解析
《史上最牛逼的Nginx最佳实践教程从入门到精通》是一套系统、全面且极具实战价值的Nginx学习资料，涵盖了从基础安装配置到高阶性能优化与安全防护的完整知识体系。该教程不仅适用于初学者快速掌握Nginx的核心功能，...
部署在windows的docker中的dify知识库存储位置
2501_93651177的博客
11-21 516
在Windows系统的Docker中部署Dify时，知识库存储分为两部分：文件数据（包括文档、向量等）存储在宿主机E:\dify-1.1.3\docker\volumes\app\storage\upload_files目录下；元数据（如配置信息）则保存在PostgreSQL数据库中，数据库文件位于宿主机E:\dify-1.1.3\docker\volumes\db\data\pgdata路径。文件数据由系统自动生成，元数据通过数据库管理知识库配置关系。
shell（八）——WEB与Nginx
最新发布
liuxinshuang0512的博客
11-23 531
Web技术概述 Web是基于HTTP/HTTPS协议的超文本信息系统，采用B/S架构实现浏览器与服务器的交互。其核心特点包括分布式资源存储、跨平台访问和无状态通信（通过Cookie/Session维持状态）。 Web请求流程包含：URL输入→DNS解析→TCP连接→HTTP请求→服务器处理（静态资源直接返回/动态资源经应用服务器处理）→响应返回→浏览器渲染。 Web发展经历了三个阶段： Web1.0（只读静态页面） Web2.0（用户生成内容的交互式应用） Web3.0（语义化、去中心化的智能网络） 实验部
mac11.6安装docker
tainqiuer123的博客
11-21 227
新建虚拟机，然后自动选择docker的那个镜像boot2docker.iso就可以在虚拟机中使用docker。安装好之后可能需要重启系统，一些扩展需要重启系统进行生效。经过多次实践，直接安装docker未做到。先安装虚拟机，然后再安装docker工具。
一键进入开发容器：Ubuntu Docker 开发环境脚本
qq_42161913的博客
11-21 281
一键进入开发容器：Ubuntu Docker 开发环境脚本
MCP负载均衡
2509_93939242的博客
11-22 306
举个例子，假如某台服务器突然CPU飙到90%，控制器会立刻降低它的权重，把后续请求引流到空闲节点。比如我们把核心数据库放在私有云，而CDN节点用公有云，MCP就能智能识别请求来源，把国内用户流量导向阿里云，海外用户走AWS。另外，控制器本身容易成单点故障，所以生产环境最好用集群部署，通过Paxos或Raft协议做一致性备份。说到性能优化，MCP的内存管理是个关键点。另外，监控仪表板也得跟上，我们用了Prometheus采集指标，Grafana做可视化，实时显示各节点的QPS和错误率，方便快速定位瓶颈。
Java部署自动化
2509_93941777的博客
11-22 384
说白了，就是把那些繁琐、重复、容易出错的手工操作，统统交给机器和脚本来搞定，让人力解放出来，去干更有创造性、更需要思考的活儿。部署时，直接拉取镜像并运行容器。这样做的好处是，每个版本的包都有唯一的坐标，便于管理、追溯和回滚。目前来看，Jenkins依然是业界最流行、最成熟的选择之一，老牌，插件丰富，社区活跃。代码质量扫描（可选但推荐）：可以集成SonarQube等工具，对代码进行静态扫描，分析潜在的技术债务、漏洞和坏味道。当你的项目从单机走向集群，自动化部署的复杂度会上升，但带来的收益也更明显。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

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

余额充值