Telegram-115bot 是一个基于 Python 的 Telegram 机器人,用于管理和控制 115 网盘,支持离线下载、视频上传、目录同步等功能,无需直接访问 115 网盘的网页界面。

1. 核心功能
- 基础交互机制:支持基础的离线下载和视频上传。通过
/start 显示帮助界面,/auth 搞定 115 授权设置,遇到问题输入 reload 重载配置,或者用 /q 强制取消当前会话。
- 老司机资源获取:直接打通了找车流水线。使用
/av 指令可以直接按番号下载。
- 自动化追更:提供了
/rss 和 /sm 指令,分别支持标准的 RSS 订阅和电影订阅功能。
- 任务与目录管理:跑报错了用
/rl 查看重试列表;/sync 专门用来同步 115 网盘目录并在本地创建软链接(对接 Emby 或 Plex 做刮削特别好使)。
2. 关键配置要求
要想获得完整的顺滑体验,必须折腾一下它的环境配置:
- 强绑 115 开放平台:官方现阶段卡得严,强烈建议用户去申请 115 开放平台。审核通过后拿到
115_app_id 填进配置文件。如果你实在懒得去申请,那就只能被迫去用历史的旧版本镜像(具体 tag 为 qiqiandfei/115-bot:v2.3.7)。
- 突破 20MB 视频下载限制:由于 Telegram Bot API 的原生限制,默认是无法下载超过 20MB 的视频的。如果你的网盘里全是大体积视频,必须这么操作:先去 Telegram 开发平台申请 API,拿到
tg_api_id 和 tg_api_hash 并填入配置;接着手动跑一下项目提供的 create_tg_session_file.py 脚本,用手机号和验证码搓出一个 user_session.session 文件,最后塞进 config 目录里。(注:嫌麻烦不配这一步机器人也能照样跑,只是大视频传不了,只能处理小文件)。
3. 项目生态与技术底座
- 语言与活跃度:代码库极度纯粹,Python 占比高达 99.5%,采用宽松的 MIT 许可证开源。项目维护得挺勤快,截至 2026 年 2 月,最新版本冲到了 v3.4.1,总共发布了 43 个版本,在 GitHub 攒了 180 个 Stars 和 28 个 Forks。
- 社区反馈:作者建了个专门的 Telegram 讨论群组,遇到玄学 Bug 跑不起来可以直接进去交流反馈。
4. 避坑指南 (注意事项)
- 极度危险的
/sync 同步指令:敲这个命令前必须过脑子!使用目录同步时,它会无脑删除目标目录下的所有文件(甚至包含你的元数据)。瞎配路径的话本地数据直接火葬场。
- 115 官方风控警告:由于 115 官方对 API 滥用抓得很严,大规模的同步操作极易触发 115 网盘的风控机制。作者在声明里再三强调务必谨慎使用,频率别调太高。
- 免责声明:项目仅供学习和研究使用,严禁用于任何商业用途。被 115 封号或者网盘拉黑的风险得你自己全权承担。
项目地址:
https://github.com/qiqiandfei/Telegram-115bot
如果你对这类自动化工具和脚本感兴趣,欢迎到 云栈社区 的相应板块与更多开发者交流心得。
|