You need to enable JavaScript to run this app. 无法克隆主仓库时如何批量下载GitHub release的全部.tgz文件?
优惠活动
大模型
产品
解决方案
定价
更多

无法克隆主仓库时如何批量下载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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.26 21:06:03