Writing

Nginx 反向代理配置实录:把域名指到自己的应用

手把手教你用 Nginx 反向代理把域名指向本地运行的 Node.js/Python 应用,包含完整配置片段、SSL证书申请和常见问题排查。

· 12 分钟阅读
目录
  1. 一张表看懂正向代理 vs 反向代理
  2. 1. 前置准备
  3. 1.1 域名解析
  4. 1.2 放行防火墙
  5. 2. Nginx 核心配置
  6. 2.1 安装 Nginx
  7. 2.2 新建配置文件
  8. 2.3 测试并启用配置
  9. 3. 添加 HTTPS 加密
  10. 3.1 安装 certbot
  11. 3.2 申请证书
  12. 3.3 验证自动续期
  13. 4. 遇到 502 怎么办?
  14. 总结

上周在雨云新开了台轻量云服务器,准备把本地开发的天气查询工具放到公网上。明明应用在本地 http://127.0.0.1:3000 跑得好好的,绑域名时却卡在 Nginx 配置上——浏览器一直显示 502 Bad Gateway。翻遍 Stack Overflow 终于搞明白问题出在反向代理的 proxy_pass 设置上,记录下完整流程。

📌 本文摘要:从购买域名到完成 HTTPS 访问的全流程记录,重点解决 Nginx 反向代理配置中的典型问题。包含:1) 用 certbot 申请 Let’s Encrypt SSL证书;2) 正确配置 location / 和 proxy_set_header 参数;3) 调试时必看的 nginx -t 和 journalctl -xe 命令。实测适用于 Node.js/Python/Java 等本地应用对外暴露的场景。

一张表看懂正向代理 vs 反向代理

对比项 正向代理 反向代理
典型场景 科学上网 对外暴露内网服务
客户端感知 需要主动配置代理 无感知
流量走向 客户端→代理→目标服务器 客户端→代理→内部服务器
常用软件 Shadowsocks、Clash Nginx、Apache

我的需求属于第二列:用户访问 weather.example.com 时,Nginx 把请求转发到本地 3000 端口的 Node 服务。

1. 前置准备

1.1 域名解析

在域名服务商处添加 A 记录(我用的是 Cloudflare):

类型 名称 内容 TTL
A weather SERVER_IP Auto

等 10 分钟用 dig 检查是否生效:

dig weather.example.com +short
# 应该返回你的服务器IP

1.2 放行防火墙

确保 80/443 端口开放(以下以 UFW 为例):

sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw status  # 检查规则

2. Nginx 核心配置

2.1 安装 Nginx

Ubuntu/Debian 系统一条命令搞定:

sudo apt update && sudo apt install nginx -y

2.2 新建配置文件

在 /etc/nginx/sites-available/ 下新建 weather.conf:

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

    location / {
        proxy_pass http://127.0.0.1:3000;  # 关键!末尾不能带斜杠
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}

提示:如果后端应用在 Docker 内运行,要把 127.0.0.1 改成宿主机在 Docker 网桥的 IP(通常 172.17.0.1),否则会出现 502 错误。

2.3 测试并启用配置

先检查语法是否正确:

sudo nginx -t  # 看到 "syntax is ok" 才继续

创建符号链接并重启 Nginx:

sudo ln -s /etc/nginx/sites-available/weather.conf /etc/nginx/sites-enabled/
sudo systemctl restart nginx

3. 添加 HTTPS 加密

3.1 安装 certbot

Let’s Encrypt 官方推荐方式:

sudo apt install certbot python3-certbot-nginx -y

3.2 申请证书

一行命令自动完成验证和配置(记得先暂停 Nginx):

sudo systemctl stop nginx
sudo certbot --nginx -d weather.example.com
sudo systemctl start nginx

3.3 验证自动续期

sudo certbot renew --dry-run

4. 遇到 502 怎么办?

按这个顺序排查:

  1. 检查后端服务是否运行:
    curl -I http://127.0.0.1:3000  # 该返回200
  2. 查看 Nginx 错误日志:
    tail -n 50 /var/log/nginx/error.log
  3. 确认端口一致:
    ss -tulnp | grep 3000  # 看应用是否监听正确端口

我在第三步发现是 PM2 没启动 Node 服务,pm2 start app.js 后问题解决。

总结

反向代理的核心是 proxy_pass 指向正确地址,502 错误八成是这里配错了。域名+HTTPS+Nginx 的组合看着复杂,实操下来 30 分钟就能跑通。推荐用雨云的香港节点做测试,输入优惠码 aabh 能省点钱,重点是网络延迟低,调试的时候不用等太久。

相关文章