利用Github私库和Cloudflare反代搭建免费安全的图床方案

图床 2025-05-14 凯吉兰 手机阅读

这篇教程将介绍如何利用 Github 私库 结合 Cloudflare 反代加速，实现 隐藏 Github 仓库路径，并通过 PicGo 工具将图片上传到 Github 仓库中，以搭建一个稳定、免费、且隐私保护的图床。

1. 前言

  • 介绍图床的作用及其重要性
  • 提出利用 Github 私库、Cloudflare 反代、PicGo 的图床方案的优势
    • 免费、稳定、高速
    • 隐藏图片的真实存储路径，提升隐私性
    • 便捷的上传方式

2. 准备

3. 创建 Github 私有仓库

  • 详细步骤：
    • 登陆 Github，创建一个新的私有仓库，用于存储图片
    • 设置仓库的 README.md 或者相关文件，使其可供查看上传文件
    • 获取仓库的访问令牌（Personal Access Token），以便 PicGo 上传图片

利用Github私库和Cloudflare反代搭建免费安全的图床方案-kejiland

利用Github私库和Cloudflare反代搭建免费安全的图床方案-kejiland

利用Github私库和Cloudflare反代搭建免费安全的图床方案-kejiland

利用Github私库和Cloudflare反代搭建免费安全的图床方案-kejiland

利用Github私库和Cloudflare反代搭建免费安全的图床方案-kejiland

利用Github私库和Cloudflare反代搭建免费安全的图床方案-kejiland

4. 配置 Cloudflare 反代

  • 进入Cloudflare>Workers和Pages>创建>编辑代码>复制代码>部署.
  • 本Workers项目>设置>域和路由>添加>自定义域.
  • 本workers项目>设置>变量和机密>添加变量.
  • 此教程只需要两个变量:GH_TOKEN,GH_NAME.
  • GH_TOKEN和GH_NAME分别是gh-开头,用户,隐藏github用户名.
  • 反代自定义域名地址:https://xxx.domain.com/项目名/main.
  • 由于Github每个项目限制4G,为了以后创建多个项目作为图床,项目名可以img1,img2,ing3,img4等等.
  • 如有不理解的地方可到此项目查看详细文档 https://github.com/cmliu/CF-Workers-Raw

    利用Github私库和Cloudflare反代搭建免费安全的图床方案-kejiland

    利用Github私库和Cloudflare反代搭建免费安全的图床方案-kejiland

    利用Github私库和Cloudflare反代搭建免费安全的图床方案-kejiland

    利用Github私库和Cloudflare反代搭建免费安全的图床方案-kejiland

    利用Github私库和Cloudflare反代搭建免费安全的图床方案-kejiland

    利用Github私库和Cloudflare反代搭建免费安全的图床方案-kejiland

    let token = "";
export default {
	async fetch(request ,env) {
		const url = new URL(request.url);
		if(url.pathname !== '/'){
			let githubRawUrl = 'https://raw.githubusercontent.com';
			if (new RegExp(githubRawUrl, 'i').test(url.pathname)){
				githubRawUrl += url.pathname.split(githubRawUrl)[1];
			} else {
				if (env.GH_NAME) {
					githubRawUrl += '/' + env.GH_NAME;
					if (env.GH_REPO) {
						githubRawUrl += '/' + env.GH_REPO;
						if (env.GH_BRANCH) githubRawUrl += '/' + env.GH_BRANCH;
					}
				}
				githubRawUrl += url.pathname;
			}
			//console.log(githubRawUrl);
			if (env.GH_TOKEN && env.TOKEN){
				if (env.TOKEN == url.searchParams.get('token')) token = env.GH_TOKEN || token;
				else token = url.searchParams.get('token') || token;
			} else token = url.searchParams.get('token') || env.GH_TOKEN || env.TOKEN || token;
			
			const githubToken = token;
			//console.log(githubToken);
			if (!githubToken || githubToken == '') return new Response('TOKEN不能为空', { status: 400 });
			
			// 构建请求头
			const headers = new Headers();
			headers.append('Authorization', `token ${githubToken}`);

			// 发起请求
			const response = await fetch(githubRawUrl, { headers });

			// 检查请求是否成功 (状态码 200 到 299)
			if (response.ok) {
				return new Response(response.body, {
					status: response.status,
					headers: response.headers
				});
			} else {
				const errorText = env.ERROR || '无法获取文件，检查路径或TOKEN是否正确。';
				// 如果请求不成功，返回适当的错误响应
				return new Response(errorText, { status: response.status });
			}

		} else {
			const envKey = env.URL302 ? 'URL302' : (env.URL ? 'URL' : null);
			if (envKey) {
				const URLs = await ADD(env[envKey]);
				const URL = URLs[Math.floor(Math.random() * URLs.length)];
				return envKey === 'URL302' ? Response.redirect(URL, 302) : fetch(new Request(URL, request));
			}
			//首页改成一个nginx伪装页
			return new Response(await nginx(), {
				headers: {
					'Content-Type': 'text/html; charset=UTF-8',
				},
			});
		}
	}
};

async function nginx() {
	const text = `
	<!DOCTYPE html>
	<html>
	<head>
	<title>Welcome to nginx!</title>
	<style>
		body {
			width: 35em;
			margin: 0 auto;
			font-family: Tahoma, Verdana, Arial, sans-serif;
		}
	</style>
	</head>
	<body>
	<h1>Welcome to nginx!</h1>
	<p>If you see this page, the nginx web server is successfully installed and
	working. Further configuration is required.</p>
	
	<p>For online documentation and support please refer to
	<a href="http://nginx.org/">nginx.org</a>.<br/>
	Commercial support is available at
	<a href="http://nginx.com/">nginx.com</a>.</p>
	
	<p><em>Thank you for using nginx.</em></p>
	</body>
	</html>
	`
	return text ;
}

async function ADD(envadd) {
	var addtext = envadd.replace(/[	|"'\r\n]+/g, ',').replace(/,+/g, ',');	// 将空格、双引号、单引号和换行符替换为逗号
	//console.log(addtext);
	if (addtext.charAt(0) == ',') addtext = addtext.slice(1);
	if (addtext.charAt(addtext.length -1) == ',') addtext = addtext.slice(0, addtext.length - 1);
	const add = addtext.split(',');
	//console.log(add);
	return add ;
}
    变量说明
    变量名 示例 必填 备注
    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变量为前提)
    ERROR 无法获取文件，检查路径或TOKEN是否正确。 ❌ 自定义错误提示

5. 配置 PicGo 上传Github

安装 PicGo

  • 下载并安装 PicGo 客户端（Windows、macOS 或 Linux）
  • 安装 compress-next 插件，压缩优化图片大小上传Github

配置 PicGo

  • 在 PicGo 中配置上传目标为 Github 私有仓库
  • 输入仓库名、分支名、Personal Access Token、设置自定义域名
  • 设置图片存储路径及格式
    利用Github私库和Cloudflare反代搭建免费安全的图床方案-kejiland

变量说明

变量名 示例 必填 备注
图床配置名 图床测试 ❌ 随便填写
仓库名 img ❌ Github的仓库名
分支名 main ❌ Github的仓库分支
Token gh-xxxxxxxxxxxxxxx ❌ 你的GitHub密钥,
储存路径 不填 ❌ 不必填,图片在项目主目录
自定义域名 https:/xxx.domin.com/img/main ❌ 自定义图片链接

6. Cloudflare 反代隐藏 Github 路径

  • 测试图片上传
    • 通过 PicGo 上传图片，并通过 Cloudflare 自定义域名访问
  • 验证路径隐藏
    • 确认通过自定义域名访问时，无法直接获取 Github 仓库的路径信息
    • 确保图片可以快速加载

7. 高级优化

  • 图片压缩与格式优化
    • 在 PicGo 中设置自动压缩或转换图片格式（如 WebP）
    • 通过Cloudflare CDN反代加速GitHub仓库资源

8. 常见问题及解决方法

  • 上传失败问题
    • 检查 Github Token 权限、仓库设置等
  • 图片加载缓慢
    • 优化 Cloudflare 设置，确保反代加速配置正确

9. 总结

  • 回顾教程内容，总结该图床方案的优点
  • 提供进一步的参考资料和建议（例如对 CDN 加速的进一步优化）

10. 感谢

  • 感谢CMliu的项目给我带来的灵感