如何配置Git本地镜像拉取，失败时回退GitHub或双源拉取？

由于从GitHub拉取代码速度慢，我搭建了本地镜像并通过Cron维持同步。开发机器执行了以下命令：

git clone git://server/llvm-project.git
git remote set-url --push origin git@github.com:llvm/llvm-project.git

当前配置下，推送始终指向GitHub，拉取走本地镜像。但本地服务器不可用时（如未开VPN）无法正常拉取。希望实现：

1. 检测服务器可用性（或通过本地IP判断），不可用时自动从GitHub拉取，是否需要修改上游地址再改回？能否设置次级回退？
2. 另一种方案：先从本地缓存拉取，无论成功与否再从GitHub拉取，同时解决本地服务器落后于GitHub的情况，如何实现？

一、基于服务器可用性的自动切换拉取方案 #

不需要频繁修改上游地址，通过脚本检测服务器状态，自动选择拉取源：

步骤1：配置双远程仓库 #

保留原有的origin推送地址，新增github远程用于直接拉取GitHub代码：

# 添加GitHub作为独立远程
git remote add github git@github.com:llvm/llvm-project.git
# 确认origin的拉取地址仍为本地镜像，推送地址为GitHub
git remote -v

步骤2：编写智能拉取脚本 #

创建名为git-pull-smart的脚本（可放在~/bin目录下并添加执行权限）：

#!/bin/bash

# 方案1：检测本地服务器是否可达（ping检测）
ping -c 3 -W 1 server > /dev/null 2>&1
if [ $? -eq 0 ]; then
    # 服务器可用，从本地镜像拉取
    git pull origin "$@"
else
    # 服务器不可用，切换到GitHub拉取
    git pull github "$@"
fi

如果需要通过本地IP判断（比如VPN网段），替换检测逻辑：

#!/bin/bash

# 方案2：检测本地IP是否在VPN网段（示例网段为192.168.100.0/24）
if ip addr show | grep -q "192.168.100."; then
    git pull origin "$@"
else
    git pull github "$@"
fi

步骤3：使用脚本拉取 #

给脚本添加执行权限后，直接用它代替git pull：

chmod +x git-pull-smart
mv git-pull-smart ~/bin/
# 后续拉取直接执行
git-pull-smart

二、先拉本地再拉GitHub的双源拉取方案 #

这种方案无需检测，直接依次拉取两个源，既解决服务器不可用的问题，也能同步GitHub的最新代码（处理本地镜像落后的情况）：

方式1：直接执行命令 #

配置好双远程仓库后，每次拉取时执行：

# 先尝试从本地镜像拉取，失败也继续执行
git pull origin || true
# 再从GitHub拉取确保代码最新
git pull github

方式2：配置Git别名简化操作 #

把上述命令封装成Git别名，方便一键执行：

git config --global alias.pull-all '!git pull origin || true; git pull github'

之后直接用以下命令完成双源拉取：

git pull-all

可选：给origin配置多fetch地址 #

如果希望通过git pull --all实现双源拉取，可以给origin添加两个fetch地址：

# 给origin添加GitHub的拉取地址
git remote set-url --add origin git@github.com:llvm/llvm-project.git
# 此时origin的拉取地址包含本地镜像和GitHub，推送地址仍为GitHub
git remote -v

执行git pull --all会从两个地址拉取所有分支，但需注意分支跟踪的冲突问题，适合不需要严格区分源的场景。

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