TeleCloud

🇻🇳 Tiếng Việt | 🇺🇸 English

📢 Nhóm Hỗ trợ Tham gia để thảo luận và nhận hỗ trợ

TeleCloud là một dự án sử dụng dung lượng lưu trữ của Telegram để lưu trữ và quản lý tệp. Được viết lại hoàn toàn bằng Golang, đem lại hiệu năng xuất sắc và sử dụng bộ nhớ cực thấp.

---

📸 Ảnh xem trước giao diện

🖥️ Giao diện Máy tính

📱 Giao diện Điện thoại

---

✨ Tính năng

• 📁 Lưu trữ không giới hạn: Lưu file trực tiếp trên Telegram không giới hạn dung lượng (Tự động chia nhỏ file siêu lớn thành các mảnh từ 500MB đến 4GB).
• 🎬 Phát phương tiện: Phát video và nhạc trực tiếp trong trang quản lý và liên kết chia sẻ (Hỗ trợ phát mượt mà các file đã chia nhỏ).
• 🔗 Chia sẻ linh hoạt: Hỗ trợ liên kết thường hoặc link tải trực tiếp (Direct Link), hỗ trợ chia sẻ cả Thư mục.
• 🗂️ Quản lý trực quan: Giao diện File Browser hỗ trợ chế độ xem Lưới (Grid) và Danh sách (List).
• ⬆️ Tốc độ tối ưu: Upload song song (Multi-threading) và chia nhỏ (chunk) để tối ưu tốc độ và ổn định.
• 📂 Hỗ trợ WebDAV: Gắn TeleCloud thành ổ đĩa mạng trên máy tính (Windows, macOS, Linux).
• 🔌 Upload API: Cho phép upload file từ xa qua HTTP API để tích hợp vào script hoặc CI/CD.
• 📥 Tải từ URL & Media: Hỗ trợ tải tệp từ URL và Video/Nhạc (YouTube, TikTok, Facebook...) bằng yt-dlp ngay trong giao diện.
• ⚡ Tải trong nền: Hỗ trợ tải tệp từ URL trong nền, không cần treo trình duyệt, có thông báo tiến trình real-time.
• 🧲 Tải Torrent: Hỗ trợ tải Torrent và Magnet link trực tiếp về Telegram thông qua aria2c.
• 👥 Đa người dùng: Hỗ trợ tạo tài khoản con với không gian lưu trữ riêng biệt (Virtual Path).
• 🤖 Multi-Bot (Bot Pool): Sử dụng nhiều Bot phụ để chia đều tải trọng, tăng tối đa tốc độ và độ ổn định.
• 🔐 Bảo mật Passkey: Hỗ trợ đăng nhập bằng vân tay, khuôn mặt hoặc khóa bảo mật (WebAuthn).
• 🗄️ Đa cơ sở dữ liệu: Hỗ trợ SQLite, MySQL và PostgreSQL cho các hệ thống lớn.
• 🗑️ Thùng rác: Lưu trữ và khôi phục các tệp đã xóa, bảo vệ dữ liệu khỏi việc xóa nhầm.
• 🔒 Bảo mật chia sẻ: Thiết lập mật khẩu bảo vệ cho các liên kết chia sẻ tệp và thư mục.
• 🛡️ Sao lưu tự động: Tự động sao lưu hàng ngày cơ sở dữ liệu và thumbnails trực tiếp vào Telegram.
• 🌐 Đa ngôn ngữ: Hỗ trợ Tiếng Việt, Tiếng Anh, Tiếng Trung, Tiếng Nhật, Tiếng Nga và nhiều ngôn ngữ khác.

---

🚀 Cài đặt nhanh

Sử dụng script tự động là cách đơn giản nhất để bắt đầu:

Linux / Termux / macOS / Raspberry Pi

curl -fsSL https://raw.githubusercontent.com/dabeecao/telecloud-go/main/auto-setup.sh -o auto-setup.sh && bash auto-setup.sh

Windows

Tải auto-install.bat và chạy với quyền Administrator.

---

📖 Tài liệu chi tiết (Wiki)

Để biết thêm chi tiết về cấu hình và các phương pháp cài đặt khác, vui lòng xem tài liệu:

• 🛠️ Hướng dẫn cài đặt (Binary, Windows, Linux...)
• ⚙️ Hướng dẫn cấu hình (.env, Nginx Proxy...)
• 🐳 Triển khai với Docker (Docker Run, Compose)
• 🔌 Tài liệu API (Hướng dẫn Upload API)
• 🔐 Chính sách bảo mật (Mã hóa, Hardening & Cảnh báo)
• 🛠️ Phát triển & Bản dịch (Build từ nguồn, Đóng góp)

---

🔐 Bảo mật

TeleCloud được thiết kế với các tiêu chuẩn bảo mật tối ưu (bao gồm mã hóa dữ liệu nhạy cảm AES-256-GCM trong DB, hardening systemd, rate limits, chống SSRF/DNS Rebinding, CSP...).

Để xem chi tiết về kiến trúc bảo mật, các khuyến nghị vận hành và hạn chế đã biết, vui lòng tham khảo: 👉 Tài liệu Hướng dẫn Bảo mật & Hardening

---

⚠️ Điều khoản sử dụng & Miễn trừ trách nhiệm

Dự án TeleCloud được phát triển nhằm mục đích lưu trữ và quản lý tệp tin cá nhân hợp pháp. Chúng tôi không chịu trách nhiệm đối với bất kỳ nội dung nào được người dùng tải lên hoặc các vi phạm điều khoản sử dụng của Telegram. Người dùng hoàn toàn tự chịu trách nhiệm cho hành vi sử dụng của mình.

Dự án được cung cấp "nguyên trạng" (as-is), không có bất kỳ đảm bảo nào về tính ổn định hay bảo mật.

---

🙏 Đóng góp

Dự án sử dụng các thư viện tuyệt vời:

• gotd/td: Telegram client, in Go. (MTProto API)
• Gin: High-performance HTTP web framework.
• AlpineJS: A rugged, minimal framework for JS.
• TailwindCSS: A utility-first CSS framework.
• plyr: A simple HTML5 media player.
• Artplayer.js: Modern and full-featured HTML5 video player.
• Prism.js: Lightweight, extensible syntax highlighter.
• FontAwesome: Bộ biểu tượng phổ biến nhất thế giới.
• yt-dlp: Audio/video downloader.
• aria2: Multi-protocol download utility.
• Google Fonts (Nunito): Modern sans-serif typeface.

Xin cảm ơn các đội ngũ phát triển và các nhà đóng góp (contributors) đã cung cấp những công cụ và nỗ lực hữu ích cho cộng đồng.

Một phần mã nguồn của dự án và readme này được tham khảo và chỉnh sửa bởi Gemini AI

---

📜 Giấy phép

Dự án này được phát hành dưới giấy phép GNU Affero General Public License v3.0 (AGPL-3.0).