Telegram Files：自托管的 Telegram 文件下载器

telegram-files 在 GitHub 上已经拿到 2,289 Star 了。

这是一个自托管的 Telegram 文件下载器，专门干一件事——从 Telegram 频道和群组里稳定、持续地下载文件。支持多账号管理、暂停恢复、自动传输，还能即时预览视频和图片。

1、这玩意儿是干嘛的

就一件事：把 Telegram 里的文件自动下载到你指定的地方。

频道和群组里的文件，设置好规则就能自动下载。支持多个 Telegram 账号同时操作，下载可以随时暂停和恢复。下载完的文件会自动传输到你设置的目的地。

2、为什么要用它

用过 Telegram 的人都知道，频道里经常分享各种文件，但 Telegram 自带的下载功能有限制。手动下载费时费力，特别是文件量大的时候。

telegram-files 把这个问题解决了。设置好规则，它就在后台默默干活。下载过程中可以随时暂停，下次继续。下载完的文件自动整理到你指定的位置。

视频和图片下载完可以直接预览，不用再打开其他应用。响应式设计，手机上也能用，还支持 PWA 离线访问。

3、支持哪些功能

• 从 Telegram 频道和群组无缝下载文件
• 支持多个 Telegram 账号同时管理下载
• 随时暂停和恢复下载，自动传输到指定目的地
• 下载的视频和图片可以即时预览
• 响应式设计，支持移动端访问和 PWA 离线使用
• 支持从 Telegram 分享链接获取文件

4、适合哪些人用

• 需要从 Telegram 频道批量下载文件的人
• 想要自托管、不依赖第三方服务的用户
• 需要多账号管理、自动化下载的场景
• 希望在手机上也能访问和管理下载的人
• 需要从 Telegram 分享链接快速获取文件的人

5、技术栈

项目用 JDK 23 和 TypeScript 写的，前端是 npm 管理依赖，后端用 Gradle 构建。Docker 镜像打包好了，直接拉取就能用。

6、安装使用教程

使用前需要先申请 Telegram API ID 和 Hash，在 Telegram API 页面申请。

Docker 部署：

dockerrun-d\--nametelegram-files\--restartalways\-eAPP_ENV=${APP_ENV:-prod}\-eAPP_ROOT=${APP_ROOT:-/app/data}\-eTELEGRAM_API_ID=${TELEGRAM_API_ID}\-eTELEGRAM_API_HASH=${TELEGRAM_API_HASH}\-p6543:80\-v./data:/app/data\ghcr.io/jarvis2f/telegram-files:latest

docker-compose 部署，复制 docker-compose.yaml 和 .env.example 到项目目录，然后运行：

docker-composeup-d

unRaid 用户可以在 Community Repositories 里搜索 telegram-files 安装。

项目还提供了维护工具，可以修复一些历史遗留问题。比如 album-caption 命令修复 0.1.15 版本前相册消息丢失标题的问题，thumbnail 命令修复缩略图清理问题。

注意：不要把服务暴露到公网，因为服务本身没有安全防护。

0.1.15 版本前相册消息丢失标题的问题，thumbnail 命令修复缩略图清理问题。

注意：不要把服务暴露到公网，因为服务本身没有安全防护。