TG Vault 文档中心 | TG Vault

把 Telegram 变成你的自动化私有云入口。
从 Telegram 或 Web 接收内容，转存到本地磁盘或多个云存储账户，并在同一个 Web 控制台中检索和管理。

本网站记录 TG Vault 当前项目的部署与使用方法。当前版本支持安装脚本快速部署、Web 管理 Telegram Bot 凭据、网页登录账号级下载器、统一任务中心、多存储账户以及完整备份恢复。

从这里开始

🚀 快速部署只改两个地址，使用安装脚本自动生成密钥并启动 Web、API 与 PostgreSQL。 🤖 Telegram在 Web 中连接 Bot、设置 PIN 与允许用户，并登录账号级下载器。 ☁️ 存储源配置配置本地、OneDrive、Google Drive、阿里云 OSS、S3 和 WebDAV。 🔐 安全说明了解首次初始化、Cookie、Origin、TOTP、凭据加密和备份边界。 🧰 运维与恢复更新、健康检查、日志、备份、恢复验证和安全清理。 🧠 工作原理理解服务器中转、任务目标快照、持久化队列和存储写入流程。 💻 GitHub 仓库查看源码、README、提交历史和问题反馈。

能做什么

Web 文件管理：上传、分片续传、文件夹、分类筛选、搜索、收藏、预览、移动、重命名和批量删除。
六类存储目标：本地、OneDrive、Google Drive、阿里云 OSS、S3 兼容存储和 WebDAV，支持多个账户。
Telegram 网页配置：测试并加密保存 Bot 凭据、设置 PIN、维护允许用户，无需编辑 .env 或重启。
账号级下载器：直接在 Web 用手机号、验证码和可选两步验证登录；支持频道/群组抓取、订阅与大文件。
统一任务中心：集中查看 Web 上传、Telegram 和频道任务，并安全取消、重试或移除终态记录。
可恢复任务链路：持久化任务状态，支持暂停、继续、取消、失败重试和服务重启后的恢复。
生产安全基础：首次初始化管理员、HttpOnly Cookie、Origin 校验、TOTP、凭据加密和健康检查。

选择一条使用路径

你的目标	需要配置
只使用 Web 管理文件	基础部署；本地存储开箱即用
让 Bot 接收文件	基础部署 + Web 中配置 Bot Token、API ID/Hash、Bot PIN 和允许用户
抓取频道/群组历史媒体	在 Bot 配置基础上，再从 Web 登录 Telegram 用户账号
自动同步频道新内容	账号级下载器 + `/tg_sub` 订阅
使用 OneDrive/Google Drive	对应平台 OAuth 应用和精确回调地址

重要边界

TG Vault 是自托管服务，GitHub Pages 只托管静态文档，不会替你运行服务。
Web 上传和 Telegram 下载都经过部署 TG Vault 的服务器，需要足够的临时磁盘、带宽和内存。
Bot Token、API Hash、Telegram session 和第三方存储凭据只应在自己的设置页或服务器环境中填写。
生产环境应使用 HTTPS，并在同一维护窗口备份 PostgreSQL 与完整 file-storage 卷。

查看源码 · 提交问题 · MIT License