pt-tools

pt-tools

pt-tools 是一个专为 PT 站点设计的自动化工具，通过 RSS 订阅自动下载免费种子并推送到 qBittorrent，帮助用户快速提升上传量。

功能特性

• RSS 自动订阅：自动解析 RSS 订阅，下载免费种子
• 多站点支持：支持 M-Team、HDSky、CMCT 等站点
• qBittorrent 集成：自动推送种子到 qBittorrent
• Web 管理界面：通过 Web 页面统一管理配置
• Docker 部署：支持 Docker 一键部署

支持的站点

快速开始

Docker 部署（推荐）

镜像地址： Docker镜像

Docker镜像由github action 自动构建，如需手动构建，可参考Makefile 中的build-remote-docker阶段由源码自行构建

查看示例：

• examples/docker-run.md：单容器运行、环境变量说明与数据持久化挂载（推荐）
• examples/docker-compose.yml：使用 Compose 编排，持久化数据库与下载目录（推荐）

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 \
  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"
    ports:
      - "8080:8080"
    volumes:
      - ./data:/app/.pt-tools
    restart: unless-stopped

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

默认登录账号：admin / adminadmin

环境变量

Web 配置说明

全局设置

qBittorrent 设置

站点设置

RSS 订阅

每个站点可配置多个 RSS 订阅：

数据持久化

所有数据存储在 /app/.pt-tools 目录：

• torrents.db：SQLite 数据库，存储配置和任务记录
• downloads/：种子文件下载目录

重置管理员密码

docker run -d \
  -e PT_ADMIN_RESET=1 \
  -e PT_ADMIN_USER=admin \
  -e PT_ADMIN_PASS='新密码' \
  -v ~/pt-data:/app/.pt-tools \
  -p 8080:8080 \
  sunerpy/pt-tools:latest

重置完成后移除 PT_ADMIN_RESET 环境变量

从源码构建

git clone https://github.com/sunerpy/pt-tools.git
cd pt-tools
go build -o pt-tools .

二进制下载

前往 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

# 运行（默认启动 Web 服务）
./pt-tools web

# 或指定监听地址和端口
./pt-tools web --host 0.0.0.0 --port 8080

Windows 运行

1. 下载 pt-tools-windows-amd64.exe.zip 并解压
2. 在命令行中执行：

pt-tools.exe web --host 0.0.0.0 --port 8080

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

许可证

MIT License