## 一、前言
在实际的网站部署和服务器运维过程中,我们经常会遇到这样的需求:
- 希望通过一个独立的域名访问自己的 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 服务、物联网平台和设备监控系统等应用场景。
至此,二级域名映射到云服务器的完整配置教程结束。
评论区