pt-tools

pt-tools

pt-tools 是一个功能强大的 PT（Private Tracker）站点自动化管理工具，提供 RSS 订阅自动下载、多站点种子搜索、用户信息统计、下载器管理等功能，帮助用户高效管理多个 PT 站点。

功能特性

免费结束自动暂停

针对 PT 站点免费种子的智能管理功能，帮助用户在免费期结束前避免产生不必要的下载量消耗。

工作原理：

1. RSS 订阅下载免费种子时，系统自动记录种子的免费结束时间
2. 为每个种子创建独立定时器，在免费结束时刻精确触发检查
3. 免费期结束时，自动检测下载进度，暂停未完成的任务
4. 已完成的种子不受影响，继续正常做种

功能特点：

• 精确定时：独立定时器 + 周期检查双重机制，支持应用重启后自动恢复监控
• 智能判断：仅暂停未完成任务，已完成任务继续做种
• 手动恢复：支持在 Web 界面手动恢复暂停的任务（不再受免费限制）
• 批量管理：支持批量删除暂停任务，可选是否同时删除数据文件
• 历史归档：查看历史暂停记录和处理结果

启用方式：在添加或编辑 RSS 订阅时，开启「免费结束时暂停」开关即可。

内置支持站点

扩展站点支持：如需支持其他站点，欢迎提交 Issue 或 Pull Request。

快速开始

Docker 部署（推荐）

镜像地址：Docker Hub

docker run -d \
  --name pt-tools \
  -p 8080:8080 \
  -v ~/pt-data:/app/.pt-tools \
  -e PT_HOST=0.0.0.0 \
  -e PT_PORT=8080 \
  -e TZ=Asia/Shanghai \
  sunerpy/pt-tools:latest

Docker Compose（推荐）

version: "3.8"
services:
  pt-tools:
    image: sunerpy/pt-tools:latest
    container_name: pt-tools
    environment:
      PT_HOST: "0.0.0.0"
      PT_PORT: "8080"
      TZ: "Asia/Shanghai"
    ports:
      - "8080:8080"
    volumes:
      - ./data:/app/.pt-tools
    restart: unless-stopped

启动后访问 http://localhost:8080 进入 Web 管理界面。

默认登录账号：admin / adminadmin

更多部署示例请参考：

• examples/docker-run.md - Docker 单容器运行详解
• examples/docker-compose.yml - Docker Compose 编排
• examples/binary-run.md - 二进制运行和 systemd 配置

二进制运行

前往 Releases 页面 下载预编译二进制文件。

Linux：

wget https://github.com/sunerpy/pt-tools/releases/latest/download/pt-tools-linux-amd64.tar.gz
tar -xzf pt-tools-linux-amd64.tar.gz
chmod +x pt-tools
./pt-tools web --host 0.0.0.0 --port 8080

Windows (PowerShell)：

# 一键下载、解压并运行（复制整段命令到 PowerShell 执行）
Invoke-WebRequest -Uri "https://github.com/sunerpy/pt-tools/releases/latest/download/pt-tools-windows-amd64.exe.zip" -OutFile "pt-tools.zip"; Expand-Archive -Path "pt-tools.zip" -DestinationPath "." -Force; .\pt-tools.exe web --host 0.0.0.0 --port 8080

或分步执行：

# 下载并解压
Invoke-WebRequest -Uri "https://github.com/sunerpy/pt-tools/releases/latest/download/pt-tools-windows-amd64.exe.zip" -OutFile "pt-tools.zip"
Expand-Archive -Path "pt-tools.zip" -DestinationPath "."

# 运行
.\pt-tools.exe web --host 0.0.0.0 --port 8080

注意：这是一个命令行工具，双击 exe 文件会提示需要在命令行中运行。请使用上述 PowerShell 命令启动服务。

使用指南

初次配置流程

1. 启动服务：使用 Docker 或二进制启动 pt-tools
2. 登录管理界面：访问 http://localhost:8080，使用默认账号登录
3. 修改密码：首次登录后建议修改默认密码
4. 配置下载器：添加 qBittorrent 或 Transmission
5. 配置站点：启用站点并填写 Cookie 或 API Key
6. 配置 RSS 订阅：添加 RSS 订阅实现自动下载
7. 配置过滤规则（可选）：创建过滤规则实现精准下载

文档

贡献

欢迎贡献代码或提交问题！

• 提交 Issue：GitHub Issues
• 提交 PR：GitHub Pull Requests

详细的贡献流程请参考 开发指南。

更新日志

查看 Releases 获取完整更新日志。

许可证

MIT License

Star History

如果这个项目对你有帮助，请给一个 Star 支持一下！

免责声明：本工具仅供学习和研究使用，请遵守各 PT 站点的规则，合理使用。