如何使用命令行从私有github存储库中下载单个原始文件？

在CI服务器上，我想获取一个在Github上维护的配置文件，以便可以在许多作业之间共享它。我正在尝试通过curl获取此文件，但是这些方法都失败了（我得到了404）：

# As advised by the oAuth docs
curl -H 'Authorization: token the_token' -L -o setup.sh https://raw.github.com/org/repo/file

# The url of the raw file after clicking to view it
curl -L https://raw.github.com/org/repo/file?login=username&token=the_token 

先前的答案不起作用（或不再起作用）。

您可以使用V3 API获取这样的原始文件（您需要OAuth令牌）：

curl -H 'Authorization: token INSERTACCESSTOKENHERE' \
  -H 'Accept: application/vnd.github.v3.raw' \
  -O \
  -L https://api.github.com/repos/owner/repo/contents/path

所有这些必须合而为一。该-O选项将文件保存在当前目录中。您可以-o filename用来指定其他文件名。

要获取OAuth令牌，请按照此处的说明进行操作：

• https://help.github.com/articles/creating-an-access-token-for-command-line-use

我也将其写成要点：

• https://gist.github.com/madrobby/9476733

编辑：解决方案的API参考如下：

• https://developer.github.com/v3/#authentication
• https://developer.github.com/v3/media/#request-specific-version
• https://developer.github.com/v3/repos/contents/#get-contents

另外，您可以使用github“个人访问令牌”（https://github.com/settings/tokens）：

TOKEN=...
curl -s https://$TOKEN@raw.githubusercontent.com/<user or organization>/<repo name>/<branch>/<path to file>/<file_name>

例：

$ curl -s https://1bacnotmyrealtoken123beefbea@raw.githubusercontent.com/concourse/concourse/master/README.md
....

我知道这是一个古老的问题，但是以上提出的解决方案都不适合我。此后，API可能已更改。

这工作：

curl -H 'Authorization: token [insert your token here]' -o output.txt https://raw.githubusercontent.com/[organization]/[repo]/[branch]/[path to file]

或者，如果您没有令牌：

curl --user [your_user] 'https://raw.github.com/path/to/file.config' > file.config

我花了几分钟的时间为此苦苦挣扎，直到我意识到所需要的只是将URL括在引号中以逃避＆符。

curl "https://raw.github.com/org/repo/file?login=username&token=the_token"

在我的私人回购中对我有用。

将该URL重定向到Amazon S3时，我遇到了身份验证错误：

仅允许一种身份验证机制；仅X-Amz-Algorithm查询参数...

从Authorization: token X标题更改为?access_token=<token>查询参数对我有用。

只是接受的答案的补充，如果您使用的是Github Enterprise网址，则略有不同：

curl -H 'Authorization: token [your token]' \
-H 'Accept: application/vnd.github.v3.raw' \
-L https://[your domain]/api/v3/repos/[owner]/[repo-name]/contents/[path of file]

1. 在浏览器中打开您的github存储库：单击文件
2. 在浏览器中打开开发人员工具：选择“网络”选项卡
3. 在浏览器github中：单击下载按钮
4. 关闭弹出窗口
5. 在浏览器开发工具中：右键单击具有以下内容的列表 file_name?token=ABAHQCAT6KG...

6. 选择复制->复制链接地址

   网址的格式为：

   https://raw.githubusercontent.com/<USERNAME>/<PATH>/<FILENAME>?token=ABAHQCAT6KGHYHMG2SLCDT243PH4I

7. 在终端：

   wget -O myFilename https://raw.githubusercontent.com/<USERNAME>/<PATH>/<FILENAME>?token=ABAHQCAT6KGHYHMG2SLCDT243PH4I

链接仅在有限的时间内有效，或者您可以创建令牌：GitHub文章

我们不得不经常从私有GitHub存储库下载文件，而且骇人的shell脚本并不能很好地解决这个问题，因此我们创建了fetch，这是一个开放源代码，跨平台的工具，可以轻松地从a git标签，commit或公共和私有GitHub存储库的分支。

例如，要将文件baz从0.1.3私有GitHub存储库版本下载到/tmp，您可以执行以下操作：

GITHUB_OAUTH_TOKEN="your token"
fetch --repo="https://github.com/foo/bar" --tag="0.1.3" --source-path="/baz" /tmp

令人惊讶的是，直到找到解决方法，所有答案都对我没有用。

您可以使用@thomasfuchs回答的个人访问令牌https://github.com/settings/tokens

注意：创建令牌时，必须检查管理员权限。见相关问题

https://github.com/octokit/octokit.net/issues/1812

curl -H 'Authorization: token YOUR_TOKEN' \
  -H 'Accept: application/vnd.github.v4.raw' \
  -O \
  -L https://api.github.com/repos/INSERT_OWNER_HERE/INSERT_REPO_HERE/contents/PATH/TO/FILE

因此，如果原始文件的网址（登录时）为

https://raw.githubusercontent.com/mr_coder/my_repo_name/master/my_script


Then 
  -L https://api.github.com/repos/INSERT_OWNER_HERE/INSERT_REPO_HERE/contents/PATH/TO/FILE
becomes
  -L https://api.github.com/repos/mr_coder/my_repo_name/contents/my_script

注意：我们有API v4

对于GitHub Enterprise和API v3，我的bash解决方案如下所示（包括令牌清除/隐私）：

TOKEN=yourTokenHere; history -d $((HISTCMD-1)) > /dev/null

curl -H "Authorization: token $TOKEN" \
  -H 'Accept: application/vnd.github.v3.raw' \
  -o file.ext \
  -L http://github.company.com/api/v3/repos/[org]/[repo]/contents/path/file.ext?ref=[branch]

unset TOKEN

我认为这是发行个人访问令牌的一种危险方式，不是一个好方法，该令牌可以访问所有存储库，甚至只是从我的私人存储库下载单个文件。

如何 -

我想建议对单个文件使用带有令牌的url。不用担心 令牌字符串将由github自动生成。您可以在源代码页面上获得此URL。

1. 转到源代码页面，您要通过curl或wget等下载的内容
2. 找到“原始”按钮，然后单击它。
3. 新页面打开，只需复制URL。该网址如下所示：
   （https://raw.githubusercontent.com/USERNAME/REPONAME/BRANCHNAME/FILENAME?token=TOKENSTRING）。
4. 您可以使用此网址下载文件

恕我直言，更简单的解决方案是使用Official GitHub CLI gh。

1. 首先，您必须登录：

gh auth login

对我来说，此命令不是必需的，因为我已经登录了。

2. 然后，我们需要将文件定位到API URL。并致电gh将其转换为经过身份验证的下载网址：

API_URL=https://api.github.com/repos/owner/repo/contents/path/file.ext
curl $(gh api $API_URL | jq -r .download_url) -o file.ext

一个真实的例子也许更好。这里是从cli下载install_linux.mdgh：

API_URL=https://api.github.com/repos/cli/cli/contents/docs/install_linux.md
curl $(gh api $API_URL | jq -r .download_url) -o install_linux.md

在API_URL：

• 用户owner是cli
• 库名称repo是cli太
• 文件（path/file.ext）的路径为docs/install_linux.md

下面应该可以正常工作。分支名称（在此情况下为主名称）前的“原始”。

curl -L -O https://github.com/your/repo/raw/master/fetch_file.sh

您可以使用原始链接进行此操作。

curl -O https://raw.githubusercontent.com/owner/repo/branchname/path/to/file