telegram-cloud-storage

☁️ 高性能 Telegram 云盘网关

基于 Teldrive 的 Telegram 云存储网关,将 Telegram 频道变成无限网盘,提供 Web UI 和 API 访问,适合需要大容量个人云存储的用户。

收藏
8.8k
安装
2.8k
版本
1.8.0
CLS 安全性认证2026-05-17
点击查看完整报告 >

使用说明

该 Skill 基于 Teldrive 项目,将 Telegram 转化为个人云存储后端。用户通过部署本地服务,利用 Telegram 的无限存储空间作为底层存储介质,同时提供高性能的 Web 管理界面和 RESTful API。安装需要配置 PostgreSQL 数据库(17+ 版本)并安装 pgroonga 扩展用于文件检索,同时需要从 my.telegram.org 获取 Telegram API 凭据。部署完成后,用户可通过浏览器访问本地 8080 端口管理文件,或使用内置的 Python 客户端进行程序化操作,包括文件上传、下载、列表查看等功能。

显著优点方面,首先利用 Telegram 作为存储后端理论上提供无限容量,突破了传统网盘的空间限制。其次,Teldrive 采用 Go 语言开发,针对高并发和高速传输进行了优化,性能表现优异。第三,提供双模式访问:既有人性化的 Web UI 供日常管理,也有完善的 REST API 和 Python 客户端支持自动化操作,特别适合 AI Agent 集成。此外,文件组织结构清晰,支持目录层级管理,且依赖版本严格锁定(v1.8.0),避免了版本漂移问题。

潜在缺点或局限性方面,该方案存在几个明显局限。一是部署门槛较高,需要用户自行维护 PostgreSQL 数据库,包括安装特定扩展和进行性能调优,对非技术用户不够友好。二是依赖 Telegram 账号体系,存在因账号封禁导致数据访问风险的可能。三是核心功能依赖第三方预编译二进制文件(Teldrive),虽然开源但需信任 GitHub Release 的构建产物。四是作为 T3 来源的社区项目,缺乏企业级 SLA 保障和长期维护承诺。最后,所有元数据存储在本地 Postgres 中,需要用户自行负责备份,否则可能丢失文件索引。

适合的目标群体主要面向三类用户:技术爱好者和开发者,需要大容量个人云存储且具备 Linux/数据库运维能力;自动化需求用户,需要通过 API 批量管理文件或集成到现有工作流;隐私敏感用户,希望数据存储在 Telegram 而非商业云盘,同时需要本地管理界面。不适合追求一键部署的普通用户或需要企业级支持的生产环境。

使用风险方面,性能上依赖本地数据库查询速度和 Telegram 服务器的网络延迟,大文件传输可能受限于 Telegram API 的速率限制。安全层面,虽然代码本身通过安全审计,但需妥善保管 Telegram API 凭据和 JWT Token,避免泄露导致账号风险。运维层面,需要定期备份 PostgreSQL 数据库,否则服务崩溃可能导致文件索引丢失(虽然文件本身仍在 Telegram)。此外,Telegram 的服务条款变更可能影响此类第三方工具的长期可用性。

安全解读

核心用法

Telegram Cloud Storage 是 Teldrive 的轻量级封装 Skill,将 Telegram 转化为无限容量的个人云存储后端。部署后,用户可获得:

  • Web 管理界面:直观的文件浏览、上传、下载操作
  • REST API:标准化接口供第三方应用调用
  • AI 原生客户端:内置 client.py,支持 Agent 执行 list/upload/download 等程序化文件操作

部署流程简洁:配置 PostgreSQL 17+ 数据库并启用 pgroonga 扩展 → 运行交互式配置脚本获取 Telegram API 凭证 → 启动服务即可在本地 localhost:8080 访问。

显著优点

1. 成本优势:利用 Telegram 免费消息存储空间,理论上无限容量,零月费
2. 性能优异:核心引擎 Teldrive 采用 Go 编写,针对高并发文件传输优化

3. 生态成熟:Teldrive 为 GitHub 2.8k+ Stars 的活跃开源项目,社区维护积极

4. 隐私可控:数据存储于个人 Telegram 账号,非第三方商业云服务,配合本地部署实现数据主权

5. AI 就绪:专用 Python 客户端让大语言模型可直接操作文件,无需人工介入

潜在局限

  • 依赖门槛:需自行维护 PostgreSQL 数据库及 pgroonga 扩展,对非技术用户不够友好
  • 单点依赖:文件可用性与 Telegram 账号状态强绑定,存在平台政策风险
  • 无原生校验:二进制文件从 GitHub Releases 动态下载,当前未内置 SHA256/GPG 校验(建议用户手动验证)
  • 功能边界:专注于文件存储,无协作编辑、版本控制等高级云盘功能

适合人群

  • 技术爱好者与开发者,具备 Linux/数据库基础运维能力
  • 追求隐私、抗拒商业云订阅的个人用户
  • 需为 AI Agent 构建低成本持久化存储的自动化工作流设计者
  • Telegram 重度用户,希望统一管理分散的媒体文件

常规风险

  • 凭证管理:Telegram App ID/Hash 及 JWT Secret 若配置不当存在泄露风险,建议配置文件设 600 权限
  • 合规灰色地带:大量使用 Telegram 作为存储后端可能触及平台服务条款
  • 数据持久性:Telegram 账号封禁将导致数据不可访问,需额外备份策略
  • 网络依赖:文件上传下载速度受 Telegram 服务器地理位置及网络质量影响

telegram-cloud-storage 内容

config文件夹
scripts文件夹
手动下载zip · 5.4 kB
config.template.tomltext/plain
请选择文件