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 使用变量后路径处理不符合预期。
按自己的节奏,确认真正理解。