Telegram Drive

Telegram Drive 是一款开源的跨平台桌面应用，核心作用是将你的Telegram账号，直接转变为一个无限容量、高安全性的云存储驱动器。它基于 Tauri、Rust 和 React 三大技术构建，兼顾了性能与易用性，无需依赖第三方服务器，所有操作都直接对接Telegram官方服务器。

什么是 Telegram Drive？

简单来说，Telegram Drive 是一款“借力”Telegram API 开发的工具——它没有自建服务器，而是充分利用Telegram本身强大的云基础设施，让你能够直接在Telegram的服务器上，完成文件的上传、组织、管理等一系列操作。

它最贴心的设计，是将你Telegram账号中的“已保存消息”和你创建的频道，直接当作“文件夹”使用。这意味着，你不需要重新学习新的操作逻辑，用熟悉的文件资源管理器界面，就能轻松管理自己的Telegram云存储内容，上手门槛极低。

核心功能详解

Telegram Drive 的所有功能都围绕“实用、高效、安全”展开，覆盖日常文件管理的核心需求，具体如下：

• 无限云存储：依托Telegram本身的云基础设施，无需担心存储容量限制，可上传各类文件（文档、图片、视频、音频等），满足个人和轻量办公的存储需求。
• 高性能网格视图：采用虚拟滚动技术，即便文件夹中包含数千个文件，也能实现即时加载、流畅浏览，不会出现卡顿、延迟的情况。
• 跨平台自动更新：完美适配Windows、macOS、Linux三大桌面系统，支持无缝自动更新，无需手动下载安装包，始终使用最新版本。
• 媒体流式传输：无需下载视频、音频文件，可直接在应用内流式播放，节省本地存储空间，同时提升观看、收听体验。
• 内置PDF查看器：支持PDF文件直接打开，搭配无限滚动功能，阅读长文档时无需频繁翻页，体验流畅。
• 拖放式操作：支持拖拽文件直接上传，也可拖拽文件调整位置、移动到不同“文件夹”（频道），操作直观高效，符合日常使用习惯。
• 缩略图预览：图片、视频等媒体文件可显示内联缩略图，无需打开文件，就能快速识别内容，节省筛选时间。
• 灵活文件夹管理：可通过创建私人Telegram频道，当作“文件夹”使用，按需分类整理文件（如工作文件、个人照片、视频素材等），条理清晰。
• 隐私优先设计：所有API密钥和个人数据都保存在本地设备，不经过任何第三方服务器，最大程度保障个人隐私和文件安全。
• 原生跨平台支持：针对macOS（Intel/ARM架构）、Windows、Linux系统分别开发原生应用，适配不同系统的操作逻辑，使用体验更流畅。

技术栈解析

Telegram Drive 的稳定运行，离不开一套高效、可靠的技术栈，各组件分工明确，兼顾前端体验与后端性能，具体如下表所示：

快速上手指南（附详细步骤）

想要使用Telegram Drive，需先完成前提条件准备和安装操作，步骤清晰，新手也能轻松完成，具体如下：

（一）前提条件（必看）

在安装和运行Telegram Drive前，需确保你的设备满足以下条件，避免出现安装失败、无法运行的情况：

1. Node.js (v18及以上版本)：作为前端依赖的运行环境，需从Node.js官网下载并安装，安装后可通过终端输入“node -v”验证版本。
2. Rust（最新稳定版）：用于编译Tauri后端，需通过rustup工具安装：
   安装完成后，在终端输入“rustc –version”和“cargo –version”，若能显示版本号，说明安装成功。
   • macOS/Linux系统：打开终端，输入命令 curl \-\-proto \&\#39;=https\&\#39; \-\-tlsv1\.2 \-sSf https://sh\.rustup\.rs \| sh，按照提示完成安装。
   • Windows系统：从rustup.rs官网下载“rustup-init.exe”，运行后按照提示安装即可。
3. 操作系统特定的构建工具：Tauri运行依赖对应系统的构建工具，缺一不可：
   • macOS：需安装Xcode Command Line Tools，打开终端输入 xcode\-select \-\-install，按照提示完成安装。
   • Linux（Ubuntu/Debian）：打开终端，输入命令 sudo apt update \&\& sudo apt install libwebkit2gtk\-4\.1\-dev build\-essential curl wget file libxdo\-dev libssl\-dev libayatana\-appindicator3\-dev librsvg2\-dev，一键安装所需依赖。
   • Windows（重点）：必须安装Visual Studio Build Tools，安装时务必选择“使用C++的桌面开发”工作负载，否则会出现“link.exe not found”错误，导致无法编译。
4. WebView2（仅Windows系统）：Windows 10/11用户通常已预装，若未安装，需从微软官网下载WebView2 Runtime并安装，否则应用无法正常打开。
5. Telegram API 凭证：用于对接Telegram服务器，需自行获取：
   • 登录 my.telegram.org（需科学上网）；
   • 进入“API development tools”，创建一个新应用，即可获取专属的“api_id”和“api_hash”，后续运行应用时需用到。

（二）安装步骤

前提条件满足后，按照以下步骤克隆仓库、安装依赖，即可完成安装：

# 1. 克隆仓库到本地
git clone https://github.com/caamer20/Telegram-Drive.git

# 2. 进入项目目录
cd Telegram-Drive

# 3. 进入app文件夹，安装前端依赖
cd app
npm install

（三）运行开发模式

若想调试应用、查看实时修改效果，可运行开发模式，命令如下：

npm run tauri dev

（四）编译构建

若想生成可直接使用的桌面应用（适配自己的系统），可进行编译构建，命令如下：

npm run tauri build

注意：首次构建时，会自动下载并编译超过300个Rust crate，根据你的设备硬件配置，这个过程可能需要5-15分钟，属于正常情况；后续再次构建时，会复用已编译的文件，速度会大幅提升。

小提示：运行“npm install”时，可能会出现依赖漏洞警告，这些警告大多与构建工具和开发依赖相关，不影响应用正常运行，可选择运行“npm audit fix”修复，也可忽略。