教程

使用 HuggingFace 免费搭建 100G 图床和网盘，支持上传大文件

前言

大家好，今天分享一个使用 HuggingFace 免费搭建 100G 图床和网盘 的教程，无需实名认证即可完成搭建。

之前写过关于使用缤纷云搭建图床的教程，很多小伙伴反馈需要实名认证，担心隐私信息安全。因此特意寻找了替代方案。今天分享的项目是 CloudFlare-ImgBed，这是一个基于 Cloudflare Pages 的开源文件托管解决方案，致力于为用户提供免费、稳定、高效的文件存储服务。

该项目支持多种存储渠道，兼容无服务器和有服务器多种部署方式。目前该项目在 GitHub 上已获得 4k+ Star，由 MarSeventh 大佬开发，支持多种存储方式且配置灵活。

项目预览

  • 官方文档：https://cfbed.sanyue.de/
  • 演示站点：https://cfbed.1314883.xyz/
  • 作者搭建站点：https://img.hudi.cc.cd/

前台界面

后台界面

技术架构

该系统采用前后端分离设计：

  • 前端：基于 Vue.js 实现响应式界面。
  • 后端：依托 Cloudflare Workers 搭建无服务器 API。
  • 存储层：兼容 Telegram、R2、S3、Discard、HuggingFace 等多类后端。
  • 元数据：统一通过 Cloudflare KV 管理。

项目部署

作者提供了两种部署方式：Cloudflare Pages 托管（推荐）和 Docker 部署。

首先，需要 Fork 源码仓库到自己的 GitHub，以便后续更新可直接同步部署。

GitHub 地址：https://github.com/MarSeventh/CloudFlare-ImgBed

Cloudflare Pages 部署（推荐）

1. 创建项目
在控制面板找到【计算和 AI】，点击【Workers and Pages】，在页面右上角点击【创建应用程序】。点击“想要部署 Pages？”下的【开始按钮】。

2. 导入代码
在“导入现有 Git 存储库”处点击“开始使用”。

3. 选择仓库
选择你 Fork 的 CloudFlare-ImgBed 项目，点击【开始设置】。

4. 构建配置
项目名称自定义，构建命令填入：npm install，其他保持默认，点击【保存并部署】。

5. 配置数据库

注意：KV 数据库和 D1 数据库只需配置其中一个即可，建议根据需求选择。

  • KV 数据库：进入【存储和数据库】 -> 【Workers KV】，添加 KV 数据库，KV 名称填写 img_url。
  • D1 数据库：进入【存储和数据库】 -> 【D1 SQL 数据库】，点击右上角【创建数据库实例】。

6. 绑定数据库
在 Workers and Pages 中点击刚刚部署好的项目，进入【设置】 -> 【绑定】。添加 KV 数据库绑定如下：

  • 变量名称：img_url
  • KV 命名空间：img_url

点击保存后，项目会自动重新部署。完成后即可使用 Cloudflare 分配的域名访问，建议绑定自己的自定义域名。

Docker 方式部署

1. 创建项目目录

2. 下载 docker-compose.yml 文件

3. 创建配置文件

4. 启动服务

服务启动后，访问 7658 端口即可。如果是服务器部署，请务必开放防火墙或配置端口转发。

HuggingFace 注册与配置

官方地址：https://huggingface.co/

图片存储将使用 HuggingFace 的 Repositories Storage。HuggingFace 渠道支持大文件直传（>20MB），系统会自动使用 LFS 协议进行分片上传。

1. 创建新空间
注册并登录后，在控制面板新建一个 New Space。

2. 配置空间

  • Space name：自定义。
  • Select the Space SDK：选择 Docker 的空项目或其他皆可。
  • Space hardware：选择 Free（免费版）。

空间 SDK 选择任意类型均可，因为我们需要的是一个仓库标识。空间可见性可根据个人意愿选择 Public 或 Private。

点击【Create Space】创建。

3. 创建 Access Token
进入 【Settings】 -> 【Access Tokens】，点击【Create new token】。

  • Token name：自定义。
  • 权限：务必勾选 Role 为 Write（仓库读写权限）。

链接直达：https://huggingface.co/settings/tokens

存储配置

1. 添加上传渠道
进入 CloudFlare-ImgBed 系统后台，点击【系统设置】 -> 【上传设置】，在添加上传渠道区域进行配置。

2. 配置 HF 存储参数

  • 渠道名称：自定义。
  • 仓库名称：必须严格遵循 用户名/仓库名 的格式（即 HuggingFace 上的 Space 路径）。
  • Access Token：填入上一步申请的 Token。

点击保存。

3. 设置默认上传渠道
在【系统设置】 -> 【页面设置】中，配置默认上传渠道及其他个性化设置。

完成以上配置，即可开始使用你的专属图床和网盘。

总结

这个方案的优势在于完全无需实名认证，访问速度良好，支持大文件上传，且全程无需购买服务器或下载客户端，直接部署使用。

不花一分钱就能部署一个功能强大的图床/网盘系统，性价比极高。快去动手试试吧！