monxas/putio-torrent-monitor

Put.io Torrent Monitor

概述

Put.io Torrent Monitor是一个简单的torrent监控工具，用于监视指定文件夹（黑洞文件夹）中的新torrent文件，并自动将其上传到Put.io账户。该工具通过Docker容器化部署，便于快速集成到现有工作流中。

核心功能与特性

• 文件夹监控：使用watchdog库实时监控指定文件夹的新torrent文件
• 自动上传：检测到新torrent文件后自动上传至Put.io账户
• 容器化部署：支持Docker和Docker Compose部署，简化环境配置
• 灵活配置：通过环境变量自定义Put.io上传目标文件夹和认证信息

使用场景与适用范围

• 个人媒体服务器自动化管理
• 需要定期上传torrent文件到Put.io的用户
• 希望简化torrent文件上传流程的场景
• 媒体内容自动同步到Put.io云存储

环境要求

• Docker
• Docker Compose
• Put.io账户（需获取OAuth令牌）

使用方法

Docker构建与运行

1. 构建镜像

bash
docker build -t putio-torrent-monitor .

2. 运行容器

bash
docker run -it -v /path/to/your_blackhole_folder:/data/torrents -e PUTIO_OAUTH_TOKEN='your_token' -e PARENT_ID='your_parent_id' docker.xuanyuan.run/putio-torrent-monitor

Docker Compose部署

1. 创建docker-compose.yml文件

yaml
version: '3'
services:
  torrent-monitor:
    image: docker.xuanyuan.run/monxas/putio-torrent-monitor:latest
    volumes:
      - /path/to/your_blackhole_folder:/data/torrents
    environment:
      - PARENT_ID=your_folder_parent_id_here
      - PUTIO_OAUTH_TOKEN=your_token_here

2. 启动服务

bash
docker-compose up

环境变量说明

• PUTIO_OAUTH_TOKEN: Put.io账户的OAuth令牌，用于认证API访问
• PARENT_ID: Put.io中的目标文件夹ID，新torrent文件将上传至此文件夹

工作原理

该工具通过watchdog库监控挂载的/data/torrents目录（对应宿主机的黑洞文件夹）。当检测到新的torrent文件时，工具会使用提供的OAuth令牌调用Put.io API，将文件上传到指定的PARENT_ID对应的文件夹中。整个过程自动完成，无需人工干预。