如何从Rebus解析Docker部署的RabbitMQ端点，解决host.docker.internal解析失败问题

问题原因 #

host.docker.internal 是Docker Desktop为Windows、Mac系统默认提供的宿主机地址解析，Linux宿主机环境、WSL2未开启Docker Desktop集成的环境默认不会自动配置该解析规则，所以会出现解析失败的报错。

解决方案 #

方案1：手动添加host映射（快速适配现有配置） #

如果要保留host.docker.internal的访问方式，启动Rebus所在容器时主动添加解析规则即可：

• 单容器启动命令增加参数：

  docker run --add-host=host.docker.internal:host-gateway [你的其他启动参数] 你的Rebus镜像名
  

• 如果使用docker-compose编排，在Rebus服务的配置块下增加extra_hosts配置：

  services:
    rebus-service:
      # 其他原有配置（image、ports、volumes等）
      extra_hosts:
        - "host.docker.internal:host-gateway"
  

配置完成后原连接字符串amqp://host.docker.internal:5673可正常使用。

方案2：Docker自定义网络（更稳定，推荐同宿主机容器互访场景） #

两个容器都在同一台宿主机运行时，走Docker内部网络不需要绕宿主机端口映射，性能和稳定性更好：

1. 先创建自定义桥接网络：

   docker network create rabbitmq-shared
   

2. 启动RabbitMQ容器时加入该网络，指定容器名（后续作为访问域名）：

   docker run -d --name rabbitmq --network rabbitmq-shared -p 5673:5672 rabbitmq:3-management
   

3. 启动Rebus容器时也加入同一网络，修改Rebus的RabbitMQ连接字符串为容器名+容器内部端口：

   amqp://rabbitmq:5672
   

特殊场景排查 #

如果是WSL2环境运行Docker，需要先确认Docker Desktop设置中：

• 「General」页签的「Use the WSL 2 based engine」已开启
• 「Resources > WSL Integration」页签中你使用的WSL发行版的集成开关已打开

内容的提问来源于stack exchange，提问作者Rob Packwood