Windows下VS Code中DDEV环境Git Push至GitHub失败问题排查

环境差异点 #

• 网络栈隔离：DDEV基于Docker容器运行，使用独立的网络环境，和Windows主机的代理、防火墙规则不直接共享。主机能正常访问GitHub的代理/防火墙配置，容器可能未继承。
• Git配置独立：容器内的Git是单独安装的实例，不会自动同步主机的Git凭证（如GitHub Token、SSH密钥）、代理配置等。
• 环境变量不同：容器的HTTP/HTTPS代理环境变量默认与主机不一致，导致无法通过代理访问GitHub。

排查与解决步骤 #

1. 验证容器内网络连通性 #

进入DDEV容器执行测试命令：

# 进入DDEV web容器
ddev ssh
# 测试GitHub 443端口连通性
curl -v https://github.com:443
# 测试DNS解析是否正常
ping github.com

如果curl返回连接超时，说明网络层面存在阻断；如果ping无法解析域名，先检查容器DNS配置。

2. 同步代理配置（主机使用代理时） #

如果Windows主机通过代理访问GitHub，需给容器配置相同代理：

• 临时配置（单次生效）：进入容器后执行：

  export HTTPS_PROXY=http://你的Windows局域网IP:代理端口
  export HTTP_PROXY=http://你的Windows局域网IP:代理端口
  export NO_PROXY=localhost,127.0.0.1,.ddev.site
  

  注意：必须用Windows的局域网IP（如192.168.1.100），不能用127.0.0.1（容器内的回环地址指向自身）。
• 永久配置（全局生效）：编辑DDEV全局配置文件~/.ddev/config.yaml，添加：

  web_environment:
    - HTTPS_PROXY=http://你的Windows局域网IP:代理端口
    - HTTP_PROXY=http://你的Windows局域网IP:代理端口
    - NO_PROXY=localhost,127.0.0.1,.ddev.site
  

  保存后重启DDEV：ddev restart

3. 同步Git凭证与配置 #

容器内Git无主机的GitHub访问权限，需单独配置：

• HTTPS方式：

  # 进入容器
  ddev ssh
  # 设置凭证存储助手
  git config --global credential.helper store
  # 执行一次push，输入GitHub用户名和个人访问Token（不是密码）
  git push origin main
  

  后续Git会自动保存凭证，无需重复输入。
• SSH方式：

  # 进入容器
  ddev ssh
  # 创建并配置.ssh目录权限
  mkdir -p ~/.ssh && chmod 700 ~/.ssh
  # 将Windows主机的id_rsa、id_rsa.pub内容复制到容器的~/.ssh/目录下
  # 设置密钥文件权限
  chmod 600 ~/.ssh/id_rsa && chmod 644 ~/.ssh/id_rsa.pub
  # 测试SSH连接
  ssh -T git@github.com
  

  测试成功后即可用SSH方式执行Git操作。

4. 检查防火墙与VPN规则 #

• 临时关闭Windows防火墙，测试容器内Git是否能正常push，若恢复正常，需添加允许Docker容器出站443端口的规则。
• 若使用VPN，确认VPN允许容器网络的流量通过，或切换VPN的代理模式（如从全局代理改为仅主机代理）。

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