将 Telegram 变为无限云盘的 Teldrive 封装方案，提供高性能 API 与 Web UI，适合技术用户自建私有存储。
说明：
## 核心用法
Telegram Cloud Storage (Teldrive Edition) 是一个将 Telegram 转化为无限云存储的技术封装方案。它通过运行 [Teldrive](https://github.com/tgdrive/teldrive) —— 一个基于 Go 语言开发的高性能工具 —— 将 Telegram 的文件存储能力暴露为本地可访问的 Web 界面和 REST API。
部署流程涉及三个关键步骤：首先配置 PostgreSQL 17+ 数据库并启用 `pgroonga` 扩展以支持文件搜索；其次通过 `./scripts/setup.sh` 生成配置文件 `config.toml`，需填入从 [my.telegram.org](https://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` 和会话哈希若泄露，攻击者可访问全部文件元数据
会员专属
