[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-3458":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":16,"stars7d":15,"stars30d":17,"stars90d":16,"forks30d":16,"starsTrendScore":16,"compositeScore":18,"rankGlobal":10,"rankLanguage":10,"license":19,"archived":20,"fork":20,"defaultBranch":21,"hasWiki":20,"hasPages":20,"topics":22,"createdAt":10,"pushedAt":10,"updatedAt":23,"readmeContent":24,"aiSummary":25,"trendingCount":16,"starSnapshotCount":16,"syncStatus":26,"lastSyncTime":27,"discoverSource":28},3458,"telecloud-go","dabeecao\u002Ftelecloud-go","dabeecao","TeleCloud is a project that allows the use of Telegram's virtually unlimited storage capacity to store and manage files, now written in Golang.","",null,"Go",142,59,3,1,0,21,5.33,"GNU General Public License v3.0",false,"main",[],"2026-06-12 02:00:50","# TeleCloud\n\n\u003Cdiv align=\"center\">\n\n🇻🇳 Tiếng Việt | [🇺🇸 English](.\u002Freadme_en.md)\n\n**[📢 Nhóm Hỗ trợ](https:\u002F\u002Ft.me\u002F+p-d0qfGRbX4wNzJl)**\n*Tham gia để thảo luận và nhận hỗ trợ*\n\n\u003C\u002Fdiv>\n\n**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.\n\n> [!IMPORTANT]\n> **Thay đổi từ phiên bản 3.7.0**\n> 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:\n> - 🔑 **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 \u002F nhà phát triển** và muốn dùng API credentials của riêng mình.\n> - 🤖 **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.\n\n---\n\n## 📸 Ảnh xem trước giao diện\n\n### 🖥️ Giao diện Máy tính\n| | |\n| :---: | :---: |\n| \u003Cimg src=\"preview\u002Fpreview.jpg\" width=\"100%\"> | \u003Cimg src=\"preview\u002Fpreview-2.jpg\" width=\"100%\"> |\n| \u003Cimg src=\"preview\u002Fpreview-3.jpg\" width=\"100%\"> | \u003Cimg src=\"preview\u002Fpreview-4.jpg\" width=\"100%\"> |\n\n### 📱 Giao diện Điện thoại\n| | | | | |\n| :---: | :---: | :---: | :---: | :---: |\n| \u003Cimg src=\"preview\u002Fpreview-5.jpg\" width=\"100%\"> | \u003Cimg src=\"preview\u002Fpreview-6.jpg\" width=\"100%\"> | \u003Cimg src=\"preview\u002Fpreview-7.jpg\" width=\"100%\"> | \u003Cimg src=\"preview\u002Fpreview-8.jpg\" width=\"100%\"> | \u003Cimg src=\"preview\u002Fpreview-9.jpg\" width=\"100%\"> |\n\n---\n\n## ✨ Tính năng\n\n* 📁 **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).\n* 🎬 **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\u002Fnạ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.\n* 📚 **Đọ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ề.\n* 🔗 **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* 🗂️ **Quản lý trực quan**: Giao diện File Browser hỗ trợ chế độ xem **Lưới (Grid)** và **Danh sách (List)**.\n* ⬆️ **Tốc độ tối ưu**: Upload song song (Multi-threading) và chia nhỏ (chunk) để tối ưu tốc độ và ổn định.\n* 📂 **Hỗ trợ WebDAV**: Gắn TeleCloud thành ổ đĩa mạng trên máy tính (Windows, macOS, Linux).\n* 🪣 **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\u002FSigV2 và Range requests để stream video.\n* 🔌 **Upload API**: Cho phép upload file từ xa qua HTTP API để tích hợp vào script hoặc CI\u002FCD.\n* 📥 **Tải từ URL & Media**: Hỗ trợ tải tệp từ URL và Video\u002FNhạc (YouTube, TikTok, Facebook...) bằng **yt-dlp** ngay trong giao diện.\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.\n* 🧲 **Tải Torrent**: Hỗ trợ tải Torrent và Magnet link trực tiếp về Telegram thông qua **aria2c**.\n* 👥 **Đ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).\n* 🤖 **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.\n* 🔐 **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).\n* 🗄️ **Đa cơ sở dữ liệu**: Hỗ trợ **SQLite**, **MySQL** và **PostgreSQL** cho các hệ thống lớn.\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.\n* 🔒 **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.\n* 🛡️ **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.\n* 🌐 **Đ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.\n\n---\n\n## 🚀 Cài đặt nhanh\n\nSử dụng script tự động là cách đơn giản nhất để bắt đầu:\n\n### Linux \u002F Termux \u002F macOS \u002F Raspberry Pi\n```bash\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002Fdabeecao\u002Ftelecloud-go\u002Fmain\u002Fauto-setup.sh -o auto-setup.sh && bash auto-setup.sh\n```\n\n### Windows\nTải [**`auto-install.bat`**](https:\u002F\u002Fraw.githubusercontent.com\u002Fdabeecao\u002Ftelecloud-go\u002Fmain\u002Fauto-install.bat) và chạy với quyền **Administrator**.\n\n---\n\n## 🚀 Quick Start (English)\n\nUse the automated script — the easiest way to get started:\n\n### Linux \u002F Termux \u002F macOS \u002F Raspberry Pi\n```bash\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002Fdabeecao\u002Ftelecloud-go\u002Fmain\u002Fauto-setup-en.sh -o auto-setup-en.sh && bash auto-setup-en.sh\n```\n\n### Windows\nDownload [**`auto-install-en.bat`**](https:\u002F\u002Fraw.githubusercontent.com\u002Fdabeecao\u002Ftelecloud-go\u002Fmain\u002Fauto-install-en.bat) and run as **Administrator**.\n\n---\n\n## 📖 Tài liệu chi tiết (Wiki)\n\nĐể 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:\n\n*   [🛠️ **Hướng dẫn cài đặt**](.\u002Fdocs\u002FInstallation.md) (Binary, Windows, Linux...)\n*   [⚙️ **Hướng dẫn cấu hình**](.\u002Fdocs\u002FConfiguration.md) (.env, Nginx Proxy...)\n*   [🐳 **Triển khai với Docker**](.\u002Fdocs\u002FDocker.md) (Docker Run, Compose)\n*   [🔌 **Tài liệu API**](.\u002Fdocs\u002FAPI.md) (Hướng dẫn Upload API)\n*   [🔐 **Chính sách bảo mật**](.\u002Fdocs\u002FSecurity.md) (Mã hóa, Hardening & Cảnh báo)\n*   [🛠️ **Phát triển & Bản dịch**](.\u002Fdocs\u002FDevelopment.md) (Build từ nguồn, Đóng góp)\n\n---\n\n## 🔐 Bảo mật\n\nTeleCloud đượ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\u002FDNS Rebinding, CSP...).\n\nĐể 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:\n👉 [**Tài liệu Hướng dẫn Bảo mật & Hardening**](.\u002Fdocs\u002FSecurity.md)\n\n---\n\n## ⚠️ Điều khoản sử dụng & Miễn trừ trách nhiệm\n\nDự á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.\n\nDự á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.\n\n---\n\n## 🙏 Đóng góp\n\nDự án sử dụng các thư viện tuyệt vời: \n* [gotd\u002Ftd](https:\u002F\u002Fgithub.com\u002Fgotd\u002Ftd): Telegram client (MTProto API)\n* [Gin](https:\u002F\u002Fgithub.com\u002Fgin-gonic\u002Fgin): High-performance HTTP web framework\n* [AlpineJS](https:\u002F\u002Fgithub.com\u002Falpinejs\u002Falpine): Minimal JS framework\n* [TailwindCSS](https:\u002F\u002Fgithub.com\u002Ftailwindlabs\u002Ftailwindcss): Utility-first CSS framework\n* [plyr](https:\u002F\u002Fgithub.com\u002Fsampotts\u002Fplyr): HTML5 media player\n* [Artplayer.js](https:\u002F\u002Fgithub.com\u002Fzhw2590582\u002FArtPlayer): Modern and full-featured HTML5 video player.\n* [PDF.js](https:\u002F\u002Fgithub.com\u002Fmozilla\u002Fpdf.js): HTML5 PDF reader and viewer.\n* [Prism.js](https:\u002F\u002Fgithub.com\u002FPrismJS\u002Fprism): Lightweight, extensible syntax highlighter.\n* [FontAwesome](https:\u002F\u002Ffontawesome.com): The world's most popular icon set.\n* [Bun](https:\u002F\u002Fbun.com): Fast JavaScript runtime & toolkit (build toolchain).\n* [yt-dlp](https:\u002F\u002Fgithub.com\u002Fyt-dlp\u002Fyt-dlp): Audio\u002Fvideo downloader.\n* [aria2](https:\u002F\u002Fgithub.com\u002Faria2\u002Faria2): Multi-protocol download utility.\n* [Google Fonts (Nunito)](https:\u002F\u002Ffonts.google.com\u002Fspecimen\u002FNunito): Modern sans-serif typeface.\n\nXin 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.\n\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fdabeecao\u002Ftelecloud-go\u002Fgraphs\u002Fcontributors\">\n  \u003Cimg src=\"https:\u002F\u002Fcontrib.rocks\u002Fimage?repo=dabeecao\u002Ftelecloud-go\" \u002F>\n\u003C\u002Fa>\n\n**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**\n\n---\n\n## 📜 Giấy phép\n\nDự án này được phát hành dưới giấy phép [GNU Affero General Public License v3.0 (AGPL-3.0)](https:\u002F\u002Fwww.gnu.org\u002Flicenses\u002Fagpl-3.0.html).\n","TeleCloud 是一个利用 Telegram 几乎无限的存储容量来存储和管理文件的项目，采用 Golang 语言编写。其核心功能包括无限制的文件存储（自动分块处理大文件）、媒体播放与字幕支持、在线阅读电子书及漫画、灵活的分享链接生成等。技术特点上，TeleCloud 提供了直观的文件管理界面、多线程上传优化速度、WebDAV 支持以及S3 API兼容性，便于与其他第三方应用集成。该项目适用于需要大量云存储空间但又希望保持低成本和个人隐私安全的用户或小团队使用场景。",2,"2026-06-11 02:54:34","CREATED_QUERY"]