[开源项目] TG-Vault：Telegram 全自动转存 + 私有云存储系统

项目地址：https://github.com/hicocos/tg-vault

大家好，最近把自己二开的一个项目整理开源了，叫 TG Vault。

它的定位比较明确：面向个人和小团队，把 Telegram 里的文件、频道/群组媒体、视频链接下载任务，统一转存到自己可控的私有云存储里，并提供一个 Web 文件管理界面。

如果你平时有这些需求，可能会比较适合：

• Telegram 里经常收文件，想顺手转存到自己的服务器或对象存储
• 频道/群组里有大量媒体，想按日期、标签或订阅方式归档
• 想要一个轻量的 Web 文件管理入口，而不是只靠命令行整理文件
• 想把本地盘、OneDrive、Google Drive、S3/WebDAV 等存储统一接入

它能做什么

Bot 和账号级下载器的区别

这里我特意把两层能力拆开了，避免为了用基础功能就必须登录 Telegram 用户账号。

也就是说，如果你只是想把发给 Bot 的文件转存、看看任务、跑 yt-dlp，不生成用户账号 session 也能用。只有频道/群组批量抓取、订阅同步、大文件下载这些场景，才需要额外启用账号级下载器。

快速部署

1. 克隆仓库

git clone https://github.com/hicocos/tg-vault.git
cd tg-vault

2. 配置环境变量

cp .env.example .env
vi .env

3. 构建前端

set -a
source .env
set +a

docker build \
  --build-arg VITE_API_URL="${VITE_API_URL}" \
  -t tg-vault-frontend:latest \
  ./frontend

4. 构建后端

docker build -t tg-vault-backend:latest ./backend

5. 生成用户账号 session（可选）
   仅在需要账号级 Telegram 下载器时执行

docker compose run --rm --no-deps backend npm run login:telegram-user

6. 启动服务

docker compose up -d

7.反代

8.首次访问前端cloud.example.com 配置前端访问密码以及tgbot的验证密码（强制4位数字）

至此-完成部署

9.后续怎么更新同步上游
先cd到项目目录

git fetch origin
git pull --ff-only origin main

docker compose up -d --build

开源协议

项目基于 MIT License 开源。

GitHub 地址：

https://github.com/hicocos/tg-vault

如果这个项目刚好解决了你的需求，欢迎试用、提 issue，也欢迎顺手点个 Star。后面我也会继续根据自己的使用场景和评论区反馈慢慢补功能和修细节。
本项目基于 https://www.nodeseek.com/post-618525-1 深度二开
ps：部分功能预览放到评论区1f展示

大家有什么优化建议，新增功能，bug都欢迎在评论区留言！