快捷導(dǎo)航

git clone--mirror同步橋詳解

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

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

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

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

cd ~/cuda-quantum.git

# Step 1: 從 a 倉庫拉取最新內(nèi)容（包括新 tag、新分支、新提交）
# 因?yàn)楫?dāng)初 mirror 時(shí) fetch URL 仍指向 a，所以直接 fetch 即可
git fetch origin

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

原理說明：

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

$ 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，否則會(huì)把 Bitbucket 的 refs/pull-requests/* 又拉回來導(dǎo)致推送失敗。

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

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

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

# 推送所有分支和標(biāo)簽（跳過 Bitbucket 內(nèi)部保留的 refs）
git push origin 'refs/heads/*:refs/heads/*'
git push origin 'refs/tags/*:refs/tags/*'

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

情況三：只想同步新 tag，不碰已有內(nèi)容

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

cd ~/cuda-quantum.git

# 獲取 a 的所有新內(nèi)容
git fetch origin

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

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

長期維護(hù)：建一個(gè)簡單的同步腳本

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

#!/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 內(nèi)部保留的命名空間
git push origin 'refs/heads/*:refs/heads/*'
git push origin 'refs/tags/*:refs/tags/*'

echo "Done."

加 crontab 每周自動(dòng)同步：

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

關(guān)鍵命令速查

需求	命令
從 a 增量拉取	git fetch origin（在 mirror 裸倉庫中執(zhí)行）
全量推送到 b	git push --mirror
只推送分支+標(biāo)簽（安全）	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