Git克隆私有仓库最优方案：含端口封禁、多代理环境及Python脚本实现

22端口被封禁时的处理方案 #

• 切换为HTTPS协议操作：将原有SSH格式的仓库地址替换为HTTPS格式，例如git@github.com:user/repo.git替换为https://github.com/user/repo.git，推送时使用托管平台生成的个人访问令牌（PAT）替代密码，可配置Git凭据存储实现免密操作。
• 改用443端口走SSH协议：如果必须使用SSH密钥验证，可修改SSH配置文件（通常为~/.ssh/config）添加如下规则，适配多数Git托管平台的SSH over 443能力：

Host github.com
  Hostname ssh.github.com
  Port 443
  User git
  IdentityFile ~/.ssh/你的私钥路径

配置完成后执行ssh -T git@github.com验证连通性即可。

有/无代理环境切换的处理方案 #

• 全局代理配置：长期固定代理环境下可配置全局生效的Git代理，示例命令如下：
  • HTTP/HTTPS代理：git config --global http.proxy http://127.0.0.1:7890
  • SOCKS5代理：git config --global http.proxy socks5://127.0.0.1:1080
  • 取消全局代理：git config --global --unset http.proxy
• 单仓库专属代理：仅需要给指定仓库配置代理时，进入仓库目录执行去掉--global参数的上述配置命令即可，不会影响其他仓库的网络设置。
• 按域名自动匹配代理：需要频繁切换内外网仓库的场景，可直接修改全局.gitconfig文件，按域名配置不同的代理规则，无需手动切换：

[http "https://github.com"]
  proxy = socks5://127.0.0.1:1080
[http "https://gitee.com"]
  proxy = ""

根据场景不同可选择两种实现方式，优先级从高到低如下：

• 优先使用GitPython第三方库：该库是Git命令的完整Python封装，内置完善的异常处理、操作接口，无需自行拼接命令行，稳定性更高。
  1. 安装命令：pip install gitpython
  2. 克隆示例代码：

import git

# 基础克隆用法
repo = git.Repo.clone_from(
    url="https://github.com/user/repo.git",
    to_path="./local_repo",
    # 可选配置：指定代理
    env={"HTTP_PROXY": "http://127.0.0.1:7890", "HTTPS_PROXY": "http://127.0.0.1:7890"},
    # 可选配置：浅克隆，仅拉取最近1次提交，大幅提升克隆速度
    depth=1
)
# 后续可直接通过repo对象执行pull、push、分支切换等全量Git操作

• 无第三方依赖场景用标准库subprocess：如果项目不允许安装额外依赖，可直接调用系统预装的Git命令，自行处理返回结果和异常即可：

import subprocess
import os

def git_clone(repo_url: str, local_path: str, proxy: str = None) -> tuple[bool, str]:
    env = os.environ.copy()
    if proxy:
        env["HTTP_PROXY"] = proxy
        env["HTTPS_PROXY"] = proxy
    try:
        subprocess.run(
            ["git", "clone", repo_url, local_path],
            env=env,
            check=True,
            capture_output=True,
            text=True
        )
        return True, "克隆成功"
    except subprocess.CalledProcessError as e:
        return False, f"克隆失败：{e.stderr}"

内容的提问来源于stack exchange，提问作者T M Suhas