GitHub 是全球最大的代码托管平台,许多软件资源都可以在该网站上取得。有些人如笔者就喜欢除了把程序源代码上传到 GitHub 外,也把已经编译好的二进制文件一并上传到 GitHub 替每个仓库(Repository)所提供的「Release」区,这样一来不想自行编译源代码的用户就可以直接到「Release」区中找到对应平台已经编译好的二进制文件来直接下载使用。

以 Flameshot 这个开源的跨平台屏幕截屏软件为例,其 GitHub 仓库网址如下:

我们可以在其 Release 区下,找到各个版本官方已经编译好的二进制文件和重新打包过的源代码项目。如下图:

flameshot 在 GitHub Release 的文件清单

其中,flameshot-12.1.0-1.ubuntu-22.04.amd64.deb 就是给 Ubuntu 的 DEB 安装包,我们可以将其下载下来,就能在 Ubuntu 上安装使用。

然而每次都要用网页浏览器打开 GitHub 来找到这个页面来载最新版的文件好像也挺麻烦的,在懒惰虫的驱使下,就必须要想个方式能够直接在 Linux 环境下,以指令的方式下载到 GitHub 仓库上最新发布出来的文件。

GitHub 提供的 /releases/latest HTTP API

GitHub 有提供许多方便的 HTTP API,其中的 /releases/latest 可以协助我们做到这件事。HTTP 请求的网址格式如下:

GET https://api.github.com/repos/<user>/<repo>/releases/latest

以刚才提到的 Flameshot 为例,就是:

GET https://api.github.com/repos/flameshot-org/flameshot/releases/latest

这支 API 的回传值大概如以下这样(已删减冗长消息):

{
    "url": "https://api.github.com/repos/flameshot-org/flameshot/releases/71146895",
    "assets_url": "https://api.github.com/repos/flameshot-org/flameshot/releases/71146895/assets",
    "upload_url": "https://uploads.github.com/repos/flameshot-org/flameshot/releases/71146895/assets{?name,label}",
    "html_url": "https://github.com/flameshot-org/flameshot/releases/tag/v12.1.0",
    "id": 71146895,
    "author": {
        "login": "borgmanJeremy",
        "id": 46930769,
        "node_id": "MDQ6VXNlcjQ2OTMwNzY5",
        "avatar_url": "https://avatars.githubusercontent.com/u/46930769?v=4",
        "gravatar_id": "",
        "url": "https://api.github.com/users/borgmanJeremy",
        "html_url": "https://github.com/borgmanJeremy",
        "followers_url": "https://api.github.com/users/borgmanJeremy/followers",
        "following_url": "https://api.github.com/users/borgmanJeremy/following{/other_user}",
        "gists_url": "https://api.github.com/users/borgmanJeremy/gists{/gist_id}",
        "starred_url": "https://api.github.com/users/borgmanJeremy/starred{/owner}{/repo}",
        "subscriptions_url": "https://api.github.com/users/borgmanJeremy/subscriptions",
        "organizations_url": "https://api.github.com/users/borgmanJeremy/orgs",
        "repos_url": "https://api.github.com/users/borgmanJeremy/repos",
        "events_url": "https://api.github.com/users/borgmanJeremy/events{/privacy}",
        "received_events_url": "https://api.github.com/users/borgmanJeremy/received_events",
        "type": "User",
        "site_admin": false
    },
    "node_id": "RE_kwDOBWsOdM4EPZ2P",
    "tag_name": "v12.1.0",
    "target_commitish": "master",
    "name": "v12.1.0",
    "draft": false,
    "prerelease": false,
    "created_at": "2022-07-03T13:42:21Z",
    "published_at": "2022-07-03T18:03:55Z",
    "assets": [
        {
            "url": "https://api.github.com/repos/flameshot-org/flameshot/releases/assets/70446299",
            "id": 70446299,
            "node_id": "RA_kwDOBWsOdM4EMuzb",
            "name": "flameshot-12.1.0-1-lp15.2.x86_64.rpm",
            "label": null,
            "uploader": {
                "login": "borgmanJeremy",
                "id": 46930769,
                "node_id": "MDQ6VXNlcjQ2OTMwNzY5",
                "avatar_url": "https://avatars.githubusercontent.com/u/46930769?v=4",
                "gravatar_id": "",
                "url": "https://api.github.com/users/borgmanJeremy",
                "html_url": "https://github.com/borgmanJeremy",
                "followers_url": "https://api.github.com/users/borgmanJeremy/followers",
                "following_url": "https://api.github.com/users/borgmanJeremy/following{/other_user}",
                "gists_url": "https://api.github.com/users/borgmanJeremy/gists{/gist_id}",
                "starred_url": "https://api.github.com/users/borgmanJeremy/starred{/owner}{/repo}",
                "subscriptions_url": "https://api.github.com/users/borgmanJeremy/subscriptions",
                "organizations_url": "https://api.github.com/users/borgmanJeremy/orgs",
                "repos_url": "https://api.github.com/users/borgmanJeremy/repos",
                "events_url": "https://api.github.com/users/borgmanJeremy/events{/privacy}",
                "received_events_url": "https://api.github.com/users/borgmanJeremy/received_events",
                "type": "User",
                "site_admin": false
            },
            "content_type": "application/x-rpm",
            "state": "uploaded",
            "size": 10698252,
            "download_count": 33235,
            "created_at": "2022-07-03T18:02:23Z",
            "updated_at": "2022-07-03T18:02:25Z",
            "browser_download_url": "https://github.com/flameshot-org/flameshot/releases/download/v12.1.0/flameshot-12.1.0-1-lp15.2.x86_64.rpm"
        },
        {
            "url": "https://api.github.com/repos/flameshot-org/flameshot/releases/assets/70446300",
            "id": 70446300,
            "node_id": "RA_kwDOBWsOdM4EMuzc",
            "name": "flameshot-12.1.0-1-lp15.2.x86_64.rpm.sha256sum",
            "label": null,
            "uploader": {
                "login": "borgmanJeremy",
                "id": 46930769,
                "node_id": "MDQ6VXNlcjQ2OTMwNzY5",
                "avatar_url": "https://avatars.githubusercontent.com/u/46930769?v=4",
                "gravatar_id": "",
                "url": "https://api.github.com/users/borgmanJeremy",
                "html_url": "https://github.com/borgmanJeremy",
                "followers_url": "https://api.github.com/users/borgmanJeremy/followers",
                "following_url": "https://api.github.com/users/borgmanJeremy/following{/other_user}",
                "gists_url": "https://api.github.com/users/borgmanJeremy/gists{/gist_id}",
                "starred_url": "https://api.github.com/users/borgmanJeremy/starred{/owner}{/repo}",
                "subscriptions_url": "https://api.github.com/users/borgmanJeremy/subscriptions",
                "organizations_url": "https://api.github.com/users/borgmanJeremy/orgs",
                "repos_url": "https://api.github.com/users/borgmanJeremy/repos",
                "events_url": "https://api.github.com/users/borgmanJeremy/events{/privacy}",
                "received_events_url": "https://api.github.com/users/borgmanJeremy/received_events",
                "type": "User",
                "site_admin": false
            },
            "content_type": "application/octet-stream",
            "state": "uploaded",
            "size": 147,
            "download_count": 2173,
            "created_at": "2022-07-03T18:02:25Z",
            "updated_at": "2022-07-03T18:02:25Z",
            "browser_download_url": "https://github.com/flameshot-org/flameshot/releases/download/v12.1.0/flameshot-12.1.0-1-lp15.2.x86_64.rpm.sha256sum"
        }
    ],
    "tarball_url": "https://api.github.com/repos/flameshot-org/flameshot/tarball/v12.1.0",
    "zipball_url": "https://api.github.com/repos/flameshot-org/flameshot/zipball/v12.1.0"
}

其中,tarball_url 和 zipball_url 字段是 GitHub 替每个 Release 主动提供的快照下载网址,而 assets 字段是 GitHub 仓库的拥有者自行在创建 Release 时所额外加入的文件。assets 字段中的每个文件的 browser_download_url 字段,正是该文件的下载网址。

curl 指令

我们可以利用 Linux 发行版中常会内置的 curl 指令来调用 GitHub 提供的这支 API。如果环境中没有安装 curl 的话,基于 Debian 的 Linux 发行版可以使用以下指令来安装:

sudo apt install curl

红帽系的 Linux 发行版则可以使用以下指令来安装 curl:

sudo dnf install curl

curl 指令的使用方式如下:

curl -fsS https://api.github.com/repos/flameshot-org/flameshot/releases/latest

curl 指令的 -f 参数可以让 curl 指令在遇到 HTTP 错误时不继续取得主体(body);-s 参数可以让 curl 指令只输出 URL 资源的主体(body)数据;-S 参数可以在使用 -s 参数时依然输出错误消息到标准错误(stderr)中。

以 curl 取得最新 Release 的 JSON

sed 指令

接着我们可以利用 Linux 操作系统中内置的 sed 指令来处理 curl 指令调用 GitHub 的 API 所回传的 JSON 数据。

例如要抓取 browser_download_url 字段中的网址,sed 指令可以这样写:

sed -r -n 's/.*"browser_download_url": *"(.*)".*/\1/p'

sed 指令的 -r 参数可以让 \1 发挥作用(也就是正则表达式的群组功能);-n 参数可以让输出结果只保留 /p 要输出的部份(此处就是 \1)。

结合 curl 指令,写法如下:

curl -fsS https://api.github.com/repos/flameshot-org/flameshot/releases/latest | sed -r -n 's/.*"browser_download_url": *"(.*)".*/\1/p'

以 sed 取出所有下载网址

如上图,由于每个 Release 中可能会有超过一个的额外文件,因此我们必须要确保这些网址所链接到的文件资源都是我们需要下载的,不然就得继续再过滤。这部份可以再使用 grep 指令来达成,或者我们也可以修改刚才写好的 sed 指令,在 (.*) 内加入更严苛的条件,例如:

curl -fsS https://api.github.com/repos/flameshot-org/flameshot/releases/latest | sed -r -n 's/.*"browser_download_url": *"(.*\.ubuntu-22\.04\.amd64\.deb)".*/\1/p'

筛选出 Ubuntu 22.04 的下载网址

如上图,只剩下一个网址了!

再次使用 curl 指令

有了单独的下载网址就很容易了,利用 Shell 的命令替换(Command Substitution)语法,将前面的 curl 和 sed 指令找出的网址变成参数传给 curl 指令使用,让 curl 去下载这个网址的资源。

结合后指令写法如下:

curl -fL "$(curl -fsS https://api.github.com/repos/flameshot-org/flameshot/releases/latest | sed -r -n 's/.*"browser_download_url": *"(.*\.ubuntu-22\.04\.amd64\.deb)".*/\1/p')" -O

curl 指令的 -L 参数可以让 curl 允许转址;-O 参数可以将网址资源保存成文件,并自动取文件名。

如此一来就能用一行指令把 GitHub 仓库上最新发布的文件给下载下来了!

以一行指令下载最新发布的文件

如果我们不想让 curl 自动取文件名,可以将指令中的 -O 参数替换成 -o 参数,并接上文件路径,例如:

curl -fL "$(curl -fsS https://api.github.com/repos/flameshot-org/flameshot/releases/latest | sed -r -n 's/.*"browser_download_url": *"(.*\.ubuntu-22\.04\.amd64\.deb)".*/\1/p')" -o flameshot.deb