Project Introduction
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


More Interface Screenshots





Technical Architecture
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
Like the project? Please consider giving it a free star ✨✨✨, thank you!
