分布式系统中 Nginx 虚拟主机如何同步

Nginx虚拟主机配置需在多台服务器上完全一致才能实现真正同步，包括listen、server_name、root、proxy_pass、SSL证书等全部配置项；推荐用rsync批量同步并配合nginx -t校验；通过页面标识和Keepalived（state、priority、virtual_router_id严格配对）实现故障切换与验证。

Nginx 虚拟主机本身不自动同步，它只是配置驱动的静态路由规则。所谓“同步”，实际是指多台 Nginx 服务器上部署完全一致的虚拟主机（server 块）配置，确保用户无论访问哪台节点，得到的服务行为、域名响应、后端转发逻辑都一致。这在双机热备、负载均衡集群或灰度发布场景中尤为关键。

虚拟主机配置必须逐字一致

不是只复制 server_name 或 location，而是整个生效配置树：包括 listen 端口、server_name 域名/IP、root 路径、index 文件、proxy_pass 地址、SSL 证书路径与密钥、甚至 error_page 指向的页面内容。一处差异（比如主节点 proxy_pass http://app-v1;，备节点写成 http://app-v2;），VIP 切换后就会返回 502 或错误页面。

用 rsync 实现配置文件批量同步

推荐将全部 Nginx 配置目录作为整体同步目标，排除日志和临时文件：

rsync -avz --delete --exclude='logs/' --exclude='*.tmp' /etc/nginx/ user@backup-server:/etc/nginx/

每次推送后，在两台机器上都执行：

nginx -t && systemctl reload nginx

避免语法错误导致服务中断。

加运行标识便于快速验证

在每个虚拟主机的默认页里嵌入可识别的标识，例如：

1. 主节点 /usr/share/nginx/html/index.html 中写 <h2>WEB01 — MASTER</h2>
2. 备节点对应位置写 <h2>WEB02 — BACKUP</h2>

   然后用 curl -s http://your-domain/ | grep WEB 直接确认当前响应来自哪台真实机器。

配合 Keepalived 实现自动故障切换时，注意三点硬性配对

1. state：主设 MASTER，备设 BACKUP
2. priority：主高备低（如 100 vs 90）
3. virtual_router_id：主备必须完全相同（如 51）

   三者缺一不可，否则 VRRP 组无法建立，VIP 不会漂移。

不要依赖 DNS 或浏览器缓存做“软同步”

同一域名解析到多个 IP（如 www.example.com A 192.168.1.10, A 192.168.1.11），但客户端通常只用第一个 IP，且无健康感知。这不是同步，是轮询暴露——一旦某台 Nginx 配置异常或宕机，用户请求仍会打过去，造成失败。真同步必须靠配置统一 + VIP + 主动健康检查闭环。

不复杂但容易忽略