如何用TgtoDrive搭建全自动化网盘媒体库:从资源发现到Emby播放
【免费下载链接】TgtoDrive一条龙网盘媒体自动化平台:从找资源、自动转存、智能整理、挂载 STRM、到 Emby 302 直链播放,全流程打通;重点强化 115 / 123 / 光鸭云盘整理与转存、115 / 123 /光鸭云盘 STRM 全量与增量生成、以及 Emby 反向代理 302 播放能力。项目地址: https://gitcode.com/gh_mirrors/tg/TgtoDrive
TgtoDrive是一款功能强大的网盘媒体自动化平台,能够实现从资源发现、自动转存、智能整理、STRM生成到Emby 302直链播放的全流程打通。对于技术爱好者和进阶用户来说,这款工具解决了网盘资源管理的核心痛点,让个人媒体库的构建和维护变得前所未有的高效。
问题:网盘资源管理的三大挑战
在当前的数字媒体时代,许多用户面临着相似的困境:
- 资源分散难管理:资源分散在多个网盘和频道中,手动整理耗时耗力
- 媒体库构建复杂:需要将网盘资源转换为Emby/Plex等媒体库可识别的格式
- 播放体验不佳:网盘直连播放不稳定,需要更优的播放链路方案
TgtoDrive正是为解决这些挑战而生,通过自动化流水线将网盘资源转化为可直接播放的媒体库。
解决方案:TgtoDrive的核心架构
TgtoDrive采用模块化设计,主要分为四个核心模块:
- 资源发现模块:通过Telegram频道监控、聚合搜索等方式自动发现资源
- 转存整理模块:支持115、123、光鸭等多云盘自动转存和智能整理
- STRM生成模块:将网盘文件转换为媒体库可识别的STRM格式
- 播放优化模块:通过Emby反代实现302直链播放,提升播放体验
各云盘支持能力对比
| 功能模块 | 115网盘 | 123云盘 | 光鸭云盘 | 天翼云盘 |
|---|---|---|---|---|
| 账号登录 | Cookie/扫码 | Token登录 | Token登录 | 账号密码 |
| 频道监控 | ✓ | ✓ | ✓ | ✓ |
| 链接转存 | ✓ | ✓ | ✓ | ✓ |
| 网盘整理 | ✓ | ✓ | ✓ | ✗ |
| STRM生成 | ✓ | ✓ | ✓ | ✗ |
| 离线下载 | ✓ | ✓ | ✓ | ✗ |
| 跨盘秒传 | ✓ | ✓ | ✗ | ✗ |
实施步骤:从零开始搭建自动化媒体库
第一步:环境准备与部署
首先克隆项目并准备部署环境:
git clone https://gitcode.com/gh_mirrors/tg/TgtoDrive cd TgtoDrive创建必要的目录结构:
mkdir -p tgtodrive cd tgtodrive mkdir -p db downloads strm编写Docker Compose配置文件,这是项目部署的核心:
version: '3' services: tgtodrive-service: image: walkingd/tgto123:latest container_name: TgtoDrive network_mode: host environment: - TZ=Asia/Shanghai - ENV_WEB_PASSPORT=admin - ENV_WEB_PASSWORD=password volumes: - ./db:/app/db - /path/to/your/strm:/app/strm - ./downloads:/app/downloads - /path/to/local/files:/app/upload restart: always启动服务:
docker-compose pull docker-compose up -d服务启动后,通过http://你的服务器IP:12366访问Web管理界面。
第二步:核心账号配置
登录Web管理台后,首先需要配置各云盘账号:
115网盘账号配置
在左侧导航栏进入"115网盘配置" → "115账号配置",这里需要配置:
- Cookie登录:从浏览器获取115网盘Cookie
- 扫码登录:使用手机115App扫码快速登录
- 空间控制:设置TgtoDrive可使用的空间配额
技术要点:Cookie失效周期约为30天,建议定期检查更新或使用扫码登录方式。
123云盘账号配置
进入"123云盘配置" → "123账号配置":
- Token配置:通过账号密码登录获取访问Token
- 目录设置:指定默认转存目录
- 状态检测:实时显示账号连接状态
光鸭云盘登录配置
在"光鸭云盘" → "登录与Token"中:
- 输入手机号获取验证码
- 填写验证码完成登录
- 系统自动保存Access Token和Refresh Token
注意:光鸭云盘的Token有效期较长,但建议定期检查连接状态。
第三步:资源监控与自动转存
配置好账号后,下一步是设置资源自动发现机制:
频道监控配置
以115网盘为例,进入"115频道监控配置":
关键配置项:
- 频道ID:Telegram频道或群组的ID
- 保存目录:转存资源的目标路径
- 关键词白名单:只转存包含指定关键词的资源
- 黑名单规则:过滤不需要的资源类型
- 二次分类:根据关键词自动分类到不同目录
最佳实践:建议为不同类型资源设置不同的监控规则,如:
- 电影类:关键词包含"1080p"、"4K"、"BluRay"
- 剧集类:关键词包含"S01"、"Season"、"完结"
- 动漫类:关键词包含"动漫"、"动画"、"番剧"
链接转存配置
链接转存功能支持:
- 彩虹链接:特殊格式的分享链接
- 115链接:标准115分享链接
- 自动解析:自动识别链接中的资源信息
- 批量处理:支持多个链接同时转存
第四步:智能整理与分类
资源转存后,需要智能整理才能成为真正的媒体库:
网盘整理功能配置
整理功能的核心配置:
扫描目录设置
- 源目录:待整理的资源目录
- 目标目录:整理后的归档目录
- 注意:源目录和目标目录不能相同,避免循环整理
识别规则配置
- TMDB自动识别:根据文件名匹配影视元数据
- 自定义正则:针对特殊命名格式的匹配规则
- AI辅助识别:对无法自动识别的文件进行AI分析
分类策略
- 主分类:电影/剧集/动漫/纪录片/综艺
- 地区二级分类:国产/欧美/日韩/其他
- 年份分类:按发行年份自动归档
洗版规则
- 杜比优先:优先保留杜比视界版本
- 画质优先:优先保留4K、1080p等高画质版本
- 文件大小优先:按文件大小选择保留版本
技术实现:整理功能基于v6.6.4(最新版请在docker安装)/目录下的Python脚本实现,如tgto115.py、tgto123.py等,通过TMDB API进行元数据匹配。
第五步:STRM生成与媒体库集成
整理好的资源需要转换为媒体库可识别的格式:
STRM生成配置
STRM生成的关键参数:
| 参数 | 说明 | 建议值 |
|---|---|---|
| 来源目录 | 整理后的资源目录 | /整理完成/电影 |
| 输出目录 | STRM文件生成位置 | /app/strm/movies |
| 播放基础地址 | 网盘直链前缀 | 根据云盘类型自动生成 |
| 增量更新 | 只更新变化的文件 | 开启 |
| 元数据同步 | 下载字幕、封面等 | 按需开启 |
技术细节:
- 115网盘:使用pickcode生成直链
- 123云盘:使用fileid生成直链
- 光鸭云盘:使用
/playgy/{file_id}格式 - 增量更新:通过对比文件哈希值判断变化
Emby反代配置
Emby反代是实现302直链播放的关键:
基本配置
- Emby服务器地址:你的Emby服务地址
- API密钥:Emby管理后台获取
- 监听端口:反代服务端口(默认12367)
播放优化
- 302重定向:直接返回网盘直链
- 失败回退:播放失败时自动切换源
- 缓存策略:合理设置缓存减少重复请求
多实例支持
- 支持配置多个Emby实例
- 每个实例独立配置
- 卡片式管理界面
高级技巧与故障排除
1. 多网盘协同策略
对于拥有多个网盘账号的用户,建议采用以下策略:
- 主存储盘:选择空间大、速度稳定的网盘作为主存储
- 备份盘:使用另一个网盘进行重要资源备份
- 冷存储:将不常访问的资源移至成本较低的网盘
2. 性能优化建议
| 优化项 | 建议配置 | 效果 |
|---|---|---|
| 扫描间隔 | 电影:24小时,剧集:6小时 | 减少API调用 |
| 并发数 | 115:3,123:5,光鸭:2 | 避免被封禁 |
| 缓存时间 | 元数据:7天,直链:1小时 | 提升响应速度 |
| 日志级别 | 生产环境:WARNING | 减少磁盘占用 |
3. 常见问题解决
频道监控无反应
- 检查Telegram API连通性
- 验证频道ID是否正确
- 确认关键词规则设置合理
- 查看日志中心的具体错误信息
STRM生成但无法播放
- 检查网盘账号状态
- 验证STRM播放地址可访问性
- 确认Emby反代服务正常运行
- 检查防火墙端口配置
整理功能识别错误
- 调整TMDB匹配阈值
- 添加自定义正则规则
- 使用AI辅助识别
- 手动修正错误识别项
4. 自动化运维脚本
TgtoDrive提供了丰富的Python脚本用于高级运维:
# 查看项目中的脚本文件 ls v6.6.4(最新版请在docker安装)/*.py # 主要脚本功能: # - server.py: 主服务程序 # - tgto115.py: 115网盘相关功能 # - tgto123.py: 123云盘相关功能 # - tgto189.py: 天翼云盘相关功能 # - content_check.py: 内容检查脚本 # - danmu.py: 弹幕相关功能5. 数据备份策略
必须备份的目录:
db/:包含所有配置、任务状态和历史记录strm/:生成的STRM媒体库文件
建议备份频率:
- 配置变更:立即备份
- 日常运行:每天增量备份
- 完整备份:每周一次
最佳实践总结
通过TgtoDrive搭建自动化网盘媒体库,你可以获得以下优势:
- 全流程自动化:从资源发现到播放,无需人工干预
- 多云盘支持:115、123、光鸭、天翼全面覆盖
- 智能整理:基于TMDB的精准识别和分类
- 高效播放:302直链减少中间代理环节
- 可扩展架构:模块化设计便于功能扩展
核心配置建议:
- 首次使用按"全局设置 → 账号配置 → 频道监控 → 网盘整理 → STRM生成 → Emby反代"顺序配置
- 为不同类型资源设置独立的监控规则和整理策略
- 定期检查日志中心,及时处理异常情况
- 合理设置扫描间隔,避免对网盘API造成过大压力
TgtoDrive将复杂的网盘资源管理流程简化为几个简单的配置步骤,让技术爱好者能够专注于内容消费而非技术维护。无论是个人媒体库建设还是小团队资源共享,这套自动化方案都能显著提升效率和使用体验。
【免费下载链接】TgtoDrive一条龙网盘媒体自动化平台:从找资源、自动转存、智能整理、挂载 STRM、到 Emby 302 直链播放,全流程打通;重点强化 115 / 123 / 光鸭云盘整理与转存、115 / 123 /光鸭云盘 STRM 全量与增量生成、以及 Emby 反向代理 302 播放能力。项目地址: https://gitcode.com/gh_mirrors/tg/TgtoDrive
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考