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

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

What's Update?

增加了REPLACE_REGEX和REPLACE_CONTENT两项配置，

• REPLACE_REGEX - 需要替换的正则表达式
• REPLACE_CONTENT - 替换的内容

为什么需要这个工具？

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

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

如何使用？ 视频教程

假设你的 Cloudflare Workers 项目部署在raw.090227.xyz，

而你要访问的私有文件是https://raw.githubusercontent.com/cmliu/CF-Workers-Raw/main/_worker.js。

方法 1：通过 URL 参数传递令牌

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

https://raw.090227.xyz/cmliu/CF-Workers-Raw/main/_worker.js?token=你的GitHub令牌

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

https://raw.090227.xyz/https://raw.githubusercontent.com/cmliu/CF-Workers-Raw/main/_worker.js?token=你的GitHub令牌

方法 2：在 Workers 中设置全局令牌

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

https://raw.090227.xyz/cmliu/CF-Workers-Raw/main/_worker.js

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

https://raw.090227.xyz/https://raw.githubusercontent.com/cmliu/CF-Workers-Raw/main/_worker.js

方法 3：添加额外的访问控制（推荐）

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

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

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

https://raw.090227.xyz/cmliu/CF-Workers-Raw/main/_worker.js?token=mysecretkey

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

https://raw.090227.xyz/https://raw.githubusercontent.com/cmliu/CF-Workers-Raw/main/_worker.js?token=mysecretkey

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

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

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

• GH_NAME：你的 GitHub 用户名（例如: cmliu） 然后，你的 URL 会是这样的：

https://raw.090227.xyz/CF-Workers-Raw/main/_worker.js?token=sd123123

• GH_REPO：你的 GitHub 仓库名（例如: CF-Workers-Raw，必须设置GH_NAME变量为前提） 然后，你的 URL 会是这样的：

https://raw.090227.xyz/main/_worker.js?token=sd123123

• GH_BRANCH：你的 GitHub 仓库名（例如: main，必须设置GH_NAME和GH_REPO变量为前提） 然后，你的 URL 会是这样的：

https://raw.090227.xyz/_worker.js?token=sd123123

如您使用完整的原始 URL，则以上变量将不会生效！

https://raw.090227.xyz/https://raw.githubusercontent.com/cmliu/CF-Workers-Raw/main/_worker.js?token=sd123123

如何设置这些变量？

在你的 Cloudflare Workers 管理面板中：

1. 进入你的 Workers 项目。
2. 点击设置标签。
3. 滚动到环境变量部分。
4. 添加以下变量：
   • 变量：GH_TOKEN，值：你的 GitHub 个人访问令牌
   • 变量：TOKEN（可选），值：你的自定义访问密钥

GitHub 个人访问令牌可以在 GitHub 设置中的"Developer settings" > "Personal access tokens (classic)"页面生成。

错误处理

如果出现问题，你会看到以下错误消息之一：

• TOKEN 有误：你提供的自定义访问密钥不正确。
• TOKEN 不能为空：需要提供 GitHub 令牌。
• 无法获取文件 检测路径或 TOKEN：文件路径错误或令牌无权访问该文件。
• 路径不能为空：你没有指定要访问的文件路径。

变量说明

变量名	示例	必填	备注
GH_TOKEN	ghp_CgmlL2b5J8Z1soNUquc0bZblkbO3gKxhn13t	❌	您的 GitHub 令牌 token
TOKEN	nicaibudaowo	❌	GH_TOKEN和TOKEN同时存在的时候会作为访问鉴权，单独赋值时的效果与GH_TOKEN相同
GH_NAME	cmliu	❌	你的 GitHub 用户名
GH_REPO	CF-Workers-Raw	❌	你的 GitHub 仓库(必须设置GH_NAME变量为前提)
GH_BRANCH	main	❌	你的 GitHub 仓库(必须设置GH_NAME和GH_REPO变量为前提)
URL302	https://t.me/CMLiussss	❌	主页 302 跳转
URL	https://github.com/cmliu/CF-Workers-Raw/blob/main/README.md	❌	主页伪装
ERROR	无法获取文件，检查路径或TOKEN是否正确。	❌	自定义错误提示
REPLACE_REGEX	https://raw.github.com	❌	需要替换的正则表达式
REPLACE_CONTENT	https://xxxx.com	❌	替换的内容

感谢

我自己的脑洞、ChatGPT