侧边栏壁纸
博主头像
GrantLi

你我山前没相见 山后别相逢

  • 累计撰写 53 篇文章
  • 累计创建 26 个标签
  • 累计收到 3 条评论

目 录CONTENT

文章目录

Nginx 反向代理完整配置教程

GrantLi
2026-11-17 / 0 评论 / 0 点赞 / 4 阅读 / 0 字 / 正在检测是否收录...

## 一、前言

在实际的网站部署和服务器运维过程中,我们经常会遇到这样的需求:

- 希望通过一个独立的域名访问自己的 Web 服务。

- 希望一台云服务器同时部署多个网站或业务系统。

- 希望不同的二级域名访问不同的后端服务。

- 希望通过 HTTPS 实现安全访问,而不是直接暴露服务器 IP 和端口。

例如,我们有一台云服务器,公网 IP 为 1.2.3.4,同时运行着多个服务:

| 服务名称 | 服务端口 | 期望访问域名 |

|---|---|---|

| 机器狗管理平台 | 8080 | robot.example.com |

| 后端 API 服务 | 8000 | api.example.com |

| 管理后台 | 3000 | admin.example.com |

| 监控系统 | 9090 | monitor.example.com |

我们希望最终实现:

- 访问 robot.example.com,进入机器狗管理平台。

- 访问 api.example.com,进入后端 API 服务。

- 访问 admin.example.com,进入管理后台。

- 访问 monitor.example.com,进入监控系统。

所有域名都指向同一台云服务器,通过 Nginx 根据不同的域名,将请求转发到对应的后端服务。

本文将以 Ubuntu 云服务器、Nginx 和 DNS A 记录为例,介绍从域名解析到服务部署的完整过程。

---

## 二、整体实现原理

二级域名映射到云服务器,主要涉及两个核心环节:

1. DNS 域名解析。

2. Nginx 反向代理。

### 2.1 DNS 域名解析

DNS(Domain Name System)负责将域名转换为 IP 地址。

例如:

```text

robot.example.com -> 1.2.3.4

```

当用户访问 robot.example.com 时,DNS 系统会返回云服务器的公网 IP 地址。

这样,浏览器就可以通过公网 IP 找到对应的云服务器。

### 2.2 Nginx 反向代理

DNS 解析只能解决域名指向服务器的问题,并不能决定用户应该访问服务器上的哪个应用程序。

例如:

```text

robot.example.com -> 1.2.3.4

api.example.com -> 1.2.3.4

admin.example.com -> 1.2.3.4

```

三个域名都指向同一台服务器。

这时就需要使用 Nginx,根据 HTTP 请求中的 Host 域名信息,将请求转发到不同的后端服务。

### 2.3 整体架构

整体访问流程如下:

```text

用户浏览器

|

+-----------+-----------+

| | |

v v v

robot.example api.example admin.example

| | |

+-----------+-----------+

|

v

DNS 域名解析

|

v

云服务器公网 IP

1.2.3.4

|

v

Nginx 服务

80 / 443

|

+-----------+-----------+

| | |

v v v

8080端口 8000端口 3000端口

| | |

v v v

机器狗平台 API服务 管理后台

```

整个过程中:

- DNS 负责域名到 IP 的映射。

- 云服务器负责接收公网请求。

- Nginx 负责根据域名分发请求。

- 后端应用负责实际业务处理。

理解这个原理之后,后面的配置就比较简单了。

---

## 三、第一步:配置二级域名 DNS 解析

首先,需要在域名管理平台配置 DNS 解析记录。

常见的域名服务商包括:

- 阿里云

- 腾讯云

- Cloudflare

- 华为云

不同平台的操作界面可能有所不同,但配置原理基本一致。

### 3.1 确认域名和服务器信息

假设当前环境如下:

| 配置项 | 示例值 |

|---|---|

| 主域名 | example.com |

| 二级域名 | robot.example.com |

| 云服务器公网 IP | 1.2.3.4 |

| DNS 记录类型 | A 记录 |

这里的 example.com 和 1.2.3.4 均为示例,实际部署时需要替换为自己的域名和公网 IP。

### 3.2 新增 DNS 解析记录

进入域名管理平台,找到 DNS 解析管理页面。

新增一条解析记录:

| 配置项 | 填写内容 |

|---|---|

| 记录类型 | A |

| 主机记录 | robot |

| 记录值 | 1.2.3.4 |

| TTL | 600 秒或默认值 |

其中:

- A 记录表示将域名解析到 IPv4 地址。

- 主机记录填写 robot,最终完整域名就是 robot.example.com。

- 记录值填写云服务器的公网 IP。

- TTL 表示 DNS 记录的缓存时间。

保存配置即可。

### 3.3 验证 DNS 解析是否成功

配置完成后,可以在本地电脑或服务器上执行以下命令:

```bash

nslookup robot.example.com

```

正常情况下会返回类似结果:

```text

Server: dns.example

Address: 8.8.8.8

Name: robot.example.com

Address: 1.2.3.4

```

也可以使用:

```bash

dig robot.example.com

```

查看解析结果。

如果返回的 IP 地址与云服务器公网 IP 一致,说明 DNS 解析基本正常。

注意:

DNS 解析生效时间取决于 DNS 缓存和服务商配置,修改后不一定立即在所有网络环境中生效。

---

## 四、第二步:在云服务器上安装 Nginx

DNS 解析完成后,接下来需要配置云服务器。

本文以 Ubuntu 系统为例。

### 4.1 更新软件包

执行:

```bash

sudo apt update

```

### 4.2 安装 Nginx

执行:

```bash

sudo apt install nginx -y

```

安装完成后,启动 Nginx:

```bash

sudo systemctl start nginx

```

设置开机自动启动:

```bash

sudo systemctl enable nginx

```

查看 Nginx 运行状态:

```bash

sudo systemctl status nginx

```

如果显示:

```text

Active: active (running)

```

说明 Nginx 已经正常运行。

### 4.3 验证 Nginx

在浏览器中输入:

```text

http://1.2.3.4

```

如果出现 Nginx 默认欢迎页面,说明 Nginx 已经能够正常接收 HTTP 请求。

如果无法访问,需要检查:

1. Nginx 是否正常运行。

2. 云服务器安全组是否开放 80 端口。

3. 服务器系统防火墙是否允许 HTTP 请求。

4. 云服务器公网 IP 是否正确。

---

## 五、第三步:配置 Nginx 反向代理

假设我们的后端 Web 服务已经运行在:

```text

127.0.0.1:8080

```

现在需要将:

```text

robot.example.com

```

映射到:

```text

127.0.0.1:8080

```

### 5.1 创建 Nginx 配置文件

执行:

```bash

sudo nano /etc/nginx/conf.d/robot.conf

```

添加以下配置:

```nginx

server {

listen 80;

server_name robot.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;

proxy_set_header X-Forwarded-Proto $scheme;

}

}

```

### 5.2 配置说明

listen 80

```nginx

listen 80;

```

表示监听 HTTP 的 80 端口。

server_name

```nginx

server_name robot.example.com;

```

表示当前 Nginx 配置负责处理访问 robot.example.com 的请求。

location /

```nginx

location / {

...

}

```

表示匹配当前网站的请求路径。

proxy_pass

```nginx

proxy_pass http://127.0.0.1:8080;

```

表示将用户请求转发到本机的 8080 端口。

proxy_set_header

```nginx

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;

```

这些配置用于向后端传递原始请求信息:

- Host:原始访问域名。

- X-Real-IP:客户端 IP。

- X-Forwarded-For:经过代理的客户端 IP 链。

- X-Forwarded-Proto:原始请求使用的协议。

这样,后端应用就可以获取真实的访问域名和客户端请求信息。

### 5.3 检查 Nginx 配置

执行:

```bash

sudo nginx -t

```

如果返回:

```text

nginx: configuration file /etc/nginx/nginx.conf test is successful

```

说明配置文件语法正确。

### 5.4 重新加载 Nginx

执行:

```bash

sudo systemctl reload nginx

```

如果修改配置后无法正常加载,可以查看日志:

```bash

sudo journalctl -u nginx -n 50

```

或者:

```bash

sudo tail -n 50 /var/log/nginx/error.log

```

注意:

本文使用 /etc/nginx/conf.d/robot.conf 作为配置文件路径,前提是当前 Nginx 主配置已经包含该目录。

部分 Ubuntu 安装方式也可以使用:

```text

/etc/nginx/sites-available/

/etc/nginx/sites-enabled/

```

两种方式选择一种即可,避免重复加载相同的站点配置。

---

## 六、第四步:开放云服务器安全组端口

Nginx 配置完成后,还需要检查云服务器的安全组。

进入云服务器控制台,找到对应实例的安全组配置,增加以下入站规则:

| 端口 | 协议 | 用途 | 建议 |

|---|---|---|---|

| 22 | TCP | SSH 远程连接 | 仅允许可信 IP |

| 80 | TCP | HTTP 网站访问 | 开放 |

| 443 | TCP | HTTPS 网站访问 | 开放 |

| 8080 | TCP | 后端 Web 服务 | 不建议公网开放 |

这里需要特别注意:

8080 端口是后端服务端口,不需要直接开放给公网用户。

因为用户访问的是:

```text

http://robot.example.com

```

实际访问流程为:

```text

用户浏览器

|

v

云服务器 80 端口

|

v

Nginx

|

v

127.0.0.1:8080

```

因此,8080 端口只需要在服务器内部能够正常访问即可。

如果使用 UFW 防火墙,还需要执行:

```bash

sudo ufw allow 80/tcp

sudo ufw allow 443/tcp

```

查看防火墙状态:

```bash

sudo ufw status

```

如果没有启用 UFW,则以云服务器安全组和其他实际防火墙配置为准。

---

## 七、第五步:验证二级域名访问

完成 DNS、Nginx 和安全组配置后,就可以进行访问验证。

### 7.1 检查后端服务

首先确认后端服务正常运行:

```bash

curl http://127.0.0.1:8080

```

如果后端服务能够返回正常的 HTTP 响应,说明应用本身运行正常。

### 7.2 检查域名解析

执行:

```bash

nslookup robot.example.com

```

确认解析结果为:

```text

1.2.3.4

```

### 7.3 检查 Nginx 反向代理

执行:

```bash

curl -I http://robot.example.com

```

如果返回:

```text

HTTP/1.1 200 OK

Server: nginx

```

说明 HTTP 请求已经能够到达服务器,并且 Nginx 返回了正常响应。

需要注意,具体 HTTP 状态码取决于后端服务,200 是一种常见的成功响应,301、302 等也可能是正常的业务跳转。

### 7.4 浏览器访问

打开浏览器,输入:

```text

http://robot.example.com

```

如果能够正常访问后端 Web 页面,说明二级域名映射已经完成。

至此,DNS 解析和 Nginx 反向代理配置全部完成。

---

## 八、第六步:配置 HTTPS,实现安全访问

实际部署中,建议使用 HTTPS,而不是长期使用 HTTP。

HTTPS 可以对浏览器与服务器之间的通信进行加密,避免敏感信息以明文方式传输。

这里使用免费的 Let's Encrypt SSL 证书。

### 8.1 安装 Certbot

Ubuntu 系统执行:

```bash

sudo apt install certbot python3-certbot-nginx -y

```

### 8.2 申请 SSL 证书

执行:

```bash

sudo certbot --nginx -d robot.example.com

```

Certbot 会自动:

1. 验证域名所有权。

2. 申请 SSL 证书。

3. 配置 Nginx HTTPS。

4. 根据选择配置 HTTP 到 HTTPS 的跳转。

执行过程中,根据提示填写邮箱并选择相关选项。

申请成功后,就可以通过:

```text

https://robot.example.com

```

访问网站。

注意:

申请证书之前,需要确保:

- DNS 已经正确解析到服务器。

- 服务器的 80 端口可以从公网访问。

- Nginx 站点配置已经正常生效。

- 域名没有指向其他错误的服务器。

如果使用 Cloudflare 等 CDN 或代理服务,还需要确保域名验证方式与代理配置兼容。

### 8.3 检查证书自动续期

Let's Encrypt 证书具有有效期,需要定期续期。

可以使用以下命令测试自动续期:

```bash

sudo certbot renew --dry-run

```

如果测试成功,说明续期流程基本正常。

---

## 九、一台云服务器配置多个二级域名

前面的示例只配置了一个二级域名。

如果需要在同一台服务器上运行多个 Web 服务,可以继续增加 DNS 记录和 Nginx 配置。

### 9.1 配置多个 DNS 解析记录

假设服务器公网 IP 仍然是:

```text

1.2.3.4

```

在 DNS 管理平台分别添加:

| 记录类型 | 主机记录 | 记录值 | 完整域名 |

|---|---|---|---|

| A | robot | 1.2.3.4 | robot.example.com |

| A | api | 1.2.3.4 | api.example.com |

| A | admin | 1.2.3.4 | admin.example.com |

| A | monitor | 1.2.3.4 | monitor.example.com |

这样,所有二级域名都会解析到同一台云服务器。

### 9.2 配置多个 Nginx 站点

可以在一个配置文件中配置多个 server,也可以为每个域名单独创建配置文件。

这里采用独立配置文件的方式。

配置一:robot.conf

```nginx

server {

listen 80;

server_name robot.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;

proxy_set_header X-Forwarded-Proto $scheme;

}

}

```

配置二:api.conf

```nginx

server {

listen 80;

server_name api.example.com;

location / {

proxy_pass http://127.0.0.1:8000;

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;

}

}

```

配置三:admin.conf

```nginx

server {

listen 80;

server_name admin.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;

proxy_set_header X-Forwarded-Proto $scheme;

}

}

```

配置四:monitor.conf

```nginx

server {

listen 80;

server_name monitor.example.com;

location / {

proxy_pass http://127.0.0.1:9090;

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;

}

}

```

### 9.3 检查并重新加载配置

执行:

```bash

sudo nginx -t

```

确认配置无误后:

```bash

sudo systemctl reload nginx

```

这样,一台云服务器就可以同时支持多个二级域名,每个域名对应不同的业务服务。

### 9.4 为多个域名配置 HTTPS

如果需要所有站点都支持 HTTPS,可以分别申请证书。

例如:

```bash

sudo certbot --nginx \

-d robot.example.com \

-d api.example.com \

-d admin.example.com \

-d monitor.example.com

```

Certbot 会根据当前 Nginx 配置尝试为这些域名申请和配置证书。

如果其中某个域名验证失败,可以单独排查该域名的 DNS 和公网访问情况。

---

## 十、常见问题及排查方法

实际部署过程中,可能会遇到一些问题。

下面整理几个比较常见的情况。

### 10.1 域名无法访问

可能原因:

1. DNS 解析记录填写错误。

2. DNS 尚未生效。

3. 云服务器公网 IP 填写错误。

4. 云服务器安全组没有开放 80 端口。

5. Nginx 没有正常启动。

排查命令:

```bash

nslookup robot.example.com

sudo systemctl status nginx

sudo nginx -t

sudo ufw status

```

### 10.2 域名可以解析,但是无法访问网站

这种情况通常说明 DNS 已经正常,但 HTTP 请求没有成功到达应用。

建议按照以下顺序排查:

第一步:检查 Nginx 是否正常运行。

```bash

sudo systemctl status nginx

```

第二步:检查后端服务是否正常。

```bash

curl http://127.0.0.1:8080

```

第三步:检查 Nginx 配置。

```bash

sudo nginx -t

```

第四步:查看 Nginx 错误日志。

```bash

sudo tail -f /var/log/nginx/error.log

```

### 10.3 访问域名出现 502 Bad Gateway

502 通常表示 Nginx 无法从后端服务获取正常响应。

常见原因:

- 后端程序没有启动。

- 后端服务端口配置错误。

- proxy_pass 地址错误。

- 后端服务没有监听预期地址。

- Nginx 无法连接后端服务。

排查方法:

```bash

curl http://127.0.0.1:8080

```

如果无法正常返回,需要先检查后端服务。

还可以检查端口监听情况:

```bash

sudo ss -lntp

```

确认 8080 端口是否正在监听。

### 10.4 访问域名出现 404

可能原因:

1. Nginx 的 server_name 配置错误。

2. 请求没有匹配到预期的 server 配置。

3. 后端应用本身返回 404。

4. location 或 proxy_pass 路径配置不正确。

建议检查:

```bash

sudo nginx -T

```

查看当前 Nginx 实际加载的全部配置。

也可以直接测试指定域名对应的虚拟主机:

```bash

curl -I \

-H "Host: robot.example.com" \

http://127.0.0.1

```

### 10.5 HTTPS 证书申请失败

可能原因:

- DNS 没有正确解析。

- 80 端口没有开放。

- Nginx 配置错误。

- 域名无法从公网访问。

- CDN 或代理配置影响了证书验证。

建议先确认:

```bash

nslookup robot.example.com

curl -I http://robot.example.com

sudo nginx -t

```

确认 HTTP 访问正常后,再重新申请证书。

### 10.6 多个二级域名访问到了同一个网站

这种情况通常与 Nginx 虚拟主机配置有关。

重点检查:

```nginx

server_name robot.example.com;

```

是否正确填写。

另外,还要检查是否存在重复的 server_name 配置,以及默认站点是否影响了请求匹配。

可以执行:

```bash

sudo nginx -T

```

查看全部生效配置。

---

## 十一、完整部署检查清单

为了方便实际部署,可以按照下面的顺序逐项检查。

### DNS 配置

- [ ] 已经拥有可用的主域名。

- [ ] 已经添加对应的二级域名 A 记录。

- [ ] A 记录指向云服务器公网 IP。

- [ ] 使用 nslookup 或 dig 验证解析结果。

### 云服务器配置

- [ ] 云服务器能够正常运行。

- [ ] 已经安装 Nginx。

- [ ] Nginx 已经启动。

- [ ] 云服务器安全组已经开放 80 端口。

- [ ] 云服务器安全组已经开放 443 端口。

- [ ] 系统防火墙规则正常。

### Nginx 配置

- [ ] 已经创建对应的站点配置文件。

- [ ] server_name 已正确填写。

- [ ] proxy_pass 已指向正确的后端端口。

- [ ] proxy_set_header 已正确配置。

- [ ] nginx -t 检查通过。

- [ ] Nginx 已重新加载配置。

### 后端服务

- [ ] 后端程序正常运行。

- [ ] 后端监听端口正确。

- [ ] 本机 curl 测试通过。

- [ ] Nginx 能够正常转发请求。

### HTTPS 配置

- [ ] 已经申请 SSL 证书。

- [ ] 浏览器可以通过 HTTPS 访问。

- [ ] 证书有效期正常。

- [ ] 已经测试证书自动续期。

---

## 十二、总结

通过以上步骤,我们完成了从二级域名 DNS 解析到云服务器 Nginx 反向代理的完整配置。

整个过程可以归纳为:

```text

第一步:配置 DNS

|

v

二级域名解析到云服务器公网 IP

|

v

第二步:安装 Nginx

|

v

启动 Nginx 服务

|

v

第三步:配置反向代理

|

v

将域名请求转发到对应后端端口

|

v

第四步:开放安全组端口

|

v

允许公网访问 80 和 443

|

v

第五步:验证域名访问

|

v

确认 DNS、Nginx 和后端服务正常

|

v

第六步:配置 HTTPS

|

v

完成安全访问部署

```

需要记住三个核心概念:

1. DNS 解决域名指向问题。

通过 A 记录,将二级域名解析到云服务器公网 IP。

2. Nginx 解决请求转发问题。

通过 server_name 匹配不同域名,再通过 proxy_pass 将请求转发到不同的后端服务。

3. HTTPS 解决通信安全问题。

通过 SSL/TLS 证书,实现浏览器与服务器之间的加密通信。

最终,我们不需要为每一个业务系统购买一台独立的云服务器,只需要一台云服务器、一套 Nginx 配置和多个 DNS 解析记录,就可以实现多个二级域名对应多个业务系统的部署方案。

这种方式具有部署简单、资源利用率高、维护方便等优点,非常适合个人网站、企业管理后台、API 服务、物联网平台和设备监控系统等应用场景。

至此,二级域名映射到云服务器的完整配置教程结束。

0

评论区