如何配置docker/build-push-action@v2的network=host解决构建网络问题

核心问题定位 #

你遇到的问题大概率是配置项放置位置错误：allow: network.host,security.insecure需要在docker/setup-buildx-action中配置，而非直接放在docker/build-push-action里。此外，buildx默认的docker-container驱动对host网络的支持有限，需要调整驱动配置。

正确配置示例 #

以下是完整的Github Actions工作流片段，包含正确的host网络启用配置：

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v4

      - name: Set up Docker Buildx
        uses: docker/setup-buildx-action@v2
        with:
          driver-opts: |
            network=host
          allow: |
            network.host
            security.insecure

      - name: Login to Docker Registry
        uses: docker/login-action@v3
        with:
          registry: your-registry-url
          username: ${{ secrets.DOCKER_USERNAME }}
          password: ${{ secrets.DOCKER_PASSWORD }}

      - name: Build and push
        uses: docker/build-push-action@v4
        with:
          context: .
          push: true
          tags: your-registry-url/your-image:latest
          network: host

关键配置说明 #

• docker/setup-buildx-action：
  • driver-opts: network=host：指定buildx builder使用host网络
  • allow：明确授予buildx使用host网络和不安全操作的权限，这一步是让buildx允许host网络的核心配置
• docker/build-push-action：
  • network: host：指定构建过程中使用host网络，确保RUN apk/apt/yum update步骤走host网络

额外排查步骤 #

1. 验证runner环境的网络可用性：在构建步骤前添加测试命令，确认host网络在runner中能正常使用：

   - name: Test host network connectivity
     run: docker run --network=host alpine apk update -v
   

2. 若使用GitHub托管runner，部分网络限制可能导致host网络无法正常访问外部源，可尝试切换为自托管runner，避免GitHub的网络隔离限制
3. 检查Dockerfile中的更新源：如果host网络正常但仍卡住，可能是镜像默认源的问题，可在Dockerfile中替换为国内源（比如Alpine换阿里云源）作为备选方案

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