如何在日本服务器配置Nginx负载均衡,并验证请求分发到后端?

发布人:A5数据发布时间:2026-11-03 13:22阅读量:83

在日本地域的服务器上部署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接收客户端请求并转发
后端A127.0.0.1:18081返回backend-a
后端B127.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 -tsyntax 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

相关推荐