Nginx 反向代理配置域名总报错？这 4 个高频坑，我帮你一次填平

引言：域名解析没问题，Nginx 却总在“闹脾气”

💡 推荐阅读：服务器CPU飙到100%？手把手揪出挖矿木马进程并彻底清理的实战全记录

最近不少朋友在站长群里吐槽，说自己在配置 Nginx 反向代理的时候，明明照着网上的教程一步步来的，可域名就是死活打不开，要么直接 502，要么跳转到服务器 IP 上，要么提示 “This site can’t be reached”。

说实话，笔者早年刚接触 Nginx 时也在这上面栽过不少跟头。今天咱们不聊那些虚头巴脑的理论，直接结合笔者踩过的坑和群里高频出现的问题，把 Nginx 反向代理配置域名 这件事拆开揉碎了讲清楚。文章不会太长，但保证每一句都是实操经验，看完你也能成为“排坑小能手”。

高频报错一：配置完域名访问，直接跳转到了服务器 IP 地址？

💡 延伸阅读：云服务器带宽选1M还是3M？实测数据告诉你，别再为“够用”交智商税了

问题现场还原

很多朋友在配置完 proxy_pass 之后，发现浏览器地址栏输入的明明是自己的域名，结果回车一敲，URL 变成了 http://服务器IP:端口。这其实是 proxy_redirect 参数在作怪。

根因深度剖析

当后端服务器（比如 Tomcat 或者 Node.js）返回的响应头里带有 Location 字段时，如果该字段写的是 IP 或者 localhost，Nginx 默认会将其透传给客户端。这时候如果不做处理，浏览器就会傻乎乎地跟着这个 IP 地址去跳转。

解决方案代码

server {
    listen 80;
    server_name www.example.com example.com;

    location / {
        proxy_pass http://127.0.0.1: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;

        # 关键点：将后端返回的 Location 头中的 IP 替换为域名
        proxy_redirect http://127.0.0.1:8080 http://www.example.com;
        proxy_redirect http://192.168.1.10:8080 http://www.example.com;
    }
}

预防建议： 配置时一定要写清楚 proxy_redirect，或者直接使用 proxy_redirect default; 配合 server_name 来自动适配，能省去很多麻烦。

高频报错二：总是 502 Bad Gateway，后端服务明明在运行？

💡 深度技术指南：SSH 总是被爆破？手把手教你用 Fail2ban 自动封禁暴力破解的黑客 IP，从此日志清净了

问题现场还原

这是最常见的问题。很多朋友用 ps -ef | grep java 或者 netstat -tlnp 查看端口，发现服务确实在监听，但通过 Nginx 访问就是 502。

根因深度剖析

502 的本质是 Nginx 作为代理服务器，无法从上游服务器（后端应用）获取有效响应。除了后端服务真的挂了之外，最常见的原因有两个：IP 地址写错（比如写成了 127.0.0.1 但服务监听的是内网 IP），以及 SELinux 拦截（CentOS 系统高发）。

解决方案代码

首先，检查你的 proxy_pass 地址是否准确。如果你的后端服务监听的是 0.0.0.0:8080，那么写 http://127.0.0.1:8080 是没问题的。但如果你监听的是 172.16.1.5:8080，那么 Nginx 配置里就必须写那个具体 IP。

其次，如果是 CentOS 系统，执行以下命令临时关闭 SELinux 测试：

# 临时关闭（重启失效）
setenforce 0

# 永久关闭（需重启）
sed -i 's/SELINUX=enforcing/SELINUX=disabled/g' /etc/selinux/config

如果关闭后 502 消失，那就是 SELinux 的 httpd_can_network_connect 权限未开启。用以下命令永久解决：

setsebool -P httpd_can_network_connect 1

预防建议： 遇到 502 不要慌，先 curl -v http://127.0.0.1:8080 看看后端是否真的能通。能通则查 SELinux 和防火墙，不能通则查服务进程。

高频报错三：域名能访问，但静态资源全部丢失，页面惨不忍睹？

问题现场还原

很多朋友在配置反向代理时，只代理了根路径 /，结果发现 HTML 页面加载出来了，但里面的 CSS、JS、图片全部 404 或者 403。

根因深度剖析

这是因为你的后端应用（比如 WordPress 或 Discuz）使用了绝对路径引用静态资源，而 Nginx 在代理时没有正确处理 location 匹配规则，导致静态资源请求被转发到了后端动态服务上，而后端又无法处理静态文件请求。

解决方案代码

最好的方式是动静分离。将静态资源请求直接交给 Nginx 本地处理，动态请求才走反向代理：

server {
    listen 80;
    server_name www.example.com;

    # 静态资源直接本地处理
    location ~* \.(jpg|jpeg|png|gif|ico|css|js|woff|svg)$ {
        root /var/www/html;  # 静态资源存放路径
        expires 30d;
        access_log off;
    }

    # 动态请求反向代理
    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
    }
}

预防建议： 如果后端是 Java 或 Node 应用，建议将打包后的静态资源目录映射到 Nginx 中，并配置 alias 或 root 指向，避免资源请求穿透到应用层。

高频报错四：配置了 HTTPS 证书，但页面提示不安全或证书错误？

问题现场还原

部分朋友在配置完 SSL 证书后，发现访问域名时浏览器依然提示“不安全”，或者提示证书与域名不匹配。

根因深度剖析

这种情况绝大多数是因为证书文件路径配置错误或者证书链不完整。很多朋友只上传了域名证书（.crt），却没有上传中间证书（CA Bundle），导致浏览器无法验证证书链。

解决方案代码

server {
    listen 443 ssl;
    server_name www.example.com;

    # 证书路径
    ssl_certificate     /etc/nginx/ssl/example.com.pem;   # 包含域名证书+中间证书
    ssl_certificate_key /etc/nginx/ssl/example.com.key;

    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ciphers HIGH:!aNULL:!MD5;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-Proto $scheme;  # 让后端知道是 HTTPS 请求
    }
}

预防建议： 在申请证书时，一定要下载对应服务器的完整证书链（通常包含 root 和 intermediate）。如果你使用的是 Let’s Encrypt 证书，fullchain.pem 文件里就已经包含了中间证书，直接引用即可。

进阶建议：如何让反向代理配置更健壮？

除了上述排坑，笔者还想给大家提三个进阶建议，能让你的配置更专业：

• 合理配置超时时间： 在 location 中加入 proxy_connect_timeout 5s; 和 proxy_read_timeout 30s;，避免后端响应慢时 Nginx 长时间挂起连接。
• 开启 Gzip 压缩： 在 http 块中加入 gzip on; 和 gzip_types text/plain text/css application/json application/javascript text/xml application/xml application/xml+rss text/javascript;，能显著提升页面加载速度。
• 日志分析很重要： 配置好 access_log 和 error_log 路径，排查问题时看日志比猜原因高效一百倍。

写在最后

Nginx 反向代理配置域名并不复杂，核心在于理解 proxy_pass、proxy_set_header 和 server_name 的配合逻辑。上述四个高频报错基本涵盖了 80% 以上的新手问题，如果你按照笔者的方法逐一排查，相信很快就能跑通。

另外，笔者真心建议，如果你准备长期运营网站或业务系统，一定要选择靠谱的云服务商，带宽和稳定性直接决定了你排错时的体验。同时，域名也要在正规注册商处购买并完成备案，否则后续配置 HTTPS 或者 CDN 都会受限。希望这篇文章能帮你少走弯路，一次配置成功。

相关技术专题与延伸阅读

• 服务器CPU飙到100%？手把手揪出挖矿木马进程并彻底清理的实战全记录
• 云服务器带宽选1M还是3M？实测数据告诉你，别再为“够用”交智商税了
• SSH 总是被爆破？手把手教你用 Fail2ban 自动封禁暴力破解的黑客 IP，从此日志清净了
• WordPress 评论风暴与Pingback漏洞，我用这5招彻底根治，亲测有效！