TG Vault

Telegram 的免费云存储空间很大，但官方并没有提供方便的文件管理界面。如果你想把 Telegram 当作一个真正的私有云盘来用——支持 Web 端管理、多存储后端、甚至自动抓取频道内容——TG Vault 可能就是你要找的工具。

这是一款面向个人和小团队的开源项目，核心思路很简单：用 Telegram 作为传输通道，把文件统一归档到你指定的存储位置。它既支持通过 Bot 接收文件，也支持用 Telegram 用户账号批量抓取频道内容，还能接入 OneDrive、阿里云 OSS 等第三方存储。

它能做什么：六大核心模块

TG Vault 的功能可以拆成六个模块来看：

Web 文件管理
浏览器里就能完成上传、创建文件夹、预览文件、删除等操作。大文件支持分片上传，不用担心浏览器超时。

Telegram Bot 基础能力
给 Bot 私聊发文件，它会自动转存到当前存储源。Bot 还支持任务队列管理、存储统计、文件删除，以及通过 /ytdlp 命令下载视频链接。

Telegram 账号级下载器
需要额外配置 Telegram 用户 session。启用后，可以按日期或标签批量抓取频道/群组的媒体文件，支持订阅同步，大文件下载也更稳定。

yt-dlp 视频下载
直接在 Bot 里发送视频链接，服务器会自动解析并下载到当前存储源。支持 B 站、YouTube 等主流平台。

自动归档
默认按”来源/频道 + 文件类型”自动分类保存。比如从某个频道下载的图片，会自动放进 telegram/channel/images/ 目录下。

多存储源接入
除了本地磁盘，还支持 OneDrive、Google Drive、阿里云 OSS、S3 兼容存储、WebDAV。你可以根据文件类型或来源，灵活选择存储后端。

两种 Telegram 接入方式：Bot 与账号级下载器的区别

这是 TG Vault 设计上的一个关键点，很多人容易混淆。

简单说：如果你只是偶尔给 Bot 发文件、下载几个视频，只配 Bot 就够了。但如果你需要批量备份某个 Telegram 频道的历史内容，或者想自动同步订阅频道的新文件，就必须启用账号级下载器。

部署方式：Docker Compose 六步走

TG Vault 采用前后端分离架构，前端是静态页面，后端是 Node.js 服务，数据库用 PostgreSQL。官方推荐的部署方式是 Docker Compose，大致流程如下：

1. 克隆仓库并进入项目目录
2. 配置环境变量：复制 .env.example 为 .env，填写数据库密码、API 地址、跨域来源等
3. 构建前端镜像：VITE_API_URL 是构建时变量，修改后必须重新构建
4. 构建后端镜像
5. 生成用户 session（可选）：仅在需要账号级下载器时执行
6. 启动服务：docker compose up -d

几个关键环境变量需要注意：

• VITE_API_URL：前端访问后端的公网 API 地址，必须带协议头（如 https://api.yourdomain.com）
• CORS_ORIGIN：允许跨域的前端来源，需与前端公网地址一致
• COOKIE_SECURE：生产环境保持 true，仅本地 HTTP 调试可临时设为 false

安全设计：不是”裸奔”的存储工具

TG Vault 在安全上做了几层防护：

• 首次初始化：服务启动后，首次访问 Web 页面会要求创建管理员密码和 Bot PIN，防止未授权访问
• HttpOnly Cookie：登录成功后，会话信息存储在 HttpOnly Cookie 中，前端不往 localStorage 写 token
• Origin 校验：修改类请求会校验 Origin，防止 CSRF
• 签名 URL：文件访问使用签名链接，有过期时间
• TOTP 双重验证：支持 Google Authenticator 等 TOTP 工具，Web 端和 Bot 端均可配置

另外，项目会在首次启动时自动生成内部密钥，保存在 Docker 数据卷的 /data/secrets/ 目录中。迁移服务器时记得连同 volume 一起备份，否则登录会话、TOTP 密钥和已加密的第三方存储凭证需要重新配置。

Bot 命令速查

基础命令（无需账号级下载器）：

• /start — 身份认证，开始使用
• /help — 查看帮助
• /storage — 查看存储统计，可清理本地文件
• /tasks — 查看实时传输任务队列
• /ytdlp <url> — 解析并下载视频链接
• /delete <ID或序号> — 删除指定文件
• /setup_2fa — 配置双重验证

需要账号级下载器的命令：

• /tg_download — 按日期或标签下载向导
• /tg_sub <频道> — 添加频道/群组订阅
• /tg_subs — 查看订阅列表
• /tg_unsub <频道或订阅ID前缀> — 取消订阅