无法克隆主仓库时如何批量下载GitHub release的全部.tgz文件?
GitHub Release 批量下载.tgz资产的实现方案
所有方案无需克隆主仓库,直接通过GitHub公开的Release资产元数据接口获取直链,几行命令即可完成数百个文件的批量下载,全程不需要手动逐一点击。
方案1:单行命令快速下载(适配Linux/macOS/WSL环境)
前置准备:先安装两个基础工具
jq:用于解析GitHub API返回的结构化JSON数据wget/aria2c:用于实际文件下载
执行以下单行命令,替换对应的占位参数即可:
curl -s https://api.github.com/repos/[仓库所有者]/[仓库名称]/releases/tags/[目标Release标签] \ | jq -r '.assets[] | select(.name | endswith(".tgz")) | .browser_download_url' \ | wget -i -
命令逻辑拆解:
- 第一行请求目标Release的公开元数据,无需身份验证即可获取公开仓库的所有资产信息
- 第二行过滤出所有后缀为.tgz的资产,提取可直接访问的静态下载直链
- 第三行将直链列表传递给下载工具,自动逐一下载匹配的文件
如果需要更快的下载速度,可将最后一行替换为aria2的多线程下载配置:
| aria2c -x 16 -s 8 -i -
方案2:带容错逻辑的可复用脚本
如果需要应对网络波动、只下载特定名称规则的.tgz文件、跨多个Release拉取资产,可以用带断点续传、失败重试逻辑的脚本,示例如下:
#!/bin/bash # 自定义配置 REPO_OWNER="仓库所有者用户名" REPO_NAME="目标仓库名" TARGET_RELEASE_TAG="要下载的Release版本标签" FILE_KEYWORD="amd64" # 仅下载文件名包含该关键词的.tgz,无需过滤则留空 # 拉取并过滤符合要求的资产直链 DOWNLOAD_LINKS=$(curl -s -H "Accept: application/vnd.github+json" \ "https://api.github.com/repos/$REPO_OWNER/$REPO_NAME/releases/tags/$TARGET_RELEASE_TAG" \ | jq -r --arg filter "$FILE_KEYWORD" '.assets[] | select(.name | endswith(".tgz")) | select($filter == "" or (.name | contains($filter))) | .browser_download_url') # 带断点续传、重试逻辑的下载流程 for link in $DOWNLOAD_LINKS; do wget -c --tries=3 --timeout=30 "$link" done
脚本优势:
- 自带断点续传,中断后重新运行脚本不会重复下载已完成的文件
- 支持关键词过滤,不用下载Release中全部的.tgz文件
- 内置重试和超时配置,避免临时网络异常导致文件漏下
常见问题说明
- 遇到API请求403限流:未登录状态下GitHub API对单IP的限额是每小时60次,当需要跨多个Release批量拉取时,可以在curl请求头中添加自己的GitHub个人访问令牌,将限额提升至每小时5000次,足以支撑大规模批量下载
- 为什么不能用克隆仓库的方式获取:Release资产是静态托管在GitHub CDN上的独立资源,和主仓库的Git版本历史完全分离,本身就不会包含在Git仓库的克隆内容里,这套接口方案是官方提供的合规获取方式
- 私有仓库的支持:只要给配置的访问令牌开放对应私有仓库的读取权限,同样可以用这套方案批量下载私有Release的.tgz资产
内容的提问来源于stack exchange,提问作者Yurroffian
相关产品推荐
相关产品推荐

