Docker容器与本地通信：单URL/IP实现API访问的配置难题

方案1：代码层面场景区分（零额外配置） #

保留单个URL_SERVER_API环境变量，设为外部客户端可访问的地址（比如http://localhost:8080）。在PHP代码中针对两种使用场景做差异化处理：

• 生成HTML输出时，直接使用原变量值
• 内部CURL调用时，自动替换域名部分为Docker内部的API容器服务名

示例实现：

function buildApiUrl(string $path, bool $isInternalCall = false): string {
    $baseUrl = getenv('URL_SERVER_API');
    if ($isInternalCall) {
        // 替换外部域名/端口为Docker内部API容器地址
        $baseUrl = preg_replace('/https?:\/\/[^\/]+/', 'http://api_docker:8080', $baseUrl);
    }
    return rtrim($baseUrl, '/') . '/' . ltrim($path, '/');
}

// 生成前端HTML链接
$frontendUrl = buildApiUrl('someendpoint'); // 输出 http://localhost:8080/someendpoint

// 内部CURL调用
$curlUrl = buildApiUrl('someendpoint', true); // 输出 http://api_docker:8080/someendpoint

你可以根据实际情况调整替换逻辑，比如固定内部API地址，而不是正则替换。这种方案无需修改Docker配置，仅通过少量代码适配即可解决问题。

方案2：Docker Hosts映射（无代码修改） #

通过配置主应用容器的hosts，让容器内的localhost指向API容器的内部网络地址，这样URL_SERVER_API设为http://localhost:8080时，既能被外部客户端正常解析，也能让容器内的CURL请求路由到正确的API容器。

docker-compose配置示例： #

services:
  web_app:
    image: your-web-app-image
    extra_hosts:
      - "localhost:api_docker" # api_docker是你的API容器服务名
    networks:
      - your-bridge-network
  api_docker:
    image: your-api-image
    networks:
      - your-bridge-network

networks:
  your-bridge-network:
    driver: bridge

手动启动容器时： #

docker run --add-host=localhost:api_docker --network=your-bridge-network your-web-app-image

注意：如果API容器的内部端口不是8080，需要同步调整URL_SERVER_API的端口值。此方案完全无需修改代码，仅通过Docker配置解决环境差异问题。

方案3：主应用容器内置反向代理（统一请求入口） #

在主应用容器中部署轻量反向代理（如Nginx），将所有API路径的请求转发到内部API容器。此时URL_SERVER_API设为主应用的外部访问地址（比如http://localhost:8081/api），外部客户端和内部CURL请求都通过这个地址访问API，由反向代理做路由转发。

示例Nginx配置： #

server {
    listen 80;

    # 转发主应用PHP请求到PHP-FPM
    location / {
        proxy_pass http://localhost:9000;
        proxy_set_header Host $host;
    }

    # 转发API请求到内部API容器
    location /api/ {
        proxy_pass http://api_docker:8080/;
        proxy_set_header Host $host;
    }
}

此时URL_SERVER_API设为http://localhost:8081/api：

• 外部用户访问http://localhost:8081/api/someendpoint时，Nginx会转发到api_docker:8080/someendpoint
• 容器内CURL调用http://localhost/api/someendpoint时，同样会被Nginx转发到API容器

这种方案适合需要统一API入口、且希望完全隔离内部网络细节的场景。

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