/am-cf-github2raw

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

Primary LanguageJavaScriptApache License 2.0Apache-2.0

am-cf-github2raw

▶️ 新人YouTube 需要您的支持，请务必帮我点赞、关注、打开小铃铛，十分感谢！！！ ✅
🎁 不要只是下载或Fork。请 follow 我的GitHub、给我所有项目一个 Star 星星（拜托了）！你的支持是我不断前进的动力！ 💖
✅解锁更多技术请访问【个人博客】,加入TG群【AM科技 | 分享交流群】

轻松访问GitHub私有仓库

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

为什么需要这个工具？

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

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

如何使用？

假设你的Cloudflare Workers项目部署在raw.amcloud.filegear-sg.me，

而你要访问的私有文件是https://raw.githubusercontent.com/ansoncloud8/am-cf-github2raw/main/_worker.js。

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

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

https://raw.amcloud.filegear-sg.me/ansoncloud8/am-cf-github2raw/main/_worker.js?token=你的GitHub令牌

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

https://raw.amcloud.filegear-sg.me/https://raw.githubusercontent.com/ansoncloud8/am-cf-github2raw/main/_worker.js?token=你的GitHub令牌

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

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

https://raw.amcloud.filegear-sg.me/ansoncloud8/am-cf-github2raw/main/_worker.js

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

https://raw.amcloud.filegear-sg.me/https://raw.githubusercontent.com/ansoncloud8/am-cf-github2raw/main/_worker.js

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

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

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

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

https://raw.amcloud.filegear-sg.me/ansoncloud8/am-cf-github2raw/main/_worker.js?token=mysecretkey

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

https://raw.amcloud.filegear-sg.me/https://raw.githubusercontent.com/ansoncloud8/am-cf-github2raw/main/_worker.js?token=mysecretkey

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

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

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

  • GH_NAME：你的GitHub用户名（例如: ansoncloud8） 然后，你的URL会是这样的：
https://raw.amcloud.filegear-sg.me/am-cf-github2raw/main/_worker.js?token=sd123123
  • GH_REPO：你的GitHub仓库名（例如: am-cf-github2raw，必须设置GH_NAME变量为前提） 然后，你的URL会是这样的：
https://raw.amcloud.filegear-sg.me/main/_worker.js?token=sd123123
  • GH_BRANCH：你的GitHub仓库名（例如: main，必须设置GH_NAME和GH_REPO变量为前提） 然后，你的URL会是这样的：
https://raw.amcloud.filegear-sg.me/_worker.js?token=sd123123

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

https://raw.amcloud.filegear-sg.me/https://raw.githubusercontent.com/ansoncloud8/am-cf-github2raw/main/_worker.js?token=sd123123

如何设置这些变量？

在你的Cloudflare Workers管理面板中：

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

GitHub个人访问令牌可以在GitHub设置中(点个人头像,点击Settings)进入"Developer settings" > "Personal access tokens“ > "tokens (classic)"页面生成。

错误处理

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

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

变量说明

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

▶️ 新人YouTube 需要您的支持，请务必帮我点赞、关注、打开小铃铛，十分感谢！！！ ✅
🎁 不要只是下载或Fork。请 follow 我的GitHub、给我所有项目一个 Star 星星（拜托了）！你的支持是我不断前进的动力！ 💖

[点击展开] 赞赏支持 ~🧧 *我非常感谢您的赞赏和支持，它们将极大地激励我继续创新，持续产生有价值的工作。*
  • USDT-TRC20: TWTxUyay6QJN3K4fs4kvJTT8Zfa2mWTwDD