介绍
# Telegram Cloud Storage (Teldrive Edition)
此技能运行 [Teldrive](https://github.com/tgdrive/teldrive)，这是一个用于组织 Telegram 文件并提供高速 API/UI 进行访问的强大工具。
## 功能特性 - **无限存储**：使用 Telegram 作为后端。 - **高性能**：使用 Go 编写，针对速度进行了优化。 - **UI 与 API**：包含 Web 界面和 REST API。 - **AI 原生客户端**：包含用于基于代理的文件操作的 `client.py`。
## 致谢 此技能是 [divyam234](https://github.com/divyam234) 开发的 [Teldrive](https://github.com/tgdrive/teldrive) 的封装版本。核心引擎的所有功劳归原作者所有。
## 系统要求 1. **PostgreSQL 数据库**：推荐版本 17+。 2. **pgroonga 扩展**：在 Postgres 中进行文件搜索所必需。 3. **Telegram API**：来自 [my.telegram.org](https://my.telegram.org) 的 App ID 和 Hash。
## 安装
### 1. 数据库设置 确保 Postgres 正在运行并且已安装 `pgroonga` 扩展。 ```sql CREATE DATABASE teldrive; \c teldrive CREATE EXTENSION IF NOT EXISTS pgroonga; ```
### 2. 配置 运行设置脚本以生成 `config/config.toml`： ```bash ./scripts/setup.sh ```
### 3. 启动服务器 ```bash ./scripts/manage.sh start ```
## 代理使用 该技能包含一个用于程序化访问的 Python 客户端。
### 环境变量 - `TELDRIVE_TOKEN`：您的 JWT 令牌（登录后可从 UI 或 `config/token.txt` 获取）。 - `TELDRIVE_SESSION_HASH`：您的 Telegram 会话哈希（位于 `teldrive.sessions` 表中）。
### 命令 ```bash # List files python3 scripts/client.py list /
# Upload a file python3 scripts/client.py upload local_file.txt /remote/path
# Download a file python3 scripts/client.py download <file_id> local_save_path ```
## 目录结构 - `bin/`：Teldrive 二进制文件。 - `config/`：配置模板和生成的配置文件。 - `scripts/`：设置、管理和客户端脚本。 - `logs/`：应用程序日志。