Docker Compose+Nginx反向代理域名访问异常排查与无hosts配置需求

阿华AIGC实验室

2026-5-6

问题分析与解决方案

让我来帮你排查这个问题的根源，同时给出不需要手动修改hosts文件的恢复方案：

一、为什么之前正常现在失效了？

你之前能不用手动配置hosts就访问*.my-project.localhost，核心是依赖操作系统或浏览器对*.localhost子域的默认解析规则——绝大多数现代系统（Windows 10+、macOS 10.15+）和主流浏览器（Chrome、Firefox）都会自动把所有以.localhost结尾的域名解析到127.0.0.1。现在失效的原因大概率是以下情况之一：

DNS缓存异常：浏览器或系统的DNS缓存过期、损坏，导致原本的解析规则无法生效。
系统/浏览器配置变更：系统更新、浏览器设置调整（比如第三方DNS插件干扰），破坏了.localhost子域的默认解析逻辑。
Docker网络波动：虽然Nginx容器内部能正常解析Docker服务名（api-1、api-2等），但外部请求需要主机把域名解析到127.0.0.1才能转发到Nginx的80端口，若主机侧的DNS解析链路出问题，就会出现“无法找到站点”的错误。

二、无需手动修改hosts的恢复方案

方案1：清除DNS缓存（最快尝试）

先从最简单的缓存清理入手，大概率能解决问题：

清除浏览器DNS缓存：
- Chrome：打开chrome://net-internals/#dns，点击「Clear host cache」
- Firefox：打开about:networking#dns，点击「Clear DNS Cache」
清除系统DNS缓存：
- Windows：打开命令提示符，执行 ipconfig /flushdns
- macOS：打开终端，执行 sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder
- Linux（Ubuntu/Debian）：执行 sudo systemd-resolve --flush-caches

清理完成后，尝试重新访问你的域名，看是否恢复正常。

方案2：用DNSmasq容器自动管理域名解析（推荐长期方案）

如果缓存清理无效，可以用一个轻量的DNSmasq容器来自动处理*.my-project.localhost的解析，完全替代手动修改hosts的操作：

修改docker-compose.yml，添加dnsmasq服务：

version: "3.2"
services:
  api-1:
    image: my-companies-docker-registry.api-1
  api-2:
    image: my-companies-docker-registry.api-2
  main-front-end:
    image: my-companies-docker-registry.main-front-end
  my-project:
    image: nginx
    depends_on:
      - api-1
      - api-2
      - main-front-end
    ports:
      - 80:80
    volumes:
      - type: bind
        read_only: true
        source: ./nginx
        target: /etc/nginx
  # 新增dnsmasq服务
  dnsmasq:
    image: jpillora/dnsmasq
    ports:
      - "53:53/udp"
    volumes:
      - type: bind
        source: ./dnsmasq.conf
        target: /etc/dnsmasq.conf
    cap_add:
      - NET_ADMIN

创建dnsmasq.conf配置文件（和docker-compose.yml同目录）：

# 把所有.my-project.localhost结尾的域名解析到127.0.0.1
address=/my-project.localhost/127.0.0.1

配置主机使用本地DNSmasq服务：
- Windows/macOS：打开系统网络设置，在DNS服务器列表中添加127.0.0.1（放在最顶部）
- Linux：修改/etc/resolv.conf，添加nameserver 127.0.0.1（注意部分发行版可能需要修改systemd-resolved配置）

启动所有容器后，api-1.my-project.localhost、my-project.localhost等域名都会自动解析到127.0.0.1，转发到你的Nginx容器。