<a href="https://github.com/MarSeventh/CloudFlare-ImgBed"><img width="80%" alt="logo" src="https://github.com/MarSeventh/CloudFlare-ImgBed/raw/v2.7.4/readme/banner.png" /></a>

🗂️开源文件托管解决方案，支持 Docker 和无服务器部署，支持 Telegram、Discord、Cloudflare R2、S3、Huggingface、WebDAV 等多种存储渠道，提供 RESTful APIs 和 WebDAV 支持

    <a href="https://github.com/MarSeventh/CloudFlare-ImgBed/blob/main/README_zh.md">简体中文</a> | <a href="https://github.com/MarSeventh/CloudFlare-ImgBed/blob/main/README.md">English</a> | <a href="https://cfbed.sanyue.de">官方网站</a>






    <a href="https://github.com/MarSeventh/CloudFlare-ImgBed/blob/main/LICENSE"><img src="https://img.shields.io/github/license/MarSeventh/CloudFlare-ImgBed" alt="License" /></a>
    <a href="https://github.com/MarSeventh/CloudFlare-ImgBed/releases"><img src="https://img.shields.io/github/release/MarSeventh/CloudFlare-ImgBed" alt="latest version" /></a>
    <a href="https://github.com/MarSeventh/CloudFlare-ImgBed/releases"><img src="https://img.shields.io/github/downloads/MarSeventh/CloudFlare-ImgBed/total?color=%239F7AEA&logo=github" alt="Downloads" /></a>
    <a href="https://hub.docker.com/r/marseventh/cloudflare-imgbed"><img src="https://img.shields.io/docker/pulls/marseventh/cloudflare-imgbed" alt="Docker Pulls" /></a>
    <a href="https://github.com/MarSeventh/CloudFlare-ImgBed/stargazers"><img src="https://img.shields.io/github/stars/MarSeventh/CloudFlare-ImgBed" alt="Stars" /></a>
    <a href="https://github.com/MarSeventh/CloudFlare-ImgBed/network/members"><img src="https://img.shields.io/github/forks/MarSeventh/CloudFlare-ImgBed" alt="Forks" /></a>
    <a href="https://atomgit.com/MarSeventh/CloudFlare-ImgBed"><img src="https://atomgit.com/MarSeventh/CloudFlare-ImgBed/star/badge.svg" alt="G-star" /></a>






    <a href="https://trendshift.io/repositories/14324" target="_blank"><img src="https://trendshift.io/api/badge/repositories/14324" alt="GitHub Trending" width="250" /></a>
    <a href="https://hellogithub.com/repository/MarSeventh/CloudFlare-ImgBed" target="_blank"><img src="https://api.hellogithub.com/v1/widgets/recommend.svg?rid=71d65ace215945b0909d4c75c31b9fcb&claim_uid=6DsuqF4hInJWerv&theme=neutral" alt="Featured｜HelloGitHub" width="250" /></a>

---

[!IMPORTANT]

v2.0 版本升级注意事项请查看公告！

公告

置顶

1. 部署使用出现问题，请先仔细查阅文档、常见问题解答以及已有issues。

2. 注意：本仓库为Telegraph-Image项目的重制版，如果你觉得本项目不错，在支持本项目的同时，也请支持原项目。

V2.7.1+ Cloudflare Pages 构建输出目录变更

自 v2.7.1 版本起，前端构建产物已迁移至 frontend-dist 目录。Cloudflare Pages 用户需要手动修改构建配置：

1. 前往 Cloudflare Dashboard → 您的 Pages 项目 → 设置 → 构建
2. 编辑构建配置，将构建输出目录从 / 修改为 /frontend-dist
3. 保存后重新部署

Docker 用户和 Workers 用户无需操作。

2026.3.4 V2.6.2 重构 Docker 镜像的说明

本次版本对 Docker 镜像进行了重构，涉及基础镜像、目录结构和数据库等方面的变更，带来了并发、内存管理等方面的优化。为确保数据安全，请务必先备份数据再进行升级。

升级前：备份数据

1. 备份数据：在管理面板下载备份文件（若原来使用本地R2存储需要全部下载重传）
2. 备份data文件夹

升级步骤

1. 拉取最新镜像：

bash docker compose pull

1. 使用新镜像启动容器：

bash docker compose up -d

1. 检查容器是否正常运行：

bash docker compose logs -f

确认日志中无报错信息后即可正常使用。

1. 恢复数据：在管理面板恢复全部数据（原来的R2文件需要重传）

升级异常：回退版本

如果升级后出现异常，可通过以下步骤回退：

1. 停止容器：

bash docker compose down

1. 回退到旧版本镜像：

bash # amd64 docker pull marseventh/cloudflare-imgbed@sha256:896dc1b79883 # arm docker pull marseventh/cloudflare-imgbed@sha256:b5442ccc198c

同时修改 docker-compose.yml 中的 image 字段为对应旧版本 tag，然后重新启动：

bash docker compose up -d

注意事项： - 升级前请务必确认备份完整，必要时备份一份data文件夹 - 如果你使用了自定义的 docker-compose.yml 配置（如自定义端口、环境变量等），升级时请注意保留 - 遇到问题请先查阅文档和已有 issues，或提交新的 issue

2025.2.6 V2.0 版本升级注意事项

v2.0 版已发布，相较于 v1.0 版本进行了大量改动和优化，但 beta 版本可能存在潜在不稳定性，若您追求稳定，可选择暂缓更新。

由于构建命令发生了变化，此次更新需要您手动进行，请按照以下步骤进行操作：

• 同步fork的仓库至最新版（若已自动同步可忽略）

• 前往 pages 管理页面，进入设置->构建，编辑构建配置，在构建命令处填写npm install

• 新版本所有设置项已迁移至 管理端->系统设置 界面，原则上无需再通过环境变量的方式进行设置，通过系统设置界面进行的设置将覆盖掉环境变量中的设置，但为了保证 Telegram渠道的图片 能够与旧版本相兼容，若您之前设置了 Telegram 渠道相关的环境变量，请将其保留！

• 确保上述设置完成无误后，前往 pages 管理页面，进入部署，对最后一次不成功的部署进行重试操作

关于切换到 Telegram 渠道的通知

由于telegraph图床被滥用，该项目上传渠道已切换至Telegram Channel，请更新至最新版（更新方式见第3.1章最后一节），按照文档中的部署要求设置TG_BOT_TOKEN和TG_CHAT_ID，否则将无法正常使用上传功能。

此外，目前KV数据库为必须配置，如果以前未配置请按照文档说明配置。

出现问题，请先查看第5节常见问题Q&A部分。

1. Introduction

免费文件托管解决方案，具有上传、管理、读取、删除等全链路功能，覆盖文件全生命周期，支持鉴权、目录、图片审查、随机图等各项特性（详见功能文档）。

2. Document

提供详细的部署文档、功能文档、开发计划、更新日志、常见问题解答等，帮助您快速上手。

3. Demo

演示站点：CloudFlare ImgBed 访问密码：cfbed

其他页面效果展示

4. Tips

• 前端开源：参见MarSeventh/Sanyue-ImgHub项目。

• 桌面端开源：参见MarSeventh/satellite项目。

• 生态建设：欢迎社区参与生态建设，欢迎提交 PR 或者 Issue，优质内容参见官网生态建设页面。

• 赞助：项目维护不易，喜欢本项目的话，可以作者大大一点小小的鼓励哦，您的每一份支持都是我前进的动力\~

    

• Sponsors：感谢以下赞助者对本项目的支持！

• Contributors：感谢以下贡献者对本项目的无私贡献！

5. Star History

如果觉得项目不错希望您能给个免费的star✨✨✨，非常感谢！

6. Special Sponsors

• CloudFlare & EdgeOne：提供CDN加速和安全保护服务

• 速维云：提供云计算服务资源支持

• Linux DO：新的理想型社区