Writing
Nginx 反向代理配置实录:把域名指到自己的应用
手把手教你用 Nginx 反向代理把域名指向本地运行的 Node.js/Python 应用,包含完整配置片段、SSL证书申请和常见问题排查。
目录
上周在雨云新开了台轻量云服务器,准备把本地开发的天气查询工具放到公网上。明明应用在本地 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 怎么办?
按这个顺序排查:
- 检查后端服务是否运行:
curl -I http://127.0.0.1:3000 # 该返回200 - 查看 Nginx 错误日志:
tail -n 50 /var/log/nginx/error.log - 确认端口一致:
ss -tulnp | grep 3000 # 看应用是否监听正确端口
我在第三步发现是 PM2 没启动 Node 服务,pm2 start app.js 后问题解决。
总结
反向代理的核心是 proxy_pass 指向正确地址,502 错误八成是这里配错了。域名+HTTPS+Nginx 的组合看着复杂,实操下来 30 分钟就能跑通。推荐用雨云的香港节点做测试,输入优惠码 aabh 能省点钱,重点是网络延迟低,调试的时候不用等太久。