Windows Docker Desktop运行alpine/git报SSL证书错误如何解决

零构建快速方案（无需提前拉取代码/构建镜像） #

该方案直接使用官方alpine/git镜像，完全满足无法提前克隆仓库构建镜像的前提：

• 第一步：将企业防火墙的根证书导出为PEM格式（Base64编码），后缀为.crt即可，不要导出DER二进制格式，存到Windows本地固定路径，例如C:\docker-config\corp-root.crt
• 第二步：运行容器时通过挂载传入证书，同时显式指定Git SSL配置，避免配置冲突，Windows CMD环境执行命令如下：

docker run --name repo ^
-v C:\docker-config\corp-root.crt:/etc/ssl/certs/corp-root.pem:ro ^
alpine/git ^
-c http.sslBackend=openssl ^
-c http.sslCAInfo=/etc/ssl/certs/corp-root.pem ^
clone https://github.com/docker/getting-started.git

注意：PowerShell环境下命令换行符替换为`，类Unix环境替换为\即可。命令中显式指定http.sslBackend=openssl是为了覆盖所有可能传入的schannel配置，从根源解决Unsupported SSL backend 'schannel'报错；将证书挂载到/etc/ssl/certs/路径可直接被Alpine系统和Git识别为信任证书。

如果需要长期使用，可以将上述命令封装为Doskey别名或者PowerShell函数，无需每次输入长参数。

自定义镜像方案（修正现有Dockerfile问题） #

之前编写的Dockerfile存在两个核心问题导致运行异常：一是证书复制步骤逻辑顺序不合理，且未将证书加入系统信任链；二是仅unset系统级sslBackend配置无法覆盖外部传入的schannel参数。修正后的Dockerfile如下，确保企业根证书（命名为corp-root.crt）和Dockerfile存放在同一目录：

FROM alpine:3.20

# 安装基础依赖
RUN apk add --no-cache ca-certificates git git-lfs openssh && \
    git lfs install --skip-repo

# 导入企业根证书到系统信任链
COPY corp-root.crt /usr/local/share/ca-certificates/corp-root.crt
RUN update-ca-trust && \
    # 强制系统级Git使用openssl后端，屏蔽外部schannel配置干扰
    git config --system http.sslBackend openssl

VOLUME /git
WORKDIR /git
ENTRYPOINT ["git"]
CMD ["--help"]

在Dockerfile所在目录执行构建命令生成自定义镜像：

docker build -t corp-alpine-git .

后续直接使用该自定义镜像执行Git操作即可，无需额外传入证书参数：

docker run --name repo corp-alpine-git clone https://github.com/docker/getting-started.git

避坑说明 #

• 不要将Windows宿主机的用户级Git配置文件（路径%USERPROFILE%\.gitconfig）挂载到容器的/root/.gitconfig路径，该文件内如果存在http.sslBackend = schannel配置，会覆盖容器内的系统配置，直接触发SSL后端不支持的报错
• 不要尝试修改Docker Desktop内部虚拟机的只读文件系统，该路径下的修改会在Docker重启后丢失，没有操作价值
• 若导入证书后仍报校验错误，优先检查证书格式是否为PEM编码，DER二进制格式证书无法被Alpine系统识别

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