git clone--mirror同步橋詳解

更新時間：2026年05月19日 08:34:52 作者：Eloudy

該文章主要了Git倉庫同步的幾種情況,包括保留mirror裸倉庫、已刪除裸倉庫以及只想同步新tag等場景,通過創(chuàng)建裸倉庫、fetch分支/標簽等方式實現(xiàn)代價較低的增量同步,并在需要時寫了長期自動同步的建議

情況一：之前的 mirror 裸倉庫還在

如果你之前的 cuda-quantum.git（mirror 裸倉庫）目錄還保留著，兩步搞定：

cd ~/cuda-quantum.git

# Step 1: 從 a 倉庫拉取最新內容（包括新 tag、新分支、新提交）
# 因為當初 mirror 時 fetch URL 仍指向 a，所以直接 fetch 即可
git fetch origin

# Step 2: 推送到 b 倉庫（push URL 已指向 b）
git push --mirror

原理說明：

git clone --mirror https://a.git 創(chuàng)建的裸倉庫有兩個隱含配置：

$ git config --get remote.origin.url          # fetch URL → 仍是 a
https://a.git

$ git config --get remote.origin.pushurl      # push URL → 你改成了 b
ssh://b.git

$ git config --get remote.origin.mirror       # mirror 模式開啟
true

所以 git fetch origin 從 a 拉取，git push --mirror 往 b 推送，天然就是增量同步。

情況二：mirror 裸倉庫已被刪除

如果之前的裸倉庫已經(jīng)刪了，不要重新 clone --mirror，否則會把 Bitbucket 的 refs/pull-requests/* 又拉回來導致推送失敗。

正確做法是創(chuàng)建一個新的裸倉庫，只 fetch 分支和標簽：

# 創(chuàng)建新的裸倉庫
git clone --bare https://a.git project.git
cd project.git

# 配置推送到 b
git remote set-url --push origin ssh://b.git

# 推送所有分支和標簽（跳過 Bitbucket 內部保留的 refs）
git push origin 'refs/heads/*:refs/heads/*'
git push origin 'refs/tags/*:refs/tags/*'

如果之前的裸倉庫已經(jīng)推送成功過一次，現(xiàn)在只剩增量問題，推薦用情況一保留裸倉庫作為長期同步橋。

情況三：只想同步新 tag，不碰已有內容

如果 b 倉庫已經(jīng)有大部分內容，只想把 a 的新 tag 同步過去：

cd ~/cuda-quantum.git

# 獲取 a 的所有新內容
git fetch origin

# 只推送新 tag
git push origin --tags

# 或：推送所有分支（只推送 b 上沒有的）
git push origin 'refs/heads/*:refs/heads/*'

長期維護：建一個簡單的同步腳本

如果 a 和 b 兩個倉庫需要長期保持同步，建議保留那個 mirror 裸倉庫，并寫一個定時腳本：

#!/bin/bash
# ~/sync-mirror.sh

REPO_DIR="$HOME/cuda-quantum.git"
cd "$REPO_DIR" || exit 1

echo "Fetching from source (a)..."
git fetch origin

echo "Pushing to mirror (b)..."
# 排除 Bitbucket 內部保留的命名空間
git push origin 'refs/heads/*:refs/heads/*'
git push origin 'refs/tags/*:refs/tags/*'

echo "Done."

加 crontab 每周自動同步：

crontab -e
# 添加
0 2 * * 1 /home/eili/sync-mirror.sh >> /home/eili/sync-mirror.log 2>&1

關鍵命令速查

需求	命令
從 a 增量拉取	git fetch origin（在 mirror 裸倉庫中執(zhí)行）
全量推送到 b	git push --mirror
只推送分支+標簽（安全）	git push origin 'refs/heads/:refs/heads/' && git push origin --tags
查看 fetch/push URL	git remote -v
查看新 tag	git ls-remote --tags origin \| tail -20