如何在日本服务器配置Nginx负载均衡,并验证请求分发到后端?
在日本地域的服务器上部署Nginx负载均衡,核心是让Nginx监听公网请求,再按照轮询策略把请求转发到两个或多个后端服务。验证时不能只看Nginx返回了200,还应同时检查后端标识、X-LB-Upstream响应头、Nginx访问日志以及后端直连结果。
下面以Ubuntu 22.04/24.04、Nginx开源版和HTTP后端为例。示例先使用同一台日本服务器上的127.0.0.1:18081与127.0.0.1:18082模拟两个后端,便于首次部署时直接验证;如果后端位于独立服务器,只需将配置中的地址替换为后端私网IP和实际端口。
A5idc数据提供日本物理服务器资源,覆盖Xeon Gold、AMD EPYC与NVMe存储等配置,可承载Nginx入口、应用后端及数据库等多角色部署。日本热销系列与CTG系列还提供不同带宽和线路选项,包括CN2、CIA、GIA及SoftBank,并支持部分多IP方案,能够为日本本地访问、跨境业务和多后端架构提供相应的硬件与网络基础。
一、确定部署拓扑与准备条件
1. 示例拓扑
| 角色 | 示例地址 | 作用 |
|---|---|---|
| 日本Nginx负载均衡服务器 | 公网IP,示例为203.0.113.10 | 接收客户端请求并转发 |
| 后端A | 127.0.0.1:18081 | 返回backend-a |
| 后端B | 127.0.0.1:18082 | 返回backend-b |
| 访问域名 | app.example.jp | 指向日本服务器公网IP |
203.0.113.10和app.example.jp是文档示例,不代表实际可用地址。部署时应替换为自己的公网IP和域名。
如果后端在独立服务器上,拓扑可以调整为:

客户端
|
| HTTP 80
v
日本服务器上的Nginx
|-- 10.0.1.11:8080 后端A
`-- 10.0.1.12:8080 后端B
后端端口应仅允许日本Nginx服务器访问,不建议直接对公网开放。日本服务器的云防火墙、安全组或系统防火墙至少要允许客户端访问TCP 80;如果配置HTTPS,还需要单独放行TCP 443。
2. 检查系统、权限和端口
先确认操作系统、当前权限以及80端口是否被其他服务占用:
cat /etc/os-release
id
sudo ss -lntp
本文命令适用于使用apt的Ubuntu或Debian系统。如果输出中已经有Apache、Caddy或其他程序监听0.0.0.0:80,不要直接停止服务,应先确认该服务是否仍被业务使用。可以通过以下命令确认进程:
sudo ss -lntp | grep ':80'
如果是新服务器,建议在修改Nginx配置前保存配置目录:
sudo cp -a /etc/nginx "/etc/nginx.bak.$(date +%F-%H%M%S)"
这一步用于回滚配置,不会影响正在运行的Nginx进程。
3. 准备后端服务
生产环境应使用已有的应用服务,例如Java、Node.js、PHP-FPM或Go服务,并确保每个后端能够通过健康接口或业务接口返回内容。
如果暂时没有后端程序,可以用Python内置HTTP服务进行验证。以下命令只适合作为测试,不建议用于生产:
sudo install -d -m 0755 /opt/lb-demo/backend-a
sudo install -d -m 0755 /opt/lb-demo/backend-b
printf 'backend-a\n' | sudo tee /opt/lb-demo/backend-a/index.html >/dev/null
printf 'backend-b\n' | sudo tee /opt/lb-demo/backend-b/index.html >/dev/null
打开两个终端窗口,分别启动两个后端:
终端A:
python3 -m http.server 18081 \
--bind 127.0.0.1 \
--directory /opt/lb-demo/backend-a
终端B:
python3 -m http.server 18082 \
--bind 127.0.0.1 \
--directory /opt/lb-demo/backend-b
保持这两个终端运行。回到日本服务器的第三个终端,直接检查后端:
curl --fail --silent --show-error http://127.0.0.1:18081/
curl --fail --silent --show-error http://127.0.0.1:18082/
预期分别返回:
backend-a
backend-b
如果这里无法返回内容,先不要配置Nginx。后端未监听、端口错误、服务绑定在其他地址或本机防火墙限制,都会导致后续出现502错误。
二、安装Nginx并确认服务状态
1. 安装软件包
更新软件索引并安装Nginx与测试用的curl:
sudo apt-get update
sudo apt-get install -y nginx curl
确认Nginx版本:
nginx -v
示例输出可能类似:
nginx version: nginx/1.24.0
版本号会随Ubuntu软件源和系统更新变化,重点是命令能够正常返回版本信息。
2. 检查默认服务
安装后先检查服务状态:
sudo systemctl status nginx --no-pager
如果服务没有启动,可以执行:
sudo systemctl enable nginx
sudo systemctl start nginx
此时直接访问本机80端口:
curl -I http://127.0.0.1/
如果返回HTTP/1.1 200 OK或Nginx默认页面,说明软件包和监听服务基本正常。默认站点暂时不需要删除,后续使用明确的server_name匹配业务域名。
三、创建负载均衡配置
1. 添加访问日志格式
为了在日志中看到请求被转发到了哪个后端,先创建一份日志格式配置。Ubuntu默认会在http上下文中加载/etc/nginx/conf.d/*.conf,可以先确认:
grep -n 'conf.d' /etc/nginx/nginx.conf
如果能看到类似下面的配置,说明该目录会被加载:
include /etc/nginx/conf.d/*.conf;
创建日志配置:
sudo tee /etc/nginx/conf.d/lb-log.conf >/dev/null <<'EOF'
log_format lb '$remote_addr [$time_iso8601] "$request" '
'status=$status upstream=$upstream_addr '
'upstream_status=$upstream_status '
'request_time=$request_time '
'upstream_time=$upstream_response_time';
EOF
日志中的几个变量含义如下:
$upstream_addr:实际处理请求的后端地址。$upstream_status:后端返回给Nginx的状态码。$request_time:Nginx处理整个请求的时间。$upstream_response_time:等待后端响应的时间。
如果当前系统的nginx.conf没有加载conf.d目录,不要把log_format直接放进server块。应将上述内容放到主配置文件的http {}上下文中,或者继续使用默认日志格式。
2. 写入负载均衡配置
创建站点配置文件:

sudo tee /etc/nginx/sites-available/app-lb.conf >/dev/null <<'EOF'
upstream app_backend {
server 127.0.0.1:18081 max_fails=3 fail_timeout=10s;
server 127.0.0.1:18082 max_fails=3 fail_timeout=10s;
}
server {
listen 80;
server_name app.example.jp;
access_log /var/log/nginx/app_lb_access.log lb;
error_log /var/log/nginx/app_lb_error.log warn;
location / {
proxy_pass http://app_backend;
proxy_http_version 1.1;
proxy_set_header Connection "";
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;
proxy_connect_timeout 5s;
proxy_read_timeout 60s;
proxy_send_timeout 60s;
proxy_next_upstream error timeout;
add_header X-LB-Upstream $upstream_addr always;
add_header X-LB-Status $upstream_status always;
}
}
EOF
配置中的upstream app_backend定义了后端池。Nginx未指定其他策略时,默认使用轮询方式,将请求依次分配给后端A和后端B。
如果使用独立后端服务器,应将两行地址替换为实际私网地址。例如:
upstream app_backend {
server 10.0.1.11:8080 max_fails=3 fail_timeout=10s;
server 10.0.1.12:8080 max_fails=3 fail_timeout=10s;
}
不要直接照搬示例IP。替换前需要从日本Nginx服务器测试到后端的网络连通性:
curl --connect-timeout 3 --fail --silent --show-error \
http://10.0.1.11:8080/healthz
curl --connect-timeout 3 --fail --silent --show-error \
http://10.0.1.12:8080/healthz
3. 启用站点配置
创建软链接:
sudo ln -sfn \
/etc/nginx/sites-available/app-lb.conf \
/etc/nginx/sites-enabled/app-lb.conf
这里没有删除默认站点,因此访问app.example.jp时会根据Host头匹配新配置;直接访问服务器IP而没有正确的域名头,仍可能看到默认站点。
4. 检查配置并加载服务
任何重载操作前都先执行语法检查:
sudo nginx -t
成功时应看到类似结果:
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful
只有在检查成功后,才加载新配置:
sudo systemctl reload nginx
sudo systemctl status nginx --no-pager
reload会让Nginx平滑读取新配置,通常不会中断已经建立的连接。如果nginx -t失败,不要执行reload,先根据错误行号修复配置。
四、验证请求是否分发到后端
1. 使用Host头验证域名匹配
在DNS尚未生效时,可以通过Host请求头进行本机验证:
curl -sS -D - -o /tmp/lb-body \
-H 'Host: app.example.jp' \
http://127.0.0.1/
查看响应头和响应内容:
grep -Ei '^(HTTP/|X-LB-Upstream:|X-LB-Status:)' /tmp/lb-body 2>/dev/null || true
cat /tmp/lb-body
上面的第一条命令将响应头输出到终端,响应正文保存到/tmp/lb-body。更直接的写法是:
curl -sS -D - -o /tmp/lb-body \
-H 'Host: app.example.jp' \
http://127.0.0.1/ | grep -Ei '^(HTTP/|X-LB-)'
printf 'body='
cat /tmp/lb-body
预期可以看到类似内容:

HTTP/1.1 200 OK
X-LB-Upstream: 127.0.0.1:18081
X-LB-Status: 200
body=backend-a
再次请求时,X-LB-Upstream可能变为:
X-LB-Upstream: 127.0.0.1:18082
这比只看页面是否返回200更可靠,因为它能直接显示Nginx选择的后端地址。
2. 连续请求并统计后端数量
执行20次请求,统计两个后端分别返回了多少次:
for i in $(seq 1 20); do
curl --fail --silent \
-H 'Host: app.example.jp' \
http://127.0.0.1/
done | sort | uniq -c
示例结果:
10 backend-a
10 backend-b
实际结果不一定严格为10和10。轮询是请求分配策略,不是对任意时间窗口做精确比例承诺。后端故障、请求失败、连接复用、请求数量过少以及应用自身缓存,都可能导致短时间内出现偏差。
也可以直接统计Nginx返回的后端地址:
for i in $(seq 1 20); do
curl --silent --show-error \
-D - -o /dev/null \
-H 'Host: app.example.jp' \
http://127.0.0.1/ |
tr -d '\r' |
awk -F': ' 'tolower($1) == "x-lb-upstream" {print $2}'
done | sort | uniq -c
预期类似:
10 127.0.0.1:18081
10 127.0.0.1:18082
3. 检查Nginx访问日志
查看最近的负载均衡日志:
sudo tail -n 20 /var/log/nginx/app_lb_access.log
示例日志:
127.0.0.1 [2025-01-01T10:20:30+09:00] "GET / HTTP/1.1" status=200 upstream=127.0.0.1:18081 upstream_status=200 request_time=0.001 upstream_time=0.001
127.0.0.1 [2025-01-01T10:20:31+09:00] "GET / HTTP/1.1" status=200 upstream=127.0.0.1:18082 upstream_status=200 request_time=0.001 upstream_time=0.001
这是示例输出,不代表实际执行记录。实际日志中应重点确认:
status=200:Nginx返回成功。upstream_status=200:后端也返回成功。upstream地址在多个后端之间变化。upstream_time没有持续出现超时或异常高值。
4. 使用真实域名验证
DNS的A记录应指向日本Nginx服务器公网IP:
app.example.jp. A 日本服务器公网IP
确认DNS解析结果:
dig +short app.example.jp
如果服务器配置了IPv6但Nginx没有监听IPv6,暂时不要添加AAAA记录,避免部分客户端优先访问IPv6而连接失败。
DNS生效后,使用域名访问:
curl -i http://app.example.jp/
如果必须在DNS切换前验证公网链路,可以使用--resolve:
curl -i \
--resolve app.example.jp:80:203.0.113.10 \
http://app.example.jp/
该命令只对本次请求使用指定IP,不会修改本机DNS。
五、常见异常及处理顺序
1. nginx -t提示配置错误
先查看完整配置和具体报错:
sudo nginx -t
sudo nginx -T | less
常见原因包括:
server或upstream块缺少分号。lb-log.conf没有位于http上下文。server_name配置重复或拼写错误。- 站点软链接指向了不存在的文件。
- 文件权限导致Nginx无法读取配置。
如果只是新增配置,错误修复前不要重载服务。确认备份目录存在:
ls -ld /etc/nginx.bak.*
2. 返回502 Bad Gateway
502通常表示Nginx无法正常从后端取得响应。按由外到内的顺序检查:
sudo ss -lntp | grep -E ':18081|:18082'
然后直连后端:
curl -v --connect-timeout 3 http://127.0.0.1:18081/
curl -v --connect-timeout 3 http://127.0.0.1:18082/
如果是独立后端,则在日本服务器上直连后端私网地址。不同结果的含义如下:

- 直连两个后端都失败:先检查后端服务、监听地址、端口和防火墙。
- 直连成功但Nginx返回502:检查
proxy_pass、端口、配置加载状态和Nginx错误日志。 - 一个后端成功、一个后端失败:失败节点可能被轮询到,需恢复该节点或暂时从
upstream中移除。 - 后端返回应用级错误:检查应用日志,Nginx本身不一定是故障源。
查看错误日志:
sudo tail -n 50 /var/log/nginx/app_lb_error.log
独立后端场景下,后端防火墙应仅允许日本Nginx服务器的私网IP访问应用端口。例如后端使用UFW时,变更前先记录当前规则:
sudo ufw status numbered | tee ~/ufw-before-lb.txt
确认来源IP和端口无误后再添加规则:
sudo ufw allow from 10.0.1.10 to any port 8080 proto tcp
该命令会改变后端访问控制,应用前应确认10.0.1.10确实是日本Nginx服务器的私网IP。回滚时执行:
sudo ufw delete allow from 10.0.1.10 to any port 8080 proto tcp
3. 总是返回Nginx默认页面
先用明确的Host头测试:
curl -i -H 'Host: app.example.jp' http://127.0.0.1/
如果带Host头可以正常转发,直接访问IP看到默认页面属于正常的虚拟主机匹配结果。此时检查:
sudo nginx -T | grep -n -A8 -B3 'server_name app.example.jp'
如果带Host头仍然返回默认页面,检查:
app-lb.conf是否已经链接到sites-enabled。server_name是否拼写一致。- 修改配置后是否执行了
nginx -t和systemctl reload nginx。 - DNS是否实际指向日本Nginx服务器。
4. 请求没有严格一半一半分配
不要仅凭少量请求判断负载均衡失效。先查看每次响应的X-LB-Upstream和访问日志。以下情况会影响观察结果:
- 请求数量太少。
- 后端有故障,Nginx暂时跳过失败节点。
- 使用了会话保持或应用层缓存。
- 客户端复用连接,测试方式并非每次产生独立请求。
- 后端处理时间差异较大。
当前配置使用的是默认轮询,不包含ip_hash或基于Cookie的会话保持。如果应用依赖本地会话文件,应优先改造为共享会话存储,或在明确业务需求后再设计会话保持策略,不建议直接为了“固定后端”修改负载策略。
5. 模拟后端故障
在运行后端B的终端按Ctrl+C停止服务,然后快速发起请求:
for i in $(seq 1 10); do
curl -sS -D - -o /dev/null \
-H 'Host: app.example.jp' \
http://127.0.0.1/ |
tr -d '\r' |
grep -Ei '^(HTTP/|X-LB-Upstream:|X-LB-Status:)'
done
max_fails=3 fail_timeout=10s表示在配置的失败条件下,节点达到失败次数后会在一段时间内被暂时跳过。实际切换时间还受连接超时和失败类型影响。
恢复后端B:
python3 -m http.server 18082 \
--bind 127.0.0.1 \
--directory /opt/lb-demo/backend-b
恢复后再次观察X-LB-Upstream,确认两个后端都能重新出现。
六、部署完成后的验收项
| 检查项目 | 验收方式 | 预期结果 |
|---|---|---|
| Nginx配置语法 | sudo nginx -t | syntax ok,test successful |
| 服务状态 | systemctl is-active nginx | 输出active |
| 后端A直连 | curl http://后端A:端口/ | 能返回应用内容 |
| 后端B直连 | curl http://后端B:端口/ | 能返回应用内容 |
| 域名匹配 | 带Host头访问 | 不再返回默认站点 |
| 请求转发 | 检查X-LB-Upstream | 显示不同后端地址 |
| 分发结果 | 连续请求并统计 | 多个后端均收到请求 |
| 日志记录 | 查看app_lb_access.log | 有upstream和状态码 |
| 故障切换 | 暂停一个后端后访问 | 另一后端仍可提供服务,具体切换时间取决于超时设置 |
| 外部访问 | 从外部网络访问域名 | 能通过日本服务器返回业务响应 |
七、回滚操作
如果新配置导致Nginx无法重载,先不要停止当前服务。配置文件错误时,已经运行的旧Worker通常会继续处理已有配置,但后续重载会失败。
本次部署新增的文件可以按以下方式撤销:
sudo rm -f \
/etc/nginx/sites-enabled/app-lb.conf \
/etc/nginx/sites-available/app-lb.conf \
/etc/nginx/conf.d/lb-log.conf
删除配置后先检查,再重载:
sudo nginx -t
sudo systemctl reload nginx
如果站点配置此前已经存在并被覆盖,应从部署前备份中恢复。先找到最近的备份目录:
ls -dt /etc/nginx.bak.* | head -n 5
确认备份目录后,仅恢复对应文件,避免覆盖部署期间产生的其他配置。示例:
BACKUP=$(ls -dt /etc/nginx.bak.* | head -n1)
sudo cp -a \
"$BACKUP/sites-available/app-lb.conf" \
/etc/nginx/sites-available/app-lb.conf
恢复后执行:
sudo nginx -t
sudo systemctl reload nginx
回滚验收应再次确认以下项目:
- Nginx服务仍为
active。 - 原有站点能够返回预期内容。
- 不再出现新的502或配置解析错误。
sites-enabled中的软链接指向正确文件。- 后端服务没有因测试而遗留停止状态。
- 如果曾修改UFW或云防火墙,已根据变更记录恢复原规则。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/7364.html



