如何迁移备份包含git lfs的仓库，包含代码、分支、提交记录

最新推荐文章于 2025-05-29 15:17:22 发布

原创最新推荐文章于 2025-05-29 15:17:22 发布 · 3.1k 阅读

5 ·

CC 4.0 BY-SA版权

文章标签：

#git

Linux 专栏收录该内容

21 篇文章

订阅专栏

本文详细介绍了如何将包含GitLFS的仓库从一个git服务器迁移到另一个服务器，确保所有提交记录和LFS文件对象完整无误。首先，创建目标服务器上的空仓库，然后使用`git clone --bare`备份原始仓库。接着，通过`git lfs fetch --all`获取LFS文件，`git lfs push --all`推送到新服务器，最后执行`git push --mirror`完成迁移。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

最近有个迁移仓库的需求，要把某个git服务器上的仓库转移到另一个服务器上

仅域名更新，需要保留原仓库的提交记录

普通的git仓库备份

网上查了一下实现方式非常简单：

假设源仓库的地址是：git@gitlib.threedog.top:threedog/test.git

新仓库的域名是：gitlib.threedog.net

首先，在新的git服务器上创建同名仓库test，空仓库就可以，然后：

git clone --bare git@gitlib.threedog.top:threedog/test.git
cd test.git 
git push --mirror git@gitlib.threedog.net:threedog/test.git

这样，原仓库test.git就完整备份到了新的服务器上

包含gitlfs的仓库

git lfs 是git的一种二进制文件存储机制，主要用于仓库中存在一些较大的二进制文件的场景，可以有效的缩减git仓库体积，加快克隆效率

在一些新版的git客户端，gitlab github服务器上都支持git lfs

但是包含lfs的仓库在通过上述方案备份时，会报这个错误：

remote: Resolving deltas: 100% (187/187), done.
remote: GitLab: LFS objects are missing. Ensure LFS is properly set up or try a manual "git lfs push --all".
Togit@gitlib.threedog.net:threedog/test.git
 ! [remote rejected] dev -> dev (pre-receive hook declined)
 ! [remote rejected] master -> master (pre-receive hook declined)
error: 推送一些引用到 'git@gitlib.threedog.net:threedog/test.git' 失败

这种仓库应该，先现在并提交lfs文件对象，然后再push整个仓库：

git clone --bare git@gitlib.threedog.top:threedog/test.git
cd test.git 
git lfs fetch --all
git lfs push --all git@gitlib.threedog.net:threedog/test.git
git push --mirror git@gitlib.threedog.net:threedog/test.git