tg-vault

hicocosMIT活跃维护

把 Telegram 频道和群组里的文件自动转存归档，搭成带多存储源的私有云盘，支持向量检索，适合自建媒体库。

Telegram 转存、媒体归档与多存储源私有云系统

v3.0.0发布于 2026-11-08 11:12 UTC286star +4 / 7 天50fork同步于 2026-11-11 00:00 UTC

私有云媒体归档 Telegram转存多存储源向量检索

对比 GitHub 官网 docker-compose file-manager media-archiver pgvector private-cloud

怎么上手

由 README 提炼，执行前请确认

原文

curl -fsSL https://raw.githubusercontent.com/hicocos/tg-vault/main/install.sh | bash

硬件要求按 README 说明

README 未说明具体硬件与显存要求，仅要求 Linux 服务器（Bash 4+、curl、Git）与 Docker Compose。

有 Docker 镜像

下载：源码 zip·GitHub Releases（安装包）本站不镜像安装包

项目说明

由 README 自动翻译提炼

没人工点评？写下你的经验

把 Telegram 文件转存归档到多种存储的私有云系统，支持多账号调度与 Web 管理

把 Telegram 频道和群组里的文件自动转存归档，搭成带多存储源的私有云盘，支持向量检索，适合自建媒体库。

核心能力

多 Telegram 账号按来源权限和状态调度任务
按日期或标签批量下载频道群组并订阅同步
Web 端上传、搜索、文件夹整理与媒体预览
任务支持进度查看、暂停、继续与失败重试
对接本地磁盘、OneDrive、OSS、S3、WebDAV 等存储

容易踩的坑

需准备同一主域名下的 Web/API 两个 HTTPS 域名；频道下载与订阅需有访问权限的 Telegram 用户账号，不绕过官方限制；排障时不要用 docker compose down -v，以免删除数据卷。

内容由模型根据 README 生成，可能不完整或不准确，以官方文档为准。看原文 README

最近发版

5 个版本v3.0.0

全部 release

v3.0.0最新正式版2026-11-08 · 2026-11-08 11:12 UTC
v3.0.0

2026-11-08 · GitHub Release

新增
- MCP AI 接入：支持远程 Streamable HTTP 与本地 stdio，让 AI Agent 搜索文件和目录、读取文本、生成下载与预览链接，以及改名、移动、收藏和删除文件。
- AI 任务与归档：支持查询进度、暂停、继续、取消和重试任务，创建、编辑、启停和同步订阅，并按日期或标签提交 Telegram 历史归档。
- AI 文件上传：支持直接上传、分块上传、断点续传和内容校验，可查询上传状态、核对中断后的结果，减少重复传输。
- 「AI 接入」管理页：可分别设置客户端权限、存储账户和有效期，生成或撤销令牌、验证连接并查看调用记录；写操作支持请求去重与操作预览。
- 一键安装入口：新增根目录 install.sh，支持自动下载项目、指定安装目录和更新已有部署。
- 中文文档站：提供部署、Telegram、存储、MCP 和日常运维教程，支持全文搜索与移动端浏览，可从应用「关于」页直接访问。
改进与修复
- 新增毛玻璃外观，更新深浅色界面与项目标识，统一操作按钮样式并改进「关于」页面。
- 存储账户详情支持直接更新认证信息并保留已有文件关联，修复 OneDrive 凭据刷新覆盖新配置的问题。
- 改进 Telegram 暂停、恢复和归档调度，细化下载、上传、等待上传及重试进度，修正任务目标账户的存储冷却判断。
- 修复并发转存和同名文件写入问题，避免覆盖已有文件；正确保留 %20 等字面文件名及目录中的连续空格、点号。
- Google Drive 删除改为移入回收站，并撤销文件自身的公开分享。
- 修复 OpenList 越界读取被误报为存储不可用的问题，完善 HTTP 416 响应与反代 Range 转发。
- 更新后端安全依赖，修复路径匹配与查询参数相关漏洞，发布检查拦截中危及以上告警。
升级

在项目目录运行：
```
./deploy/install.sh
```
完整变更
v2.6.02026-10-27 · 2026-10-27 10:47 UTC
查看更新说明
更新
- 新增可选同机 qBittorrent 扩展：支持磁力链接、种子文件、文件选择，下载后转存至指定存储；失败可重试，重启后恢复。
- 转存成功后默认清理下载源文件，可选择保留做种；取消会删除下载器任务及源文件，已转存文件不受影响，移除历史只删除记录。
- 下载与转存分别显示实时进度；BT 任务支持搜索、待处理筛选与历史管理。
- 简化存储添加、账号详情与扩展配置，优化移动端操作，并同步中、英、俄文界面。
- 更新 HTTP 安全依赖，修复压缩请求/响应拒绝服务及跨源重定向凭据泄露问题。
升级

先备份 .env、数据库和完整文件数据，再运行 ./deploy/install.sh。qBittorrent 默认关闭，需自行部署下载器并配置只读目录挂载；下载目录不包含在 TG Vault 备份中。详见扩展配置。
v2.5.02026-10-19 · 2026-10-19 15:16 UTC
查看更新说明
更新
- Web 支持直接创建、编辑和恢复频道订阅，配置通知用户、存储及目录；新增按文件类型保存或忽略的订阅规则。
- 改进 Telegram Bot 与下载数据中心的断线恢复，网络中断后从已写入位置续传；隔离清理失败的连接，避免影响其他账号与任务。
- 修复转发文件在重启后因来源实体缓存缺失而无法下载，以及讨论区扫描账号、分页去重与主帖范围判断问题。
- Telegram 文档下载改用 1 MiB 请求，分片并发支持 4、6、8、10、12；完善批量接收、暂存容量、磁盘预留及媒体处理资源限制。
- 修复 OneDrive、Google Drive 分域授权与弹窗回调校验；同一 Microsoft 应用可添加多个独立账户，WebDAV 自动协商 Basic / Digest 认证。
- 数据库改为独立迁移流程，提供状态、计划、迁移和检查命令；应用启动与健康检查不再执行建表或迁移。
- 一键部署默认拉取 GHCR latest 镜像，失败时回退源码构建，支持 amd64 / arm64；API 地址改为前端容器启动时注入，无需重新编译。
- 优化设置、任务、上传与订阅页面的布局和状态提示，显示 Telegram 账号所属 DC；整理中英文说明、部署示例与回归检查。
升级

升级前备份 .env、数据库和完整文件数据，在项目目录运行 ./deploy/install.sh。脚本始终拉取 latest，保留原配置及数据挂载，并在停止旧应用后执行独立数据库迁移；迁移成功才替换前后端，失败时保持应用停止。

手动部署须先运行数据库迁移，不要沿用旧版“后端启动时自动迁移”的流程。详见部署指南。
v2.4.92026-10-16 · 2026-10-16 10:01 UTC
查看更新说明
更新
- Telegram 用户账号下载改为独立子进程运行，完善连接回收、断线重连、取消与 FloodWait 冷却，减少异常连接对其他任务的影响。
- 改进多账号频道访问与扫描，切换账号时校验历史消息和扫描断点的可见性，保留已发现文件；支持为失效账号重新登录并保留原配置。
- 日期与标签批量任务支持扫描后按文件类型选择下载；未选文件单独统计为排除，不再混入跳过数和下载总量。
- 改进相册边界探测、Unicode 标签匹配和讨论区文件扫描，细化扫描与限流等待进度；文件并发可按启用账号数量调整，最高 10 个。
- Web 任务中心可分页查看失败文件、原因及原消息入口；修复下载明细清理、失败重试后的完成数量与容量统计。
- 改进 OneDrive 上传会话续传及 Google Drive 上传重试，校验不确定的上传结果，避免重复创建或误认已保存文件。
- 前端升级至 Tailwind CSS 4，更新依赖并修复开发工具链安全告警；保留主题与组件样式，修复迁移后的字体资源路径。
- 修复可配置 API 端口与前端代理不一致，以及静态资源、SPA 页面和错误响应丢失安全头的问题；CSP 精确允许配置的 API 来源。
- 精简中英文说明与部署文档，清理本地调试产物，完善敏感配置、运行数据与备份的忽略规则；未配置 Docker Hub 凭据时跳过镜像发布。
升级

升级前备份 .env、数据库和完整文件数据，在项目目录运行 ./deploy/install.sh。脚本会自动更新源码、构建镜像并替换前后端容器，无需提前手动拉取源码或镜像；保留原配置、数据库和文件挂载，数据库迁移由后端启动时自动执行。手动部署请使用完整新版镜像或构建产物，不要让新旧后端同时连接同一数据库执行任务。

前端需要现代浏览器。详见部署指南。
v2.4.82026-10-14 · 2026-10-14 03:29 UTC
查看更新说明
更新
- 改进 Telegram 频道下载向导，可在确认前修改频道、日期或标签、目录及评论选项；防止重复提交，创建失败保留草稿。
- 统一 Bot 与 Web 的任务暂停、继续、取消和失败重试，修正排队、下载与暂停状态，以及条目数量、速度和保存位置的显示。
- 日期与标签下载新增频道及评论扫描进度；改进多账号调度、来源权限判断和 FloodWait 后的等待与降速。
- 完成卡保留失败详情和重试入口，服务重启后仍可使用；修复部分失败任务无法正常收尾的问题。
- 存储账户新增配置详情与重命名，凭据仅显示配置状态，不展示密钥。
- 文件夹列表完整显示；切换媒体详情保留播放状态，优化设置、任务页面及中英俄文案。
- 容器构建与后端运行升级到 Node.js 24 LTS，更新兼容依赖。
- Bot 移除 /list、/find，文件浏览与搜索请使用 Web 文件管理。
升级

在项目目录运行 ./deploy/install.sh 即可升级。脚本会自动更新源码、构建镜像并替换前后端容器，无需提前手动拉取源码或镜像。保留原配置、数据库和文件卷；数据库迁移由后端启动时自动执行。详见部署指南。

用户点评

登录用户的真实使用记录，可按版本和硬件筛选

共 0 条

还没有人点评。第一个说出真实体验的人最有价值。

README 原文

未翻译

在 GitHub 打开

TG Vault

Telegram 文件转存与归档工具，支持多个人账号调度、Web 文件管理和多种存储服务。

使用文档 · 快速部署 · 更新日志 · 版本发布

功能概览

Telegram 文件转存、频道/群组按日期或标签批量下载、订阅同步。
多 Telegram 账号调度，按来源权限和账号状态分配任务。
Web 文件上传、搜索、文件夹整理与媒体预览。
Web 与 Bot 任务管理：进度、失败明细、暂停、继续及重试。
本地磁盘、OneDrive、Google Drive、阿里云 OSS、S3、WebDAV 和 OpenList 存储。
管理员密码、Bot 用户允许列表与 TOTP 双重验证。

频道下载与订阅需要有来源访问权限的 Telegram 用户账号，不绕过 Telegram 权限或服务端限制。

账号接入与并发说明见多账号调度。

快速部署

准备 Linux 服务器（Bash 4+、curl、Git）、Docker Compose，以及同一主域名下的 Web/API 两个 HTTPS 域名。

curl -fsSL https://raw.githubusercontent.com/hicocos/tg-vault/main/install.sh | bash

默认下载到当前目录下的 tg-vault 并启动安装向导；在项目根目录运行时复用当前项目。可在管道右侧的 bash 前设置 TG_VAULT_INSTALL_DIR=/opt/tg-vault 指定目录。完整参数见部署指南。

安装器会自动生成部署配置。首次管理员初始化前，限制 Web/API 两个入口仅自己可访问；HTTPS 生效后创建管理员密码，再开放服务。

备份与更新

升级前备份 .env、数据库和完整文件数据，然后在项目目录运行：

curl -fsSL https://raw.githubusercontent.com/hicocos/tg-vault/main/install.sh | bash

脚本更新源码并拉取 latest，保留原配置和数据挂载。详见备份与恢复；不要用 docker compose down -v 排障。

文档

在线使用文档：部署、Telegram、存储接入与日常使用。
文档站源码与发布：专题教程、全文搜索与 Cloudflare Pages 部署。
部署指南：安装、HTTPS、备份、恢复与更新。
配置与使用：环境变量、Telegram、存储与权限。
MCP 与 AI Agent：客户端授权、接入和使用。
本地存储位置：挂载、路径确认与数据保护。
开发与发布：独立开发环境、数据库 CLI、检查命令及公开发布边界。

可选扩展

自行部署同机 qBittorrent 后，可将完成的下载转存到已配置存储，默认清理源文件，也可保留做种。不使用该扩展不影响 Telegram 转存；见配置与使用教程。

开源协议

MIT License · hicocos/tg-vault