ljwx-health/backup_docs_20260104_182653/CONTAINER_PROXY_FIX.md

容器构建代理修复说明

问题

Maven 在容器内部构建时无法下载依赖：

Remote host terminated the handshake
Could not transfer artifact from aliyunmaven

根本原因

构建脚本传递的代理地址 http://127.0.0.1:7890 在容器内部指向容器自己，而不是宿主机。

解决方案

1. 修改代理地址

使用 host.docker.internal 替代 127.0.0.1：

# 宿主机代理地址（容器外）
HTTP_PROXY=http://127.0.0.1:7890

# 容器内代理地址
HTTP_PROXY=http://host.docker.internal:7890

2. Dockerfile 配置

在 ljwx-boot/ljwx-boot-admin/Dockerfile.prod 中：

# 接收代理参数
ARG HTTP_PROXY
ARG HTTPS_PROXY

# 配置 Maven settings.xml 包含代理设置
RUN if [ -n "$HTTP_PROXY" ]; then \
        PROXY_HOST=$(echo $HTTP_PROXY | sed -E 's|https?://([^:]+):.*|\1|'); \
        PROXY_PORT=$(echo $HTTP_PROXY | sed -E 's|https?://[^:]+:([0-9]+).*|\1|'); \
        # 添加代理配置到 settings.xml
    fi

3. 构建脚本修改

在 build-and-push.sh 中：

# 容器内部代理地址
local container_http_proxy="http://host.docker.internal:${PROXY_PORT}"
local container_https_proxy="http://host.docker.internal:${PROXY_PORT}"

# 传递给 Docker 构建
docker build \
  --build-arg HTTP_PROXY=$container_http_proxy \
  --build-arg HTTPS_PROXY=$container_https_proxy \
  ...

验证

构建时会显示代理配置：

./build-and-push.sh boot

# 输出：
📡 容器代理配置: http://host.docker.internal:7890

Maven settings.xml 会包含：

<proxies>
  <proxy>
    <id>proxy</id>
    <active>true</active>
    <protocol>http</protocol>
    <host>host.docker.internal</host>
    <port>7890</port>
    <nonProxyHosts>localhost|127.0.0.1|*.local</nonProxyHosts>
  </proxy>
</proxies>

工作原理

┌─────────────────┐
│  宿主机 Mac     │
│                 │
│  ClashX/V2Ray   │
│  :7890          │
└────────▲────────┘
         │
         │ host.docker.internal
         │
┌────────┴────────┐
│  Docker 容器    │
│                 │
│  Maven 构建     │
│  ├─ HTTP_PROXY  │
│  └─ settings.xml│
└─────────────────┘

1. 代理服务在宿主机监听 7890 端口
2. Docker 容器通过 host.docker.internal 访问宿主机
3. Maven 使用代理下载依赖到阿里云镜像

适用范围

此修复适用于所有需要在容器内部访问网络的构建：

• ✅ Maven 依赖下载
• ✅ NPM 包下载
• ✅ pip 包下载
• ✅ Go modules 下载
• ✅ apt-get/apk 软件包安装

测试

# 1. 确保代理运行
lsof -i :7890

# 2. 构建镜像
./build-and-push.sh boot

# 3. 检查 Maven 下载日志
# 应该看到通过代理成功下载依赖

---

日期: 2025-11-26 状态: ✅ 已修复