登录 注册
开发者工具 filesharingfilesystemfileuploaderimageimagesimageserver
466
Stars
94
Forks
4
Watchers
20
Open Issues
MIT
许可证
Vue
语言
2024-09-26
创建时间
2026-10-28
最近更新

项目能做什么

基于 Telegram Bot 的文件上传、分享、图床与网盘系统。
来源:AI 基于仓库事实生成 · 内容以仓库实际 README 为准

使用说明 查看原始 README 原仓库文档

中文使用说明暂未生成。下面保留原仓库 README 摘录,命令与配置均以原文为准。
原始 README 摘录(英文原文,节选前 3000 字符)
# tgDrive - 无限容量和速度的网盘

![GitHub release (latest by date)](https://img.shields.io/github/v/release/SkyDependence/tgDrive)
![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/SkyDependence/tgDrive/release-stable.yml)
![Docker Pulls](https://img.shields.io/docker/pulls/nanyangzesi/tgdrive?style=flat&logo=docker)
![Docker Image Size](https://img.shields.io/docker/image-size/nanyangzesi/tgdrive/latest)
![GitHub stars](https://img.shields.io/github/stars/SkyDependence/tgDrive)
![GitHub forks](https://img.shields.io/github/forks/SkyDependence/tgDrive)
![GitHub issues](https://img.shields.io/github/issues/SkyDependence/tgDrive)
![GitHub license](https://img.shields.io/github/license/SkyDependence/tgDrive)
[![tg-qun](https://img.shields.io/static/v1?label=TG%E7%BE%A4&message=TgDrive&color=blue)](https://t.me/+nhHtap9IYbVhOTM1)
[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/SkyDependence/tgDrive)

**tgDrive** 是一款使用 Java 开发的基于 Telegram Bot 的网盘应用,支持不限容量和速度的文件存储。通过多线程技术和优化的传输策略,为用户提供高效、可靠的云存储解决方案。

## 目录


- [功能特点](#功能特点)
- [快速开始](#快速开始)
- [部署方式](#部署方式)
  - [Docker Compose 部署](#docker-compose-部署)
  - [Docker 部署](#docker-部署)
  - [自部署](#自部署)
  - [Render 部署](#render-部署)
- [使用说明](#使用说明)
- [进阶配置](#进阶配置)
  - [WebDAV 配置](#webdav-配置)
  - [PicGo 配置](#picgo-配置)
  - [反向代理](#反向代理)
- [支持与反馈](#支持与反馈)

## 功能特点

### 核心功能

- 🚀 **突破限制**:完全突破 Telegram Bot API 的 20MB 文件大小限制
- 📈 **多线程传输**:采用多线程上传下载技术,最大化利用带宽资源
- 🔗 **外链支持**:支持图片外链功能,可直接在浏览器中访问和预览
- 🖼️ **图床集成**:完美支持 PicGo 图床工具,提供便捷的图片托管服务
- 🎯 **GIF 优化**:解决 Telegram 自动将 GIF 转换为 MP4 的问题
- 🌐 **WebDAV 支持**:提供 WebDAV 接口,支持第三方客户端(如 WinSCP、AList)进行文件管理和操作

### 用户功能

- **文件上传**:支持拖拽上传、多文件上传、粘贴上传(Ctrl+V)
- **文件管理**:文件列表展示、文件预览、文件下载
- **用户账户**:用户注册、登录、密码修改
- **进度跟踪**:实时显示上传进度,支持 WebSocket 进度推送
- **主题切换**:支持亮色/暗色/跟随系统主题模式

### 管理员功能

- **配置管理**:Bot Token 配置、系统设置管理
- **用户管理**:用户列表查看、用户权限管理
- **文件管理**:所有文件统一管理、文件删除
- **数据备份**:数据库备份功能
- **机器人保活**:Telegram Bot 保活配置
- **WebDAV 配置**:WebDAV 服务开关和权限配置
- **系统监控**:实时查看系统状态和运行情况

### 技术特性

- ⚡ **高性能**:基于 Java 17+ 开发,确保稳定性和性能
- 🐳 **容器化**:提供 Docker 支持,简化部署和维护流程
- 💾 **数据持久化**:使用 SQLite 数据库,支持数据持久化存储
- 🔄 **API 支持**:提供完整的 RESTful API 接口
- 🔒 **安全认证**:基于 Sa-Token 的用户认证和权限管理
- 📱 **响应式设计**:支持桌面端和移动端访问
- 🌐 **WebDAV 协议**:完整的 WebDAV 协议实现,支持文件操作

## 快速开始

### 在线体验

- [Render 部署站点](https://render.skydevs.link)
- [演示站点](https://server.skydevs.link)

### 相关资源

- 前端代码:[tgDriveFront](https://github.com/SkyDependence/tgDrive-front)
- 最新版本:[Releases](https://github.com/SkyDependence/tgDrive/releases)

## 部署方式

### Docker Compose 部署

>[!TIP]
>📌 **注意**:如果服务器内存较小(RAM ≤ 512MB),建议使用 `nanyangzesi/tgdrive:server-latest` 镜像

1. 创建 `docker-compose.yml` 文件:

   ```yaml
   services:
   tgdrive:
      image: nanyangzesi/tgdrive:latest
      container_name: tgdrive
      ports:
         - "8085:8085"
      volumes:
         - ./db:/app/db
      restart: always
   ```

2. 启动服务:

```bash
docker-compose up -d
```

#### 更新镜像

使用数据卷挂载后,每次更新镜像时,只需拉取镜像并重新启动容器即可,数据库数据不会丢失:

```bash
d
阅读完整原文

项目深度分析 AI 生成

高阶防风控与多Bot集群插件/企业版

产品构想在开源单 Bot 基础上,提供多 Token 轮询、负载均衡、流量混淆及自动切片热备的企业/专业版扩展,防止单一 Telegram 账号/Bot 被封禁导致数据失效。
核心功能多Bot轮询负载均衡、分布式文件切片加密存储、Bot存活自动替换、自动化冷备迁移工具。
目标用户存储重要数据或高频外链图床调用的极客与小微团队。
难度/周期中等 · 3-5周 · 成本:极低(主要是开发与多账号测试环境成本)
收费模式采用 Open-Core 模式,高级集群/防封模块按买断授权或年付订阅收费。
竞争风险Telegram 官方可能随时封禁滥用 API 作网盘的 Bot 或账号;存在数据永久丢失的技术与平台政策风险。
依据 已验证事实

全托管云端多媒体中转与图床 SaaS

产品构想为普通创作者/博主提供免部署、开箱即用的 WebDAV 与 PicGo 云服务,底层采用官方 API 代理,封装海外 CDN 与高可用节点。
核心功能一键获取 PicGo API、全球 CDN 缓存加速、多媒体在线格式转换、WebDAV 免配置挂载。
目标用户不具备 VPS 部署能力的自媒体创作者、独立博主、笔记工具(Obsidian/Notion)重度用户。
难度/周期较高 · 1-2个月 · 成本:中等(海外服务器与 CDN 带宽消耗成本)
收费模式按月订阅制(提供免维护空间、高速 CDN 流量包)。
竞争风险TG 流量出口合规风险、版权黑灰产上传滥用、平台 TOS 封杀导致运营中断。
依据 AI推测

NAS 与本地生态定制化扩展及技术支持服务

产品构想针对群晖、极空间、Unraid 等 NAS 用户,提供专属集成套件(SPK/一键模板)与企业技术支持,打通本地与 TG 云端的自动冷备份。
核心功能NAS 专用插件、自动化增量冷备份、WebDAV 挂载优化、文件元数据本地索引与秒级恢复。
目标用户NAS 重度玩家、需要廉价冷数据异地容灾备份的个人与工作室。
难度/周期低 · 2-3周 · 成本:极低(个人设备测试即可)
收费模式应用中心付费买断、赞助者专属版本、一对一远程部署咨询服务费。
竞争风险市场规模较垂直小众,用户群普遍崇尚开源白嫖,付费转化率不稳定。
依据 尚需验证的假设
AI 基于仓库公开数据分析生成,含推测成分,不构成收益承诺。
报告会保存到 个人中心

竞品与相似项目 GitHub Search 真实检索

相似项目数据正在完善中,暂不展示(避免误导)

项目优势与风险

技术成熟度创建于 2024-09-26,近 30 天仍在推送,发布过 13 个 Release
社区活跃Star 466 / Fork 94 / Issue 20(数据支持,可自行核实)
许可证MIT
主要风险上游项目方向可能变化;同赛道竞争者较多(见竞品表);热度与需求不完全等价

安装与使用

此项目未提供 Docker 镜像,安装步骤以原仓库 README 为准(涉及依赖安装与环境配置,对新手门槛较高)。