轻松访问GitHub私库

Keaeye2023-07-272023-07-27

CF-Workers-Raw：轻松访问GitHub私有仓库

CF-Workers-Raw 项目链接

这个项目允许你通过 Cloudflare Workers 安全地访问 GitHub 私有仓库中的原始文件，无需直接暴露你的 GitHub 令牌。

为什么需要这个工具？

你有一些存储在 GitHub 私有仓库中的重要文件。
你想直接通过 URL 访问这些文件的原始内容（比如配置文件、数据文件等）。
但是，你不想在 URL 中直接暴露你的 GitHub 令牌，因为这可能会被他人滥用。

我们的解决方案是使用 Cloudflare Workers 作为中间层，它替你安全地处理身份验证，让你可以安全地访问私有文件。

准备工作

创建你的 GitHub 个人访问令牌

进入 Settings > Developer settings > Personal access tokens > Tokens(classic)。
点击 Generate new token (classic)。
随意选择 token 名称，选择过期时间为 No expiration。
选择 repo 权限。
点击 Generate token 生成 token，之后请务必将生成的 token 妥善保存，注意 token 只会显示一次！

部署方式

打开 CF-Workers-Raw：轻松访问GitHub私有仓库项目，
可以选择使用 Workers 或 Pages 一键部署，推荐使用变量来保存您的 GitHub 令牌 token。

变量说明

变量名	示例	必填	备注
GH_TOKEN	ghp_CgmlL2b5J8Z1soNUquc0bZblkbO3gKxhn13t	❌	你的 GitHub 令牌 token
TOKEN	nicaibudaowo	❌	GH_TOKEN 和 TOKEN 同时存在时会作为访问鉴权，单独赋值时的效果与 GH_TOKEN 相同
GH_NAME	keaeye	❌	你的 GitHub 用户名
GH_REPO	CF-Workers-Raw	❌	你的 GitHub 仓库名（必须设置 GH_NAME 变量为前提）
GH_BRANCH	main	❌	你的 GitHub 仓库分支名（必须设置 GH_NAME 和 GH_REPO 变量为前提）
URL302	https://t.me/keaeyequn	❌	主页 302 跳转
URL	https://github.com/keaeye/CF-Workers-Raw/blob/main/README.md	❌	主页伪装
ERROR	无法获取文件，检查路径或 TOKEN 是否正确	❌	自定义错误提示

如何使用？

假设你的 Cloudflare Workers 项目部署在 raw.keaeye.fun，而你要访问的私有文件是 https://raw.githubusercontent.com/keaeye/CF-Workers-Raw/main/_worker.js。

方法 1：未设置变量参数的临时用法，通过 URL 参数传递令牌

最直接的方法是在 URL 中添加你的 GitHub 令牌作为参数：

1	https://raw.keaeye.fun/keaeye/CF-Workers-Raw/main/_worker.js?token=你的GitHub令牌

或者，如果你喜欢完整的原始 URL：

1	https://raw.keaeye.fun/https://raw.githubusercontent.com//CF-Workers-Raw/main/_worker.js?token=你的GitHub令牌

方法 2：只设置了一个变量参数，则默认访问将会自动帮您填写令牌

如果你经常访问同一个私有仓库，可以在 Workers 设置中添加一个名为 GH_TOKEN 的变量，值为你的 GitHub 令牌。这样，你就可以直接访问，无需在 URL 中每次都包含令牌：

1	https://raw.keaeye.fun/keaeye/CF-Workers-Raw/main/_worker.js

或者，如果你喜欢完整的原始 URL：

1	https://raw.keaeye.fun/https://raw.githubusercontent.com/keaeye/CF-Workers-Raw/main/_worker.js

方法 3：添加额外的访问控制（推荐，这是最安全的做法）

为了更高的安全性，你可以设置两个变量：

GH_TOKEN：你的 GitHub 令牌
TOKEN：一个自定义的访问密钥（比如 sd123123）

然后，你的 URL 会是这样的：

1	https://raw.keaeye.fun/keaeye/CF-Workers-Raw/main/_worker.js?token=sd123123

或者，如果你喜欢完整的原始 URL：

https://raw.keaeye.fun/https://raw.githubusercontent.com/keaeye/CF-Workers-Raw/main/_worker.js?token=sd123123


这种方法提供了双重安全：即使有人猜到了你的自定义密钥，他们仍然无法访问你的 GitHub 文件，因为 GitHub 令牌是安全地存储在 Workers 设置中的。

### 方法 4：添加 GH_NAME、GH_REPO、GH_BRANCH 变量隐藏 GitHub 路径信息

为了更高的隐私性，你可以设置多个变量：

- `GH_NAME`：你的 GitHub 用户名（例如：`keaeye`）

然后，你的 URL 会是这样的：

```bash
https://raw.keaeye.fun/main/_worker.js?token=sd123123