别再只会用宝塔点点了：手把手教你用 Nginx 实现反向代理，从入门到上线其实就这么简单

很多朋友在搭建自己的网站或者服务时，总会遇到一个绕不开的坎：端口号。明明买了个服务器，跑了个应用，结果访问的时候还得在域名后面加个 :8080，不仅难看，而且显得特别不专业。更麻烦的是，如果一台服务器上跑了好几个不同的服务，比如一个博客、一个API接口、一个文件管理面板，端口管理简直是一场灾难。

这时候，Nginx 反向代理就成了解决这类问题的“万能钥匙”。今天，我们不聊那些晦涩难懂的底层原理，就从一个实际场景出发，手把手带你把反向代理玩明白。看完这篇文章，你不仅能解决端口问题，还能顺手把性能和安全提升一个档次。

一、为什么你需要 Nginx 反向代理？

💡 推荐阅读：Docker 开源仓库到底怎么用？从镜像拉取到自建私有仓库的完整实操笔记

简单来说，反向代理就是你服务器前台的“总接待员”。用户访问你的域名（默认80端口），这个接待员（Nginx）会根据你设定的规则，把请求转交给后台真正干活的“员工”（比如运行在 8080 端口的 Java 应用，或者 3000 端口的 Node.js 服务）。

这样做的好处是显而易见的：

• 隐藏真实端口： 用户永远只看到 80 或 443 端口，服务器内部结构不暴露。
• 负载均衡： 如果后台有多台服务器，Nginx 可以自动分配流量，避免单点压力过大。
• 统一入口： 所有的静态资源（图片、CSS、JS）可以直接交给 Nginx 处理，动态请求才转发给后端，效率极高。
• 安全性提升： 可以在代理层统一配置 SSL 证书（HTTPS）、拦截恶意 IP、设置访问限制。

二、动手前的准备工作

💡 延伸阅读：还在被502折磨？Nginx反向代理配置，看这一篇就够了

在开始敲命令之前，我们需要确保环境是干净的。这里以目前市场占有率最高的 CentOS 7/8 或 Ubuntu 20.04/22.04 系统为例（其实命令都差不多）。

第一步：安装 Nginx

# CentOS / RedHat 系列
sudo yum install -y nginx

# Ubuntu / Debian 系列
sudo apt update
sudo apt install -y nginx

安装完成后，先启动一下试试水：

sudo systemctl start nginx
sudo systemctl enable nginx  # 设置开机自启

这时候，你在浏览器里输入服务器的公网 IP，如果能看到 “Welcome to nginx!” 的页面，说明基础环境已经 OK 了。

三、核心实操：配置你的第一个反向代理

💡 深度技术指南：网站打开像蜗牛？别急着换主机，先花十分钟排查这几个拖慢WordPress的元凶

假设我们现在有一个跑在 http://127.0.0.1:8080 的 Java 应用（或者 Python、Node 应用），我们希望通过访问 http://yourdomain.com 就能直接打开它，而不需要加端口号。

第一步：创建配置文件

Nginx 的配置通常放在 /etc/nginx/conf.d/ 目录下（有些系统是 /etc/nginx/sites-available/）。我们创建一个专门针对该域名的配置文件：

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

第二步：写入核心配置

把下面的内容粘贴进去（注意替换成你自己的域名和端口）：

server {
    listen 80;
    server_name yourdomain.com www.yourdomain.com;  # 你的域名

    # 日志文件位置
    access_log /var/log/nginx/myapp_access.log;
    error_log /var/log/nginx/myapp_error.log;

    # 核心反向代理配置
    location / {
        proxy_pass http://127.0.0.1:8080;  # 转发到本机8080端口
        proxy_set_header Host $host;          # 保留原始 Host 头
        proxy_set_header X-Real-IP $remote_addr;   # 传递客户端真实 IP
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;

        # 以下配置针对 WebSocket 等长连接，如果你用不到可以注释掉
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

这段配置的核心就是 location / 块里的 proxy_pass 指令。它告诉 Nginx：“凡是访问我域名根目录的请求，都转交给 127.0.0.1:8080 去处理。”

第三步：检查语法并重载

# 检查配置文件是否有语法错误
sudo nginx -t

# 如果显示 syntax is ok，则平滑重载配置
sudo nginx -s reload

现在，直接在浏览器访问 http://yourdomain.com，看看是不是已经能打开你的应用了？是不是非常神奇？

四、进阶玩法：如何根据路径转发到不同的服务？

有时候，我们一台服务器上不仅有一个博客，还有一个 API 接口服务。这时候，我们可以利用 Nginx 的路径匹配，实现“一个域名，多个服务”。

比如，/api/ 开头的请求转发给后端的 3000 端口，其他的请求转发给 8080 端口：

server {
    listen 80;
    server_name yourdomain.com;

    # API 请求转发到 Node.js 服务
    location /api/ {
        proxy_pass http://127.0.0.1:3000;
        proxy_set_header Host $host;
    }

    # 其他所有请求转发到 Java 服务
    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
    }
}

这样，你的前端页面和后端 API 就彻底分离了，维护起来也清晰得多。

五、必须掌握的进阶配置：HTTPS 与静态资源分离

如果你觉得上面这些还不够“专业”，那么下面这两点你绝对用得上。

1. 强制 HTTPS

现在谷歌和百度都对 HTTPS 站点有排名加成，而且不加密的 HTTP 协议很容易被运营商劫持。我们强烈建议你配置 SSL 证书。如果你用的是 Let’s Encrypt 免费证书，可以借助 certbot 工具一键搞定：

sudo yum install -y certbot python3-certbot-nginx  # 或 apt install
sudo certbot --nginx -d yourdomain.com -d www.yourdomain.com

Certbot 会自动帮你修改 Nginx 配置，添加 443 端口监听和证书路径，并强制 HTTP 跳转到 HTTPS。整个过程不需要你手动改一行配置，非常省心。

2. 动静分离，榨干服务器性能

如果你的网站有很多图片、CSS、JS 等静态文件，让 Nginx 直接处理是效率最高的。我们可以把静态文件请求直接指向服务器上的某个目录，而不是转发给后端程序：

location ~* \.(jpg|jpeg|png|gif|ico|css|js)$ {
    root /var/www/html;  # 静态文件存放目录
    expires 30d;         # 开启浏览器缓存30天
    access_log off;      # 静态文件不记录日志，减少IO开销
}

这样配置后，图片和样式文件都由 Nginx 直接返回，后端应用的压力瞬间降低一大截。

六、常见故障排查指南（避坑手册）

配置过程中难免会遇到问题，这里给大家列几个最常见的“坑”：

报错现象	可能原因	解决思路
502 Bad Gateway	后端服务没启动，或者端口写错	检查后端应用是否正常运行，用 curl 127.0.0.1:端口 测试
404 Not Found	代理路径不对，或者静态文件路径不对	检查 location 匹配规则，以及 proxy_pass 后面是否带了路径
页面一直跳转登录页	缺少 proxy_set_header Host $host 配置	确保在配置中添加了 Host 头的传递
WebSocket 连接失败	缺少 Upgrade 头配置	加上 proxy_http_version 1.1 和 Upgrade 相关配置

另外，如果改了配置不生效，记得先 nginx -t 检查语法，再 nginx -s reload 重载。千万别直接重启，否则可能会导致短暂的服务中断。

七、写在最后：选对“土壤”很重要

Nginx 反向代理的配置其实并不复杂，核心就是把 proxy_pass 用熟。但真正决定你网站访问速度的，除了配置，还有你服务器的硬件和网络质量。如果你在配置过程中发现无论怎么优化，访问速度就是提不上去，那可能就要考虑是不是服务器带宽或线路的问题了。

笔者自己用的几台业务服务器是在站长购买的，主要是看中它的 BGP 线路稳定性不错，晚高峰访问也不会掉链子，而且控制台自带免费的防火墙策略，对于咱们这种需要频繁调试端口的人来说，操作起来特别顺手。如果你刚好有购买新服务器的需求，不妨去看看，选择适合自己业务体量的配置即可，没必要盲目追求高配。

希望这篇文章能帮你彻底搞定 Nginx 反向代理。如果你在实操中遇到了什么奇怪的问题，欢迎在评论区留言，我们下期接着聊。

相关技术专题与延伸阅读

• Docker 开源仓库到底怎么用？从镜像拉取到自建私有仓库的完整实操笔记
• 还在被502折磨？Nginx反向代理配置，看这一篇就够了
• 网站打开像蜗牛？别急着换主机，先花十分钟排查这几个拖慢WordPress的元凶
• 别被“免费”忽悠了！一文看懂 Docker 开源生态，从零部署你的第一个容器