如何使用Git Annex从IPFS复制文件？克隆仓库后下载失败

克隆存储本地IPFS文件的Git仓库后，已按流程初始化IPFS特殊远程，但执行git annex copy --from ipfs命令时无任何反应，文件无法下载，Git Annex无法识别IPFS中的文件。

前置验证（原仓库正常流程） #

原仓库已完成以下配置并验证通过：

• 本地IPFS Daemon正常运行
• Git Annex及IPFS远程脚本安装完成
• 成功将文件加入Git Annex并复制到IPFS远程，git annex list显示文件存在于IPFS中（X__X ipfs-file.txt）

克隆后失败现象 #

克隆新仓库并拉取原仓库内容后：

• ipfs-file.txt为指向不存在文件的符号链接
• git annex whereis ipfs-file.txt显示(0 copies) failed
• git annex list中IPFS列无X，无法识别文件位置
• 执行git annex copy --from ipfs -d时，IPFS远程脚本未被调用

解决方案 #

1. 同步Git Annex元数据 #

克隆后的仓库仅通过git pull获取了Git基础数据，未同步Git Annex的文件存储元数据，需执行：

git annex sync ../test01

该命令会拉取原仓库中Git Annex追踪的文件位置、IPFS CID等关键元数据。

2. 启用IPFS远程关联 #

同步元数据后，需让Git Annex将当前仓库的IPFS远程配置与元数据中的存储信息关联：

git annex enableremote ipfs

3. 验证文件存储位置 #

执行以下命令确认文件已被识别在IPFS远程：

git annex whereis ipfs-file.txt
git annex list

此时git annex list的IPFS列应出现X，表示文件存在于该远程。

4. 下载文件到本地 #

执行以下命令完成文件下载：

# 指定从IPFS远程复制
git annex copy --from ipfs ipfs-file.txt
# 或让Git Annex自动选择可用远程获取
git annex get ipfs-file.txt

核心原因说明 #

• git pull仅同步Git版本库的普通文件与分支，不会同步Git Annex专属的元数据（如文件存储位置、CID映射），必须通过git annex sync完成这部分同步。
• 新仓库初始化IPFS远程后，需要enableremote命令建立远程配置与元数据的关联，否则Git Annex无法匹配IPFS中的文件。

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