如何解决GitHub Action构建Windows Docker镜像的特权模式不支持错误

问题根源 #

你遇到的错误核心原因有两点：

1. 默认GitHub Action Runner是Linux环境，无法构建Windows容器；
2. 即便使用Windows Runner，若buildx采用默认的docker-container驱动，会强制启用privileged模式，而Windows容器不支持该模式。

解决方案 #

1. 切换到Windows-based Runner

必须使用Windows系统的Runner，因为Windows容器只能在Windows主机上构建。在工作流中指定runs-on: windows-2022（或windows-2019，需和你的基础镜像版本匹配）。

2. 用原生Docker命令替代buildx（最直接方案）

Windows Runner自带Docker环境，且默认配置为Windows容器模式，直接使用docker build和docker push即可，和本地手动构建逻辑完全一致，无需依赖buildx。

示例工作流片段：

jobs:
  build-deploy-windows-image:
    runs-on: windows-2022
    steps:
      - name: 拉取代码
        uses: actions/checkout@v4

      - name: 登录Docker仓库
        uses: docker/login-action@v3
        with:
          username: ${{ secrets.DOCKER_REGISTRY_USER }}
          password: ${{ secrets.DOCKER_REGISTRY_TOKEN }}

      - name: 构建并推送镜像
        run: |
          docker build -t your-registry/your-image:v1.0 .
          docker push your-registry/your-image:v1.0

3. 若必须使用buildx，调整驱动配置

如果一定要用buildx，需指定driver: docker（而非默认的docker-container），并关闭privileged模式：

jobs:
  build-with-buildx:
    runs-on: windows-2022
    steps:
      - name: 拉取代码
        uses: actions/checkout@v4

      - name: 登录Docker仓库
        uses: docker/login-action@v3
        with:
          username: ${{ secrets.DOCKER_REGISTRY_USER }}
          password: ${{ secrets.DOCKER_REGISTRY_TOKEN }}

      - name: 配置Docker Buildx
        uses: docker/setup-buildx-action@v3
        with:
          driver: docker
          privileged: false

      - name: 构建并推送镜像
        uses: docker/build-push-action@v5
        with:
          context: .
          push: true
          tags: your-registry/your-image:v1.0

额外注意事项 #

• 确保基础镜像的版本与Runner的Windows版本匹配：
  • windows-2022对应基础镜像tag为4.8-windowsservercore-ltsc2022
  • windows-2019对应4.8-windowsservercore-ltsc2019
    避免因系统版本不兼容导致构建失败。

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