如何在日本服务器上部署HAProxy,为两个Web后端配置负载均衡?
在日本机房的服务器上,HAProxy可以作为公网入口,将访问流量转发到两个Web后端,并通过健康检查自动避开不可用节点。本文以一台日本云服务器作为负载均衡节点、两台通过私有网络连接的Web服务器为例,使用轮询算法分发HTTP请求。
示例环境基于Ubuntu Server 22.04/24.04 LTS、systemd和发行版软件包安装的HAProxy。负载均衡节点监听TCP 80端口,两个后端监听TCP 8080端口。示例地址仅用于说明,实际部署时请替换为日本服务器和后端的真实地址。
准备条件
确认网络拓扑
本次配置使用以下逻辑拓扑:

| 角色 | 示例地址 | 服务端口 | 用途 |
|---|---|---|---|
| HAProxy负载均衡节点 | 公网IP 203.0.113.20,私网IP 10.10.0.10 | 80 | 接收用户HTTP请求 |
| Web后端1 | 10.10.1.11 | 8080 | 提供Web服务 |
| Web后端2 | 10.10.1.12 | 8080 | 提供Web服务 |
203.0.113.20属于文档示例地址,不是实际可用的公网地址。日本服务器应具备以下条件:
- 可以通过SSH登录,并拥有
sudo权限。 - 操作系统使用APT包管理器,且运行systemd。
- HAProxy节点能够通过私有网络访问两个后端的8080端口。
- 两个Web后端都能提供相同的业务路径和基本服务能力。
- 后端准备一个不需要登录、返回HTTP 200的健康检查路径,例如
/healthz。 - 云平台安全组、网络ACL和服务器本机防火墙允许所需流量。
如果两个后端使用公网IP,也可以完成配置,但不建议将8080端口对整个互联网开放。更合适的做法是让后端只接受来自HAProxy私网IP的访问。
围绕日本站点的双后端负载均衡架构,A5数据提供日本物理服务器资源,可分别承载HAProxy入口和Web后端。日本热销系列涵盖Xeon Gold、AMD EPYC平台及NVMe存储,CTG系列提供不同CPU、SSD或大容量HDD配置,并有多种线路选项,为站点入口、后端应用和数据存储提供不同的资源组合。
确认端口和权限
在HAProxy节点上先检查网卡、路由和80端口占用情况:
ip -br addr
ip route
sudo ss -lntp | grep -E '(:80|:443)\b' || true
如果80端口已经被Nginx、Apache或其他程序占用,不要直接终止未知进程。先确认该服务是否仍在使用:
sudo systemctl status nginx --no-pager
sudo systemctl status apache2 --no-pager
如果计划让HAProxy接管80端口,应先记录原服务配置和启动状态,再决定停用原服务,或者把HAProxy改为其他监听端口进行测试。
检查两个后端是否可访问
在HAProxy节点上直接访问后端健康检查地址:
for ip in 10.10.1.11 10.10.1.12; do
curl -sS --connect-timeout 3 --max-time 5 \
-o /dev/null -w "$ip HTTP %{http_code}\n" \
"http://$ip:8080/healthz"
done
示例结果如下:
10.10.1.11 HTTP 200
10.10.1.12 HTTP 200
这只是预期结果示例,不代表实际执行结果。若出现连接超时、连接拒绝或非200状态,应先处理后端服务、路由或防火墙问题,不要直接进入HAProxy配置阶段。
如果后端没有/healthz,应将命令和后续配置中的路径替换为实际存在的健康检查路径。该路径应尽量轻量、响应稳定,并且不依赖数据库写入、用户登录或复杂业务状态。
配置网络访问规则
云平台安全组
在日本云服务器的安全组或防火墙控制台中,建议按以下范围配置:
- HAProxy节点:允许客户端访问TCP 80端口。
- HAProxy节点:允许出站访问
10.10.1.11:8080和10.10.1.12:8080。 - 两个后端:只允许来源为
10.10.0.10的流量访问TCP 8080端口。 - SSH端口只允许管理来源IP访问,不要因为开放Web端口而放宽SSH范围。
如果网站使用HTTPS,后续还需要单独处理443端口、证书和TLS配置。本文配置只覆盖HTTP 80端口。
本机UFW规则
如果HAProxy节点启用了UFW,先查看当前状态:
sudo ufw status verbose
确认SSH已放行后,再增加HTTP规则:
sudo ufw allow 80/tcp
sudo ufw status numbered
在两个后端服务器上,应限制8080端口仅允许HAProxy节点访问。以下命令需要在后端服务器上执行:
sudo ufw allow from 10.10.0.10 to any port 8080 proto tcp
sudo ufw status numbered
不要在远程SSH会话中直接执行ufw enable,也不要删除尚未确认的SSH规则。防火墙规则变更会影响远程连接,操作前应记录当前规则,回滚时只删除本次新增且确认不再使用的规则。
安装HAProxy
更新软件索引并安装软件包
在日本服务器的HAProxy节点上执行:
sudo apt update
sudo apt install -y haproxy curl
查看发行版提供的HAProxy版本:
apt-cache policy haproxy
sudo haproxy -vv | head -n 20
Ubuntu和Debian不同版本提供的HAProxy版本可能不同。本文使用的frontend、backend、option httpchk和http-check expect status配置适用于常见的HAProxy 2.x发行版软件包。如果软件包版本过旧,先以haproxy -c验证具体指令,不要仅根据网上其他版本的配置直接上线。
检查服务状态:
sudo systemctl status haproxy --no-pager
部分Debian系列软件包会通过/etc/default/haproxy中的ENABLED控制是否允许启动。如果文件中存在ENABLED=0,先备份并改为ENABLED=1:
sudo cp -a /etc/default/haproxy \
/etc/default/haproxy.bak.$(date +%Y%m%d-%H%M%S)
sudoedit /etc/default/haproxy
只修改启用开关,不要清空文件中的其他参数。
备份原始配置
安装软件包后,先备份默认配置:
sudo cp -a /etc/haproxy/haproxy.cfg \
/etc/haproxy/haproxy.cfg.bak.$(date +%Y%m%d-%H%M%S)
这一步用于回滚本次配置。备份文件应保留在/etc/haproxy/目录中,后续不要覆盖或删除。
写入基础配置
以下配置完成四项工作:
- 让HAProxy以HTTP模式处理请求。
- 在80端口接收公网访问。
- 使用轮询算法将请求分发到两个后端。
- 每3秒检查一次后端健康状态,连续失败3次后标记为不可用,连续成功2次后恢复。
使用sudoedit编辑配置文件:
sudoedit /etc/haproxy/haproxy.cfg
将配置调整为以下内容:

global
user haproxy
group haproxy
daemon
defaults
mode http
option httplog
option dontlognull
timeout http-request 10s
timeout connect 5s
timeout client 30s
timeout server 30s
frontend public_http
bind 0.0.0.0:80
mode http
# 由HAProxy重新写入客户端地址,避免直接信任客户端提交的同名请求头
http-request set-header X-Forwarded-For %[src]
http-request set-header X-Forwarded-Proto http
default_backend web_pool
backend web_pool
mode http
balance roundrobin
# 后端必须对该路径返回HTTP 200
option httpchk GET /healthz
http-check expect status 200
server web01 10.10.1.11:8080 check inter 3s fall 3 rise 2
server web02 10.10.1.12:8080 check inter 3s fall 3 rise 2
如果实际后端使用其他地址或端口,只修改server行中的地址。不要把两个后端都写成同一个IP,否则HAProxy表面上配置了两个节点,实际仍然只有一个服务目标。
balance roundrobin适合两个后端处理能力接近、请求耗时差异不大的场景。它按照轮询方式选择可用服务器,但不代表任意短时间内都严格各分配50%的请求。长连接、请求处理时间、健康状态和连接复用都会影响实际分布。
验证配置语法
修改完成后,不要直接重启服务,先执行配置检查:
sudo haproxy -c -f /etc/haproxy/haproxy.cfg
预期结果类似:
Configuration file is valid
如果输出包含错误行号,应先修复语法,再继续启动。常见错误包括:
bind 0.0.0.0:80对应端口已经被其他服务占用。- 健康检查指令拼写错误。
server行的地址或端口格式错误。- 配置文件缩进或不可见字符导致解析异常。
- HAProxy版本过旧,不支持所使用的配置项。
启动并验证服务
启用并重启HAProxy
确认配置检查通过后执行:
sudo systemctl enable haproxy
sudo systemctl restart haproxy
检查服务是否正常运行:
sudo systemctl status haproxy --no-pager
sudo systemctl is-enabled haproxy
sudo systemctl is-active haproxy
预期状态分别应接近:
enabled
active
继续确认80端口已经由HAProxy监听:
sudo ss -lntp | grep -E '0\.0\.0\.0:80|:80\b'
如果能看到HAProxy进程监听80端口,说明服务已经完成本机绑定,但还不能证明后端健康和公网访问正常。
通过本机入口测试
在HAProxy节点本机访问入口:
curl -i --connect-timeout 3 --max-time 10 \
http://127.0.0.1/healthz
如果后端健康检查路径可被正常转发,通常会得到HTTP 200。也可以访问业务首页:
curl -i --connect-timeout 3 --max-time 10 \
http://127.0.0.1/
若本机请求返回503,说明HAProxy已接收到请求,但当前没有可用后端。若本机连接被拒绝,则优先检查HAProxy服务状态和80端口监听。
通过公网地址测试
从外部网络或另一台不在同一台服务器上的主机访问日本服务器公网IP:
curl -i --connect-timeout 5 --max-time 15 \
http://203.0.113.20/
如果网站使用域名,建议使用--resolve在不依赖DNS缓存的情况下测试:
curl -i --connect-timeout 5 --max-time 15 \
--resolve www.example.jp:80:203.0.113.20 \
http://www.example.jp/
该命令会将www.example.jp解析到指定IP,同时保留正确的HTTP Host头,适合检查虚拟主机和域名入口。
验证两个后端是否都参与分发
如果两个后端页面中包含不同的节点标识,例如web01和web02,可以连续发起多次请求:
for i in $(seq 1 8); do
curl -fsS --connect-timeout 3 --max-time 10 \
--resolve www.example.jp:80:203.0.113.20 \
http://www.example.jp/
printf '\n'
done
预期结果是不同请求可能返回来自两个后端的不同节点标识。这里的输出仅为验证方法示例,不是实际执行记录。
如果两个后端返回内容完全相同,可以在应用日志中查看请求来源,或者在测试环境为两个后端临时增加可识别的响应信息。不要为了验证而在生产页面中长期暴露内部主机名、私网IP或版本信息。
异常处理
配置检查不通过
先查看完整错误信息:
sudo haproxy -c -f /etc/haproxy/haproxy.cfg
根据报错行号检查对应配置。不要在配置检查失败时执行systemctl restart haproxy,否则可能导致原本正在运行的HAProxy停止。
如果是健康检查路径不匹配,例如后端返回301、401或404,应先直接测试:
curl -i http://10.10.1.11:8080/healthz
curl -i http://10.10.1.12:8080/healthz
只有两个后端都能返回预期的200状态时,http-check expect status 200才适合保持不变。若应用的健康接口确实返回204,也可以将检查条件改为实际约定的状态,但两个后端应保持一致。
80端口绑定失败
查看占用进程:
sudo ss -lntp | grep ':80'
根据进程名称决定处理方式:
- 如果是已经不再使用的服务,先确认其配置和启动状态,再停止它。
- 如果原服务仍有业务,不能直接停止,应改为让HAProxy监听其他端口进行验证,或重新规划入口。
- 如果HAProxy旧进程没有正常退出,查看服务日志后再处理,不要直接使用
kill -9。
查看HAProxy启动错误:
sudo journalctl -u haproxy -n 80 --no-pager
返回503 Service Unavailable
HAProxy返回503通常表示没有可用的后端服务器。按以下顺序检查:

- 直接从HAProxy节点访问两个后端的健康路径。
- 检查后端服务是否监听在私网地址,而不是只监听
127.0.0.1。 - 检查云安全组和后端UFW是否允许来源为
10.10.0.10的8080连接。 - 检查健康路径是否要求认证、依赖Cookie或返回了非200状态。
- 确认配置中的后端IP、端口和实际服务一致。
如果两个后端直连都返回200,但HAProxy仍返回503,重新执行配置检查并查看服务日志,重点确认实际加载的配置文件是否为/etc/haproxy/haproxy.cfg。
返回504 Gateway Timeout
504通常表示HAProxy已经选择了后端,但后端在规定时间内没有完成连接或响应。可以先分别测量两个后端的响应时间:
for ip in 10.10.1.11 10.10.1.12; do
curl -sS --connect-timeout 3 --max-time 40 \
-o /dev/null \
-w "$ip connect=%{time_connect}s total=%{time_total}s status=%{http_code}\n" \
"http://$ip:8080/"
done
如果后端响应时间长期超过配置中的timeout server 30s,应优先检查应用、数据库和后端资源,而不是盲目增大超时时间。确实需要调整时,应根据实际接口耗时单独评估timeout connect和timeout server,并重新执行配置检查。
只有一个后端收到请求
先确认两个后端都能通过健康检查:
curl -i http://10.10.1.11:8080/healthz
curl -i http://10.10.1.12:8080/healthz
如果其中一个返回非200,HAProxy会按照配置将其标记为不可用。fall 3表示连续失败3次后下线,rise 2表示连续成功2次后恢复。后端修复后,等待几个检查周期,再重新测试入口。
后端应用获取不到真实客户端IP
本文通过以下请求头向后端传递客户端地址:
X-Forwarded-For
X-Forwarded-Proto
后端应用或Web服务器只能信任来自HAProxy的这些请求头,不应直接信任所有互联网客户端提交的同名头部。若后端日志仍记录为HAProxy私网IP,应检查应用是否读取了X-Forwarded-For,以及应用所在的Web服务器是否覆盖了该请求头。
结果检查
首次部署完成后,建议按下面顺序进行验收:
haproxy -c返回配置有效。systemctl is-active haproxy返回active。systemctl is-enabled haproxy返回enabled。- HAProxy节点监听TCP 80端口。
- HAProxy节点可以直接访问两个后端的健康检查路径。
- 外部网络可以访问日本服务器公网IP的80端口。
- 使用域名访问时,域名A记录指向正确的日本服务器公网IP。
- 两个后端返回的页面、响应头或应用日志能够证明请求均有机会被分发。
- 后端8080端口没有对整个互联网开放。
- 管理接口、SSH和其他未使用端口没有因为本次配置被额外暴露。
如果需要测试故障转移,应安排维护窗口,在确认业务影响范围后临时停止一个后端或将其从负载池中摘除,再观察入口是否仍能访问。测试完成后恢复后端,并确认健康检查状态重新变为可用。不要在高峰期直接停止承载用户请求的后端。
回滚检查项
如果新配置导致服务无法启动,先保留当前配置用于排查,再恢复安装前的备份:
BACKUP=$(sudo ls -1t /etc/haproxy/haproxy.cfg.bak.* | head -n 1)
echo "$BACKUP"
sudo cp -a "$BACKUP" /etc/haproxy/haproxy.cfg
恢复后先验证语法:
sudo haproxy -c -f /etc/haproxy/haproxy.cfg
确认有效后再重启:
sudo systemctl restart haproxy
sudo systemctl status haproxy --no-pager
如果需要完全撤销本次HAProxy入口,在确认没有其他业务依赖该服务后执行:
sudo systemctl disable --now haproxy
若本次新增了UFW规则,应先查看规则编号:
sudo ufw status numbered
确认规则确实是本次新增且没有其他服务使用后,再删除对应规则:
sudo ufw delete allow 80/tcp
回滚时不要删除两个Web后端的服务和数据,也不要直接清空整个防火墙规则集。最终应确认:HAProxy服务状态符合回滚目标、80端口不再被错误进程占用、后端服务仍可单独访问、云平台安全组和本机防火墙没有遗留超出用途的开放端口。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/5439.html



