如何配置Docker Compose使.NET Core Web API连接容器与主机多数据库

我正尝试配置Docker Compose以运行由.NET Core Web API、PostgreSQL、RabbitMQ、PgAdmin组成的多服务应用，核心难点在于API需同时连接容器内的PostgreSQL数据库，以及主机上不可迁移的Microsoft SQL Server数据库。

当前已完成的Docker Compose配置：

services:
  api:
    image: api:latest
    ports:
      - "5000:80"
    depends_on:
      - db
      - rabbitmq
    environment:
      - ASPNETCORE_ENVIRONMENT=Production

  db:
    image: postgres:latest
    environment:
      - POSTGRES_DB=data-exchange
      - POSTGRES_USER=root
      - POSTGRES_PASSWORD=password
    ports:
      - "5432:5432"
    volumes:
      - ./pgdata:/var/lib/postgresql/data

  rabbitmq:
    image: rabbitmq:3.12-management
    ports:
      - "5672:5672"
      - "15672:15672"
    environment:
      - RABBITMQ_DEFAULT_USER=guest
      - RABBITMQ_DEFAULT_PASS=guest

  pgadmin:
    image: dpage/pgadmin4:7.7
    ports:
      - "8081:80"
    environment:
      - PGADMIN_DEFAULT_EMAIL=dev@jaroslawlesniak.pl
      - PGADMIN_DEFAULT_PASSWORD=password
    depends_on:
      - db
    volumes:
      - ./pgadmin:/var/lib/pgadmin

volumes:
  pgdata:
  pgadmin:

appsettings.json中配置的MSSQL连接字符串：

"Context": "Server=host.docker.internal\\SQLEXPRESS,1433;Database=db_name;User ID=user;pwd=password;"

已排除远程连接权限等基础问题，咨询是否需通过网络配置等方式解决该问题。

解决方案 #

1. 确认host.docker.internal的可用性 #

• Windows/macOS：Docker Desktop默认支持host.docker.internal作为主机别名，但需确保Docker Desktop版本在20.10.0及以上。
• Linux：Linux环境下Docker默认不支持该别名，需在docker-compose.yml的api服务中添加额外配置：

  api:
    # 保留原有配置
    extra_hosts:
      - "host.docker.internal:host-gateway"
  

  该配置会将host.docker.internal映射到主机网关IP，实现与Windows/macOS一致的主机访问能力。

2. 验证SQL Server监听配置 #

确保SQL Server监听所有可用IP而非仅localhost：

1. 打开SQL Server配置管理器，找到SQL Server网络配置 -> MSSQLSERVER的协议，启用TCP/IP。
2. 双击TCP/IP，切换到IP地址标签页，在IPAll节点设置TCP端口为1433，确保所有IP地址的活动和已启用状态均为是。
3. 重启SQL Server服务。

3. 调整连接字符串测试 #

• 尝试去掉实例名（若SQL Server为默认实例）：

  "Context": "Server=host.docker.internal,1433;Database=db_name;User ID=user;pwd=password;"
  

• 直接使用主机实际IP替代host.docker.internal（例如主机IP为192.168.1.100）：

  "Context": "Server=192.168.1.100\\SQLEXPRESS,1433;Database=db_name;User ID=user;pwd=password;"
  

4. 测试容器内网络连通性 #

进入API容器内部，验证主机SQL Server端口的可达性：

# 进入API容器
docker exec -it <api容器名称> bash

# 用telnet测试端口（容器需预装telnet）
telnet host.docker.internal 1433

# 或用nc测试（容器需预装nc）
nc -zv host.docker.internal 1433

若连接失败，需检查主机防火墙是否允许容器所在子网访问1433端口。

5. 临时使用主机网络调试（不推荐生产环境） #

若上述方法无效，可临时将API容器加入主机网络栈：

api:
  # 保留原有配置
  network_mode: "host"

此时连接字符串可直接使用localhost：

"Context": "Server=localhost\\SQLEXPRESS,1433;Database=db_name;User ID=user;pwd=password;"

注意：该模式会导致容器直接使用主机网络，需避免端口冲突。

内容的提问来源于stack exchange，提问作者Jarosław Leśniak