Nginx 的 upstream 配置必须位于 http 块内，但可分离为独立文件（如 /etc/nginx/conf.d/upstream_backend.conf）并通过 include 引入，实现解耦与维护；需确保 include 位置正确、路径可读、语法验证通过后重载。
Nginx 的 upstream 配置本身不能“独立运行”，但它可以物理上分离存放、逻辑上集中引用，实现配置解耦与便于维护。关键不在于“独立文件是否生效”，而在于如何组织、加载、验证它。
upstream 配置必须放在 http 块内，但可单独成文件
Nginx 启动时会按顺序读取主配置（如 /etc/nginx/nginx.conf）及其 include 引入的子文件。只要子文件内容最终被加载到 http { } 块中，upstream 就合法有效。
推荐做法是：
- 新建一个专用配置文件（如
/etc/nginx/conf.d/upstream_backend.conf） - 把所有
upstream块写在里面 - 在主
nginx.conf的http块末尾（或include mime.types;之后）加入：include /etc/nginx/conf.d/upstream_*.conf;
这样既满足语法要求（upstream 在 http 块作用域内），又避免主配置臃肿。
文件命名与位置需符合 Nginx 加载规则
不同发行版默认加载路径略有差异，常见位置有：
-
/etc/nginx/conf.d/（CentOS/RHEL/Debian 默认启用） -
/usr/local/nginx/conf/conf.d/（源码编译常用） -
/www/server/nginx/conf/conf.d/（宝塔面板专用）
确认你使用的 Nginx 是否启用了该目录的 include，方法是检查主配置中是否存在类似行：
include /etc/nginx/conf.d/*.conf;
如果没有，手动加上，并确保路径存在且权限可读（nginx 用户需有读取权限）。
多环境或多业务场景下建议分组管理
不要把所有 upstream 堆在一个文件里。按用途拆分更易维护：
-
upstream_api.conf：API 服务集群（含健康检查、weight） -
upstream_static.conf：静态资源后端（可配max_conns限流） -
upstream_admin.conf：管理后台专用（带ip_hash或白名单限制）
每个文件只放对应 upstream 块，不包含 server 或 location，保持职责单一。
注意变量和引用的一致性
如果用到了 map 或 resolver 动态路由（比如 proxy_pass http://$backend），注意：
-
resolver必须定义在http块顶层（不能在子文件里“跨文件”生效） -
$backend这类变量要在同级或外层作用域声明，否则proxy_pass会报错invalid URL
所以动态 DNS 场景下，resolver 建议写在主 nginx.conf 的 http 块开头，而 upstream 定义仍可放在子文件中——它们是互补关系，不是替代关系。
修改后务必验证再重载
每次增删 upstream 文件，都要执行：
nginx -t # 检查语法和路径有效性 systemctl reload nginx # 平滑重载，不中断服务
若提示 upstream directive is not allowed here，说明该文件被错误地 include 到了 server 或 location 块里，需检查 include 语句位置。
