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

• Frontend Interface: Built with Vue 3 and Element Plus, with responsive design, dark mode, and Chinese/English switching
• Backend API: Cloudflare Pages Functions and Workers use serverless runtimes; Docker runs a native Node.js and Hono service
• Storage Layer: Supports multiple storage backends (Telegram, R2, S3, Discord, Hugging Face, WebDAV)
• Data Layer: Cloudflare deployments support KV or D1; Docker uses local SQLite and can use the local filesystem in place of R2
• Image Processing: Cloudflare Pages uses same-domain URL transformations, Workers use the Images binding, and Docker uses Sharp
• Deployment: Supports Cloudflare Pages, Cloudflare Workers, and Docker deployment

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!