官方文档:CloudFlare ImgBed
项目简介
CloudFlare ImgBed 是一个基于 Cloudflare Pages 的开源文件托管解决方案,为用户提供免费、稳定、高效的文件存储服务。项目支持多种存储渠道,支持无服务器和有服务器部署方式,满足不同用户的需求。
功能特性
存储渠道
渠道类型 | 文件大小限制 | 费用 | 特点 |
---|---|---|---|
Telegram Bot | 20MB | 免费 | 稳定可靠,支持压缩 |
Cloudflare R2 | 无限制 | 10GB用量内免费 | 高性能,企业级 |
S3 API | 根据服务商 | 根据服务商 | 兼容性强,选择多样 |
文件管理
- 目录功能:支持创建目录,文件分类管理
- 批量操作:批量删除、移动、加入黑白名单
- 文件搜索:快速查找指定文件
- 详细信息:查看文件大小、上传时间、来源 IP 等
现代化设计
- 响应式布局:完美适配桌面和移动设备
- 深色模式:支持浅色/深色主题切换
- 流畅动画:丝滑的过渡效果和交互动画
- 呼吸灯效果:上传过程中的视觉反馈
网页截图

安装部署
Cloudflare Pages 部署(推荐)
1.Fork 项目:点这里
2.创建 Pages 项目,连接到刚才fork的项目

3.构建设置,如图所示
配置项 | 值 | 说明 |
---|---|---|
项目名称 | cloudflare-imgbed (或自定义) | 项目标识符 |
生产分支 | main | 生产环境分支 |
构建命令 | npm install | 重要:v2.0 新构建命令 |
构建输出目录 | / | 保持默认 |

4.点击 “保存并部署”,等待2-3分钟
5.在“存储与数据库”中创建 KV 命名空间,输入命名空间名称:img_url
(建议使用此名称)


6.绑定KV空间,在Pages 项目中选择 “设置” → “绑定”,点击 “添加” → “KV 命名空间”
变量名称:img_url
(必须是这个名称)
KV 命名空间:选择刚创建的命名空间
7.重新部署(项目中右侧的 “…” 菜单)
Docker部署
Docker Compose(推荐)
1.创建项目目录
mkdir cloudflare-imgbed cd cloudflare-imgbed
2.下载 Docker Compose 文件
# 下载 docker-compose.yml wget https://raw.githubusercontent.com/MarSeventh/CloudFlare-ImgBed/main/docker-compose.yml # 或者手动创建 curl -o docker-compose.yml https://raw.githubusercontent.com/MarSeventh/CloudFlare-ImgBed/main/docker-compose.yml
3.创建配置文件
创建 wrangler.toml
文件
name = "cloudflare-imgbed" compatibility_date = "2024-07-24" # 可选:添加环境变量,v2.0 版本后大部分配置已迁移到管理后台 # [vars]
4.启动服务
# 启动服务(后台运行) docker compose up -d # 查看日志 docker compose logs -f
5.访问服务
打开浏览器访问:http://your-server-ip:7658
Docker 命令
1.创建项目目录
mkdir cloudflare-imgbed cd cloudflare-imgbed
2.创建配置文件
创建 wrangler.toml
文件
name = "cloudflare-imgbed" compatibility_date = "2024-07-24" # 可选:添加环境变量,v2.0 版本后大部分配置已迁移到管理后台 # [vars]
3.拉取镜像
docker pull marseventh/cloudflare-imgbed:latest
4.运行容器
docker run -d \ --name cloudflare-imgbed \ -p 7658:8080 \ -v $(pwd)/data:/app/data \ -v $(pwd)/wrangler.toml:/app/wrangler.toml \ marseventh/cloudflare-imgbed:latest
5.访问服务
打开浏览器访问:http://your-server-ip:7658
访问管理后台
访问 https://your-domain/dashboard
提示:管理后台默认无需密码,登录后请及时设置管理员用户名和密码。
其他配置说明详见官方文档
发布者:木木,转载请注明出处:https://blog.mmcoo.de/8368.html