Unlimited Free Cloud Drive: Build Self-Hosted Cloud Storage App

Project Specifications & Benefits

• Infinite Cloud Storage: No subscription tiers. Store terabytes of files for free on Telegram's secure nodes.
• Zero Local Footprint: Files are stored directly in the cloud; no local seedbox or VPS is active.
• 20MB Chunking Engine: Slices files during upload, letting you bypass Cloudflare and Telegram API size bottlenecks.
• Direct Web UI: Upload, preview, list, and download files from any device with a premium glassmorphic dashboard.

How It Works: Serverless Storage Slicing

Standard Cloudflare Workers enforce a 100MB max payload upload limit. To bypass this, the browser slicing engine divides large files into 20MB fragments. Each fragment is sent to the serverless proxy, which routes them to a private Telegram channel. The file reference keys and document IDs are saved securely in Cloudflare's Key-Value (KV) database:

Pipeline Architecture: Slices upload sequentially, storing indexes in Cloudflare KV.

The Gateway Handler Code (Index.js)

The core serverless script (index.js) manages routes for serving the HTML interface, receiving file slices, finalising document metadata, and streaming binary chunks back to the user:

export default {

 async fetch(request, env) {

 const url = new URL(request.url);

 if (request.method === "OPTIONS") {

 return new Response(null, {

 headers: {

 "Access-Control-Allow-Origin": "*",

 "Access-Control-Allow-Methods": "GET, POST, OPTIONS, DELETE",

 "Access-Control-Allow-Headers": "Content-Type, Authorization",

 },

 });

 }



 if (url.pathname === "/" && request.method === "GET") {

 return new Response(getHtmlDashboard(url.origin), {

 headers: { "Content-Type": "text/html; charset=utf-8" }

 });

 }



 if (url.pathname === "/api/files" && request.method === "GET") {

 const keysList = await env.DRIVE_KV.list();

 const files = [];

 for (const key of keysList.keys) {

 const val = await env.DRIVE_KV.get(key.name);

 if (val) files.push(JSON.parse(val));

 }

 return new Response(JSON.stringify(files), {

 headers: { "Content-Type": "application/json", "Access-Control-Allow-Origin": "*" }

 });

 }



 // Handles document proxying and streaming assembly...

 }

};

Manual Setup & Deployment Guide

If you choose not to run the 1-click PowerShell installer, you can configure your serverless dashboard manually:

Step 1: Create a KV Namespace

Run this command in your terminal to initialize a Cloudflare Key-Value namespace to store your file lists:

npx wrangler kv:namespace create DRIVE_KV

Step 2: Bind API Keys & Deploy

Save your credentials as encrypted wrangler secrets and upload the codebase:

1. Run npx wrangler login in your terminal.
2. Save Bot Token: echo your-bot-token | npx wrangler secret put TELEGRAM_TOKEN
3. Save Channel ID: echo your-channel-id | npx wrangler secret put TELEGRAM_CHAT_ID
4. Run npx wrangler deploy to publish your cloud drive.

Terminal Setup: Creating KV namespaces and deploying files interactively.

Premium Dashboard Interface Overview

Once deployed, visiting your worker URL displays a custom dashboard. You can drag and drop media, documents, or zip archives. Progress indicators track slice uploads, and download links serve files at full bandwidth speeds:

Dashboard View: File lists, sizes, and drag-and-drop upload panel in action.

Frequently Asked Questions (FAQs)