📂 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.

ByteTrix/fileslink