Skip to content

Project Introduction ​

Animated CloudFlare ImgBed LogoAnimated CloudFlare ImgBed Logo
Licenselatest versionDocker PullsStarsForksTelegram SanyueG-star
GitHub TrendingFeatured|HelloGitHub

CloudFlare ImgBed is an open-source image and file hosting solution for Docker and serverless environments. It brings Telegram, Discord, Cloudflare R2, S3-compatible storage, Hugging Face, WebDAV, and other backends into one management interface. The project provides uploading, reading, directory and tag management, authentication, content moderation, HTTP APIs, WebDAV, and public browsing for personal image hosting, website asset management, and lightweight file distribution.

Demo Screenshots ​

PosterUpload Interface

More Interface Screenshots

Login InterfaceUploading InterfaceDashboard InterfaceUser ManagementSystem Settings

Technical Architecture ​

CloudFlare ImgBed architecture: client interfaces, portable service runtimes, database compatibility, unified storage channels, and extensible AI capabilities

Write Once, Run Anywhere: A next-gen media engine uniting decoupled storage, resilient routing, and AI-native workflows.

  • Isomorphic Core & Adaptive Persistence: A unified application engine running seamlessly across Cloudflare Pages, Workers, and Docker, dynamically backed by KV, D1, or SQLite.
  • Decoupled Control & Data Planes: Strictly separates metadata management from binary file payloads via pluggable adapters, unlocking limitless storage extensibility.
  • Resilient Channel Routing: Intelligent multi-channel traffic orchestration with built-in load balancing and automatic failover for rock-solid availability.
  • AI-Native Media Pipeline: Embeds an extensible AI framework directly into file workflows—bringing configurable models, prompt orchestration, and structured outputs out of the box.

Version History ​

v2.x Major Update ​

  • 🎨 Responsive upload and management interfaces with dark mode, bilingual UI, and custom backgrounds
  • 📁 Directories, tags, filters, batch operations, and recursive folder uploads
  • 🗄️ Telegram, R2, S3, Discord, Hugging Face, and WebDAV storage backends
  • ⚡ Multi-channel load balancing, capacity limits, failover, and chunked large-file uploads
  • 🌐 Upload, Read, Delete, List, Random Image, and Token Management APIs, plus WebDAV
  • 🖼️ URL-based image resizing, cropping, and stretching
  • 🔐 Auth system hardening: PBKDF2 password hashing, HttpOnly Cookie session management
  • 🔑 Scoped API Tokens with expiration and automatic deletion
  • ☁️ Cloudflare Pages, Workers, and Docker deployment using KV/D1 or SQLite data layers

v1.x Feature Foundation ​

  • 🚀 Basic file upload and management functionality
  • 🔐 Authentication and permission control
  • 🎨 Custom interface and configuration
  • 📡 Complete API interface

Open Source License ​

This project is licensed under the MIT Open Source License, you can:

  • ✅ Commercial use
  • ✅ Modify and distribute
  • ✅ Private use
  • ✅ Patent use

But you must retain the original author's copyright notice in all copies or substantial portions of the software, including but not limited to the frontend and backend code and other files.

Star History ​

Star-HistoryStar-History

Like the project? Please consider giving it a free star ✨✨✨, thank you!

Released under the MIT License