TeleDrive：把 Telegram 频道当私人云盘

项目简介

TeleDrive 把你自己 Telegram 账号下的一个私有频道当作云盘，用来备份和浏览文件。它没有官方服务器，也不需要另外注册账号，只有一个客户端和一个本地索引；本地索引让浏览和搜索保持快速，并且可以离线使用。

项目用一套 Compose Multiplatform 代码同时构建 Android 应用和 Windows、Linux x86_64、macOS 桌面应用。各端共用同一套存储引擎、加密、传输和 UI 层，浏览的是同一个云盘。

主要功能

• 自动备份：在 Android 上，照片和选定的文件夹会自动上传，并支持定时、仅在 Wi-Fi 或有充电时执行，以及排除规则
• 无文件大小限制：20 GB 的视频在应用里仍是一个文件，不受 Telegram 单条消息上限影响
• 加密：可选 AES-256-GCM，覆盖文件内容、文件名、说明文字和文件夹结构
• 文件管理：文件夹、收藏、隐藏与归档、回收站、批量操作
• 流式播放：视频和音频直接从 Telegram 播放并支持拖动进度，加密文件同样适用
• 预览：图片、PDF、文本和 ZIP 内容可在应用内直接打开
• 多网盘：同一账号下可为个人、工作、照片分别使用不同频道
• 分享与去重：可从 Android 分享面板接收文件，内容相同的文件不会重复上传
• 传输队列：并行队列支持暂停与恢复，重启后仍能继续
• 恢复：重装、登录、输入口令后，整个云盘内容即可恢复
• 设备安全：生物识别应用锁、禁止截屏、本地缓存加密

安装与使用

Windows：从 releases 页面下载 TeleDrive-<version>.msi 并运行。按用户安装，无需管理员权限，会创建开始菜单和桌面快捷方式；配置保存在 %APPDATA%\TeleDrive。

Linux (x86_64)：AppImage 适用于 2022 年之后的多数发行版，下载后赋予执行权限再双击运行；.deb 适用于 Ubuntu 24.04、Debian 13 及更新版本：

chmod +x TeleDrive-<version>-x86_64.AppImage
sudo apt install ./teledrive_<version>_amd64.deb

macOS (Apple Silicon)：下载 .dmg，打开后把 TeleDrive 拖入「应用程序」。应用未使用 Apple Developer ID 签名，首次启动会被 Gatekeeper 拦截，清除一次隔离标记即可：

xattr -dr com.apple.quarantine /Applications/TeleDrive.app

Android：从 releases 页面下载 APK。构建按 CPU 架构拆分：arm64-v8a 对应近几年绝大多数手机，armeabi-v7a 对应较旧的 32 位设备，x86_64 对应 64 位模拟器和 x86 Chromebook，x86 对应 32 位 x86，universal 包含全部架构、不确定时使用。

运行要求：Android 8.0（API 26）及以上、64 位 Windows 10 及以上、Linux x86_64，或 Apple Silicon 上的 macOS；需要一个 Telegram 账号，以及自己在 my.telegram.org 的 API development tools 免费申请的 api_id 和 api_hash。凭据在运行时输入，加密保存在本机。

源码运行：

git clone https://github.com/Mahmud0808/TeleDrive.git
cd TeleDrive
./gradlew :android:installDebug  # Android
./gradlew :desktop:run           # Windows/Linux 桌面版

首次使用：输入 API ID 和 hash；用手机号和登录码登录，或选择 Sign in by QR code（同设备装有 Telegram 时可直接「Confirm in Telegram」，无需扫码）；选择要备份的文件夹；如需加密，开启 Encrypt uploads 并设置恢复口令。

导入已有文件：把频道、群组或 Saved Messages 里的消息转发到 TeleDrive 创建的频道，下次同步后就会出现在应用中。转发在 Telegram 服务器完成，不会重新上传或下载。

注意事项

• 转发导入时，只识别以**文件（document）**形式发送的消息；以普通方式发送的照片和视频已被 Telegram 压缩成媒体消息，会被跳过，应改为转发原始文件。
• TeleDrive 把文件名、文件夹和标记保存在消息说明中，因此对转发文件做首次重命名、移动或删除时，会覆盖原有说明文字。
• 转发文件不会被本地读取，因此不记录校验和，无法参与重复检测，之后再上传同一文件会产生第二份副本。
• 转发进来的文件落在云盘根目录，并且保持未加密状态，需要之后在应用内移入文件夹。
• macOS 构建仅支持 Apple Silicon，因为所用的 Telegram 原生库没有 Intel Mac 版本。
• 桌面端打包使用 jpackage（Android Studio 自带运行时不含该工具），需要在 ~/.gradle/gradle.properties 中通过 desktopJavaHome 指向完整 JDK，再执行 packageMsi、packageDebUser、packageAppImage、packageDmg 等任务。

---

本作品整理自 GitHub 开源项目 Mahmud0808/TeleDrive，原作者 @Mahmud0808，许可证 Apache-2.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。