Nginx 如何使用 include 配置在多台前端机之间同步站点结构

Nginx 本身不提供文件同步能力，include 指令仅实现配置文件的本地引入，不复制文件；多机一致性需分两层：① 配置同步靠 include + CI/CD 批量推送 conf 文件；② 静态资源同步依赖 rsync、Ansible 或 NFS 等外部工具确保各节点 /var/www/app1 等路径内容严格一致。

Nginx 本身不提供文件同步能力，include 指令只是配置层面的“引入”，它不会自动把文件从一台机器复制到另一台。所谓“在多台前端机之间同步站点结构”，实际要分两层理解：配置同步 和 静态资源同步。include 只参与第一层，且必须配合外部工具才能实现真正的多机一致性。

include 的作用是统一管理配置，不是同步文件

include 让你把 server 块、location 规则等拆成独立文件（比如 /etc/nginx/conf.d/app1.conf、/etc/nginx/conf.d/app2.conf），再在主配置中用 include /etc/nginx/conf.d/*.conf; 加载。好处是：- 多个项目配置互不干扰- 修改某个前端项目时，只需更新对应 conf 文件，不影响其他服务- 配合 CI/CD 或脚本，可批量推送相同 conf 到所有 Nginx 节点

但注意：include 不会读取远程路径，所有被 include 的文件必须已存在于本机指定目录下。

静态资源同步需借助外部工具

前端项目的 HTML、JS、CSS 等静态文件，必须真实存在于每台 Nginx 服务器的对应路径（如 /var/www/app1/）。常见可靠同步方式有：- rsync + SSH：适合中小规模，定时或发布时触发，命令如 rsync -avz --delete /data/dist/ [email protected]:/var/www/app1/- inotify + rsync：监听源目录变更，实时推送到各节点- Ansible/Puppet/Chef：声明式管理，确保所有节点的文件树和权限完全一致- NFS 或对象存储挂载：让所有 Nginx 实例读取同一份后端存储（需注意性能与缓存一致性）

关键点：路径必须严格一致。例如所有机器都用 root /var/www/app1;，那么 /var/www/app1 目录内容就必须完全相同，否则访问会 404 或加载错版本。

配合 keepalived 实现高可用时的注意事项

如果你用 keepalived 做主备 VIP（如虚拟 IP 192.168.17.50），两台 Nginx 机器必须：- 配置文件结构一致（靠 include 统一管理更易维护）- 静态资源内容一致（否则主切备时用户看到旧版页面）- try_files $uri $uri/ /index.html; 这类单页应用回退规则不能依赖本地路径差异- 建议在健康检查脚本（如 /usr/local/src/nginx_check.sh）里同时校验关键静态文件的 MD5 或时间戳，避免配置没变但资源已脏

不复杂但容易忽略