📂 FilesLink

Secure file sharing powered by Telegram cloud storage

FilesLink is a Telegram bot that transforms your private channel into unlimited cloud storage. Upload files, get instant download links, no local disk required.

Features

• 📤 Instant Upload - Send files to bot, receive download links
• ☁️ Telegram Storage - Up to 2GB per file, unlimited storage
• ⚡ FastTelethon - Bypass 20MB bot API limit with MTProto (also 10-30 MB/s speeds)
• 🔗 URL Download - Fetch external files directly
• 🔒 Access Control - Granular per-chat permissions
• 🚀 Fast Streaming - Direct downloads from Telegram
• 🐳 Docker Ready - One-command deployment

Quick Start

git clone https://github.com/bytetrix/fileslink.git
cd fileslink
cp .env.example .env  # Add your credentials
docker compose up -d

Access: http://localhost:8080

Documentation

Guide	Description
📦 Installation	Docker, local, and production setup
⚙️ Configuration	All environment variables explained
📱 Telegram Setup	Configure your storage channel
⚡ FastTelethon Setup	Enable large file support (>20MB)
🎯 Usage	How to use the bot
🛡️ Permissions	Access control configuration
🔧 CLI	Command-line interface
🌐 Render Deployment	Deploy to Render.com (free tier)
❓ FAQ	Common questions and troubleshooting
🏗️ Architecture	Technical details

Requirements

Required:

• Telegram bot token (get from BotFather)
• Private Telegram channel
• Channel ID (get via @userinfobot)

Optional:

• Docker (recommended)
• Rust 1.90+ (for local development)

Environment Setup

BOT_TOKEN=123456789:ABC-DEF...
STORAGE_CHANNEL_ID=-1001234567890
APP_FILE_DOMAIN=https://yourdomain.com/files

See Configuration Guide for all options.

Cloud Deployment

Deploy to free hosting in minutes:

• Render - 100% free with Cloudflare keep-alive (no sleep!)
• Railway - easiest setup
• Fly.io - Global edge deployment
• VPS - Full control

See Deployment Guide for details.

Use Cases

• Team file sharing
• Cloud backup solution
• URL-to-file conversion
• Personal file hosting
• Telegram file manager

Tech Stack

• Backend: Rust (Tokio, Axum)
• Bot: Teloxide
• Storage: Telegram Cloud (2GB per file)
• Large Files: FastTelethon (Python MTProto client for files >20MB)
• Deployment: Docker

License

MIT © Bytetrix

---

Need help? Check the FAQ or open an issue.