无网络环境下如何通过本地镜像完成Repo同步？

核心问题原因 #

你之前用--reference初始化第二个仓库时，依然指定了远程GitLab的manifest URL，导致repo sync会先尝试联网拉取最新的manifest文件，同时部分仓库的远程配置仍指向GitLab，所以断网后会失败。要实现纯本地拉取，必须让Repo完全依赖本地镜像的manifest和仓库资源。

正确操作步骤 #

1. 确保本地镜像完整创建

先确认你的本地裸镜像已经同步所有内容：

# 进入镜像目录
cd /path/to/local-mirror
# 重新同步确保所有仓库和manifest拉取完整
repo sync

该镜像目录下会包含所有项目的裸仓库，以及manifest仓库的裸镜像（通常命名为manifests.git）。

2. 初始化本地工作仓库时指向本地manifest

不要用远程GitLab的URL，直接指向本地镜像里的manifest裸仓库路径：

# 创建并进入新的工作仓库目录
mkdir /path/to/local-workspace && cd /path/to/local-workspace
# 用本地manifest镜像初始化，同时指定参考本地镜像仓库
repo init -u /path/to/local-mirror/manifests.git -b <目标分支名> --reference /path/to/local-mirror

这里-u参数必须是本地manifest裸仓库的路径，让Repo直接从本地读取manifest，不再发起远程请求。

3. 断网环境下执行本地同步

初始化完成后，断网状态下同步时加上--no-network选项，强制Repo仅使用本地资源：

repo sync --no-network

这个选项会跳过所有网络请求，完全依赖本地镜像和已有的仓库内容完成同步。

额外注意事项 #

• 若需更新本地镜像，联网时进入镜像目录执行repo sync即可，之后本地工作仓库通过repo sync --no-network就能获取最新的本地镜像内容。
• 确保--reference指向本地镜像的根目录，这样所有项目仓库都会参考该目录下的裸仓库，避免重复拉取内容。

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