简体中文 | English
TG Vault
Telegram file transfer and archiving with web file management and multiple storage providers.
Quick start · Deployment guide · Changelog · Releases
Features
- Telegram file transfers, channel/group batch downloads by date or tag, and subscription sync.
- Web uploads, search, folder organization and media previews.
- Web and Bot task management: progress, failure details, pause, resume and retry.
- Local disk, OneDrive, Google Drive, Aliyun OSS, S3, WebDAV and OpenList storage.
- Optional same-host qBittorrent extension: transfer completed downloads to configured storage, then clean up source files or retain them for seeding.
- Administrator password, Bot user allowlist and TOTP two-factor authentication.
Channel downloads and subscriptions require a Telegram user account with source access. TG Vault does not bypass Telegram permissions or server limits.
Quick start
Prepare a Linux server, Docker Compose, and Web/API HTTPS domains under the same parent domain.
git clone https://github.com/hicocos/tg-vault.git
cd tg-vault
./deploy/install.sh
For a fresh installer run, do not copy .env.example first; the installer generates deployment configuration. Restrict both Web/API endpoints to your own access until HTTPS is active and you have created the administrator password.
Backup and updates
Back up .env, the database and complete file data before upgrading, then run from the project directory:
./deploy/install.sh
The script updates source and pulls latest, retaining existing configuration and data mounts. See backup and recovery. Do not troubleshoot with docker compose down -v.
Documentation
- Deployment guide (Chinese): installation, HTTPS, backups, recovery and updates.
- Configuration and usage (Chinese): environment variables, Telegram, storage and permissions.
- Local storage locations (Chinese, with an English summary): mounts, path verification and data protection.
- Development and publishing (Chinese): isolated development, database CLI, checks and publication boundaries.