walkingd/tgto123 repository overview

⁠TgtoDrive

⁠ ⁠

中文 | English⁠

Telegram 交流群：https://telegram.me/TgtoDriveChat⁠

网盘文件管理增强工具：提供网盘转存、盘内影视与音乐整理、STRM 全量与增量生成，以及 Emby / 飞牛影视 / 飞牛音乐反向代理与 302 直链播放。

本软件不提供任何影视、音乐或其他资源。待管理文件、网盘账号与分享链接均由用户自行提供，请仅处理本人拥有或已获得合法授权的内容。

本软件完全免费，后续也不会收费，如果这个项目对你有帮助，请点击右上角 ⭐ Star 支持一下！

⁠主要功能

TgtoDrive 帮助用户管理个人网盘中的已有文件，让转存、整理和媒体库维护更方便。

⁠支持的网盘

⁠快速部署

⁠1. 准备环境

• Docker 20.10+。
• Docker Compose 2.x。
• 一台可长期运行的 NAS / Linux 服务器。
• 如需使用 Telegram 任务通知，请确保容器可以访问 Telegram API。

⁠2. 创建部署目录

mkdir -p tgtodrive
cd tgtodrive
mkdir -p db strm

⁠3. 编写 docker-compose.yml

version: '3'

services:
  tgtodrive-service:
    image: walkingd/tgto123:latest
    container_name: TgtoDrive
    network_mode: host  # 推荐 host 模式以简化端口映射和直链访问
    environment:
      # --- 基础配置 ---
      - TZ=Asia/Shanghai
      # 必填：WEB管理页面的登录账号密码
      - ENV_WEB_PASSPORT=admin
      - ENV_WEB_PASSWORD=password
    volumes:
      # 数据库与日志持久化，右侧固定为/app/db
      - ./db:/app/db
      # STRM输出目录：用于保存 /app/strm 下生成内容,/vol1/1000/Emby/strm 改成你的目录，右侧固定为/app/strm
      - /vol1/1000/Emby/strm:/app/strm
      # [可选] 本地文件秒传目录：左侧改为 NAS 上的个人文件目录，不需要可去掉
      - /path/to/local/files:/app/upload

    restart: always

⁠4. 启动服务

docker-compose pull  # 拉取最新镜像
docker-compose up -d # 后台启动

访问 Web 管理台：

http://你的服务器IP:12366

首次登录使用 docker-compose.yml 中配置的 ENV_WEB_PASSPORT 和 ENV_WEB_PASSWORD。

⁠开始使用

1. 登录 Web 管理台，添加需要使用的网盘账号。
2. 在「全局设置」中按需配置代理、TMDB Key 和任务通知。
3. 使用转存页面保存自己的文件，或为盘内已有文件设置影视、音乐整理目录与规则。
4. 如需接入媒体库，在「STRM 生成」中选择网盘目录并设置播放地址。
5. 如需 302 播放，在「Emby与飞牛反代」中选择服务类型，填写上游地址与监听端口；Emby 需填写 API Key，飞牛音乐需配置本地音乐目录与网盘目录的对应关系。客户端通过反代端口访问服务，非 host 网络需映射该端口。
6. 保存配置后，可在日志和任务记录中查看运行情况。

⁠使用提示

• 整理源目录与目标目录应分开设置，不能相同或互相嵌套；音乐目录也应避开影视源目录的扫描范围。
• 音乐源目录是待整理区：已识别的音频会归档，未识别的音频保留原处，非音乐文件会移入网盘回收站。音乐整理本身不生成 STRM。
• 飞牛音乐播放网盘原文件；本地音乐目录与网盘目录中的文件应保持对应，不支持 NAS 转码播放。
• 无法转存或播放时，请检查网盘登录状态、目录配置及播放地址和端口是否可访问，并查看运行日志。

⁠常用命令

查看运行状态：

docker compose ps

查看日志：

docker compose logs -f

更新镜像：

docker compose pull
docker compose up -d

停止服务：

docker compose down

备份时建议至少保留：

• db/：配置、历史、日志、任务状态。
• strm/：生成的 STRM 媒体库。

⁠使用范围

本项目用于个人网盘文件管理，不提供任何影视、音乐或其他资源。请仅转存、整理和播放本人拥有或已获授权的内容，并遵守相关服务条款。

如果 TgtoDrive 对你有帮助，欢迎 Star 支持，或加入交流群反馈使用体验。