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.

Tip

Phiên bản Client Mobile: Dự án hiện đã có phiên bản client dành cho điện thoại di động, tải và xem hướng dẫn tại đây.

Important

Thay đổi từ phiên bản 3.7.0 Kể từ v3.7.0, App ID, API Hash và Bot Token (Bot Pool) không còn cấu hình trong file .env nữa — tất cả được quản lý trực tiếp trong Giao diện Cài đặt của ứng dụng:

• 🔑 App ID & API Hash: Trong bước cài đặt ban đầu, cứ để mặc định và bấm Tiếp tục — ứng dụng đã tích hợp sẵn credentials của nhà phát triển. Chỉ thay đổi nếu bạn là người dùng nâng cao / nhà phát triển và muốn dùng API credentials của riêng mình.
• 🤖 Bot Token (Bot Pool): Thêm, sửa, xóa bot trực tiếp trong Trang quản trị → Cài đặt → Bot Pool mà không cần khởi động lại server.

---

📸 Ả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ụ đề: Phát video và nhạc trực tiếp trong trang quản lý và liên kết chia sẻ. Tích hợp tính năng tự động quét/nạp phụ đề rời cùng tên (.srt, .vtt, .ass) hoặc tải lên thủ công từ thiết bị của bạn. Hỗ trợ các phím tắt điều khiển tiện lợi (Space để phát/tạm dừng, Mũi tên Trái/Phải để tua nhanh 5s, Mũi tên Lên/Xuống để tăng giảm âm lượng, N để chuyển bài tiếp theo, P để về bài trước).
• 📚 Đọc sách & Comic online: Tích hợp các trình đọc trực quan cao cấp cho sách điện tử EPUB, truyện tranh CBZ (Webtoon mode, tự động lưu tiến trình đọc, tải trang thông minh), và tài liệu PDF trực tiếp trên trình duyệt mà không cần tải về.
• 🔗 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.
• ⚡ Nén & Tải thư mục trực tiếp: Tải toàn bộ thư mục về máy dưới dạng ZIP tức thì (Server-Side On-The-Fly ZIP Streaming) không thông qua ổ cứng máy chủ để tối ưu bộ nhớ và băng thông (chỉ áp dụng cho người dùng đã đăng nhập).
• 🗂️ 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).
• 🪣 Tương thích S3 API: Cung cấp giao diện API tương thích S3 (sử dụng gofakes3) giúp kết nối với các ứng dụng bên thứ ba (Rclone, Cyberduck, Infuse, v.v.), hỗ trợ xác thực chữ ký bảo mật SigV4/SigV2 và Range requests để stream video.
• 🔌 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 & Telegram (t.me): Hỗ trợ tải tệp từ URL và Video/Nhạc (YouTube, TikTok, Facebook...) bằng yt-dlp; đặc biệt hỗ trợ tự động giải quyết và tải trực tiếp tệp bị hạn chế tải về từ các liên kết Telegram (t.me hoặc tg://) nhờ tài khoản Userbot tích hợp.
• ⚡ 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) & Nhận tệp cá nhân: Sử dụng nhiều Bot phụ để chia đều tải trọng, tăng tốc độ. Đồng thời hỗ trợ từng thành viên (kể cả tài khoản con) liên kết tài khoản Telegram cá nhân để nhận tệp trực tiếp từ bất kỳ bot nào trong Bot Pool tự động lưu về thư mục riêng.
• 🔐 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.

---

🚀 Quick Start (English)

Use the automated script — the easiest way to get started:

Linux / Termux / macOS / Raspberry Pi

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

Windows

Download auto-install-en.bat and run as 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)
• 📱 Client di động (Hướng dẫn cài đặt & Kết nối)
• 🔌 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 (MTProto API)
• Gin: High-performance HTTP web framework
• AlpineJS: Minimal JS framework
• TailwindCSS: Utility-first CSS framework
• plyr: HTML5 media player
• Artplayer.js: Modern and full-featured HTML5 video player.
• PDF.js: HTML5 PDF reader and viewer.
• Prism.js: Lightweight, extensible syntax highlighter.
• FontAwesome: The world's most popular icon set.
• Bun: Fast JavaScript runtime & toolkit (build toolchain).
• 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).