本地与Docker开发中服务间自动IP解析方案咨询

我们有两个后端服务：backend_for_frontend（以下简称BFF）需要从api服务拉取数据，不同运行场景下BFF需要使用不同的API连接地址：

• 两者均运行在Docker中，或api在Docker内、BFF在本地：使用http://host.docker.internal:3001/api
• 两者均运行在本地（非Docker环境）：使用http://127.0.0.1:3001/api

切换api运行环境时，必须手动修改BFF的连接地址，无法自动适配。下面是几种无需手动修改的解决方案：

方案1：启动时自动探测可用地址 #

在BFF的启动脚本中加入探测逻辑，自动检测并选择可用的API地址，无需手动配置。

以Shell脚本为例（可根据BFF开发语言调整，比如Node.js/Go的代码实现）：

# 定义健康检查接口（需确保api提供可访问的健康检查端点）
HEALTH_CHECK_PATH="/api/health"

# 依次尝试三种可能的地址，优先选择可连通的
if curl -s "http://127.0.0.1:3001$HEALTH_CHECK_PATH" > /dev/null; then
  export API_BASE_URL="http://127.0.0.1:3001/api"
elif curl -s "http://host.docker.internal:3001$HEALTH_CHECK_PATH" > /dev/null; then
  export API_BASE_URL="http://host.docker.internal:3001/api"
elif curl -s "http://api:3001$HEALTH_CHECK_PATH" > /dev/null; then
  export API_BASE_URL="http://api:3001/api"
fi

# 启动BFF应用
exec node app.js

原理：启动时通过curl尝试连接不同地址的健康检查接口，自动设置对应的环境变量，BFF代码中直接读取API_BASE_URL即可。

方案2：多环境配置文件+环境变量 #

创建不同场景的配置文件，启动时指定对应文件即可，避免手动修改代码。

1. 创建三个.env配置文件：

   • .env.local（本地双服务）：

     API_BASE_URL=http://127.0.0.1:3001/api
     

   • .env.docker-local（Docker运行api、本地运行BFF）：

     API_BASE_URL=http://host.docker.internal:3001/api
     

   • .env.docker（Docker运行双服务）：

     API_BASE_URL=http://api:3001/api
     

2. 启动时加载对应配置：

   • 本地启动BFF：node app.js --env .env.local（具体加载方式根据框架调整，比如Node.js的dotenv库）
   • Docker中启动BFF，修改docker-compose.yml：

     services:
       api:
         ports:
           - 3001:3001
     
       backend_for_frontend:
         ports:
           - 3002:3002
         env_file:
           - .env.docker
     

方案3：统一域名解析（进阶） #

通过本地hosts映射+Docker DNS，让BFF统一使用api:3001/api作为连接地址，自动适配不同环境：

1. 修改本地hosts文件（Windows：C:\Windows\System32\drivers\etc\hosts；Linux/macOS：/etc/hosts），添加：

   127.0.0.1 api
   

   若api运行在Docker、BFF在本地，可额外添加：

   host.docker.internal api
   

2. BFF代码中统一使用http://api:3001/api作为连接地址：

   • 双服务本地运行：hosts解析api到127.0.0.1
   • 双服务Docker运行：Docker Compose的默认网络中，服务名api可直接解析到对应容器IP
   • api在Docker、BFF在本地：hosts解析api到host.docker.internal，进而访问Docker内的api

注意：该方法需要维护hosts文件，适合长期固定环境的场景。

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