Web 服务器与网关 / 系统课时

配置上游域名解析

配置上游域名解析

本课解决 Nginx 反向代理面对动态服务地址变化时的解析问题,帮助你理解启动时解析与运行时解析的差异,并通过 resolver 与变量代理让网关适应容器、服务发现等动态环境。

学习目标

  • 理解 Nginx 上游域名解析的两种行为模式。
  • 掌握 resolver 与变量 proxy_pass 的组合配置方式。
  • 能够验证动态域名变化后的代理效果。

启动解析与运行时解析差异

Nginx 默认情况下会在加载配置时解析固定域名。如果 upstream 或 proxy_pass 中直接写入域名,解析结果通常会被保留到启动阶段,后续 DNS 记录变化不会自动更新。

在容器环境中,服务 IP 经常因为扩缩容发生变化,仅依赖启动解析可能导致网关继续访问旧地址。运行时解析需要让 Nginx 在请求阶段重新查询域名。

使用 resolver 配置动态解析

运行时解析需要两个条件:使用 resolver 指定 DNS 服务器,并在 proxy_pass 中使用变量触发动态解析。

nginx
http {
    resolver 127.0.0.11 valid=<TIME>;

    server {
        listen <PORT>;

        location /api/ {
            set $backend_service http://api-service:8080;
            proxy_pass $backend_service;
        }
    }
}

预期结果

text
请求 /api/users 时,Nginx 根据 resolver 查询 api-service 当前地址,并转发到解析后的服务实例。

变量形式的 proxy_pass 会改变解析时机,但也会影响 URI 拼接规则。实际配置时需要明确后端地址格式,避免路径被意外替换。

动态环境中的验证方法

修改 DNS 记录或替换容器实例后,可以通过访问日志确认请求是否进入新的地址。排查时优先确认 resolver 可访问、DNS 返回正常,以及变量中的协议和端口完整。

常见失败原因包括 DNS 服务器地址错误、容器网络无法访问 DNS、resolver 缓存时间过长,以及 proxy_pass 使用变量后路径处理不符合预期。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

配置上游域名解析

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通