把 Telegram 变成你的私人无限云盘

将 Telegram 变为无限云盘的 Teldrive 封装方案，提供高性能 API 与 Web UI，适合技术用户自建私有存储。

基本信息

• 技能名称?Telegram Cloud Storage
• 中文名称?把 Telegram 变成你的私人无限云盘
• 作者?oki3505f
• 分类?专业技能
• 版本?1.8.2
• 标签?telegram, cloud-storage, self-hosted, teldrive, postgresql, go, api-wrapper, unlimited-storage

使用方法

使用说明
核心用法
Telegram Cloud Storage (Teldrive Edition) 是一个将 Telegram 转化为无限云存储的技术封装方案。它通过运行 Teldrive —— 一个基于 Go 语言开发的高性能工具 —— 将 Telegram 的文件存储能力暴露为本地可访问的 Web 界面和 REST API。
部署流程涉及三个关键步骤：首先配置 PostgreSQL 17+ 数据库并启用 pgroonga 扩展以支持文件搜索；其次通过 ./scripts/setup.sh 生成配置文件 config.toml ，需填入从 my.telegram.org 获取的 Telegram API ID 和 Hash；最后启动服务即可通过 Web UI 或 Python 客户端 client.py 进行文件操作。
AI 原生支持是本方案的亮点之一。 client.py 支持程序化列出目录、上传下载文件等操作，配合 JWT Token（ TELDRIVE_TOKEN ）和 Telegram 会话哈希（ TELDRIVE_SESSION_HASH ）可实现无人值守的自动化文件管理。
显著优点
存储成本极低 ：利用 Telegram 免费账户理论上无限存储的特性，适合大容量冷数据备份
性能优化 ：Teldrive 使用 Go 编写，针对高并发文件传输做了优化
双模访问 ：同时提供面向人类的 Web UI 和面向机器的 REST API / Python SDK
开源透明 ：核心引擎 Teldrive 开源，可自行审计代码
潜在缺点与局限性
合规与封禁风险 ：违反 Telegram ToS 的存储滥用可能导致账户永久封禁
架构复杂度高 ：需要自行维护 PostgreSQL + 扩展，对非技术用户门槛较高
单点依赖 ：文件元数据存储于本地 Postgres，若数据库丢失且未备份，文件映射关系将彻底丢失（Telegram 中文件仍存在但无法索引）
功能边界 ：Telegram 单文件 2-4GB 限制（视账户类型）仍然存在，超大文件需分片处理
隐私悖论 ：文件上传至 Telegram 服务器，虽可加密但默认不保证端到端隐私
适合人群
技术能力较强的开发者、运维人员
需要低成本大容量存储的冷数据归档场景
熟悉 Docker/容器化部署、具备数据库管理经验的自建服务爱好者
愿意承担账户风险换取存储成本优势的早期采用者
常规风险

1. 账户安全 ：Telegram 官方明确禁止 API 滥用，大规模自动化上传可能触发风控
2. 数据持久性 ：Telegram 不保证文件永久保存，长期未访问的文件可能被清理
3. 架构单点 ：Postgres 数据库成为关键故障点，需建立独立的备份策略
4. Token 泄露 ： TELDRIVE_TOKEN 和会话哈希若泄露，攻击者可访问全部文件元数据