pt-tools

面向 PT 站点的自动化管理工具

文档站 · 功能 · 安装 · 快速开始 · 用法 · 文档 · 开发

简体中文 · English

按 RSS 订阅自动下载免费种子，汇总各站点的数据与登录状态，统一管理 qBittorrent 和 Transmission，并可以在 QQ 和 Telegram 里查看和控制。内置 66 个站点，支持 Docker、Linux 和 Windows。完整文档在 firlab.app/pt-tools。

功能

• 站点与数据：66 个内置站点，覆盖 NexusPHP、mTorrent、Gazelle、HDDolby 和 Rousi 等架构，支持 Cookie、API Key 和 Passkey。在一个页面查看所有站点的上传量、分享率、做种、积分和等级进度；跨站点搜索的结果可以直接推送到下载器；长期未登录导致封号之前会提醒。
• RSS 自动下载：定时拉取订阅，用关键词、通配符或正则过滤标题来追剧；免费期结束时尚未下载完成的种子自动暂停。
• 下载器：可以添加多个 qBittorrent 和 Transmission，按 RSS 订阅、站点、默认下载器的顺序决定推送到哪一个。推送前检查剩余空间，按做种时长、分享率等条件清理旧种子，并保护 H&R 种子。
• 通知与 ChatOps：在 QQ（OneBot）和 Telegram 里查看状态、暂停或删除种子、增删 RSS 订阅，每条命令都记入操作审计；RSS 上新通知支持静默时段、合并摘要、失败重试和每小时配额。企业微信与通用 Webhook 是实验性的出站通道。
• 浏览器扩展：PT Tools Helper 一键同步站点 Cookie，并采集脱敏后的页面数据，用于申请新增站点。
• 部署与维护：Docker 镜像（amd64、arm64）与 Linux、Windows 二进制；二进制部署可以在 Web 界面升级；日志、暂存种子和旧备份先预览再清理；访问站点和下载器可以走 HTTP、HTTPS 或 SOCKS5 代理。

[!WARNING] RSS 未关联任何过滤规则时，pt-tools 只会下载免费种子。追剧或下载特定的非免费资源时，请创建过滤规则并按需关闭「仅免费」。

安装

Docker Compose（推荐）

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
    logging:
      driver: json-file
      options:
        max-size: "10m"
        max-file: "3"

保存为 compose.yml 后运行 docker compose up -d。镜像同时发布在 Docker Hub（sunerpy/pt-tools）和 GHCR（ghcr.io/sunerpy/pt-tools），都包含 amd64 与 arm64。

[!IMPORTANT] 必须持久化 /app/.pt-tools。这个目录里有数据库、配置和用来加密站点凭证的 secret.key；密钥丢失后，已保存的 Cookie 无法恢复。

安装脚本

# Linux
curl -fsSL https://raw.githubusercontent.com/sunerpy/pt-tools/main/scripts/install.sh | sh

# Windows PowerShell
irm https://raw.githubusercontent.com/sunerpy/pt-tools/main/scripts/install.ps1 | iex

脚本会下载最新版本的压缩包和同一版本的 checksums.txt，SHA-256 不一致时拒绝安装。用 TOOL_VERSION 指定版本（例如 TOOL_VERSION=v0.48.0），Linux 上用 TOOL_INSTALL_DIR 指定安装目录（默认 ~/.local/bin）。

预编译二进制

从 Releases 下载。每个版本都附带 checksums.txt 和构建来源证明，gh attestation verify 的用法写在每个 Release 的说明里：

解压后运行 pt-tools web --host 0.0.0.0 --port 8080。没有 macOS 二进制，macOS 请使用 Docker。systemd 服务、Windows 与更多 Docker 示例见安装、二进制运行指南和Docker 示例。

从源码构建

需要 Go 1.26.7、Node.js 25.2.0 和 pnpm 10.25.0，运行 make build-local，详见开发指南。

快速开始

1. 打开 http://localhost:8080，用初始账号 admin / adminadmin 登录，并立即修改密码。
2. 在「下载器设置」中添加 qBittorrent 或 Transmission，并检查连通性。
3. 添加站点认证：Cookie 站点用 PT Tools Helper 同步，API Key 和 Passkey 站点按获取 Cookie 与 API Key 填写。
4. 添加 RSS 订阅，选好下载器、保存目录和免费结束后的处理方式。默认只下免费种子，不需要过滤规则。
5. 备份 secret.key，并确认数据目录已有外部备份。

逐步说明见文档站的快速开始。

用法

• Web 界面：站点、RSS、过滤规则、下载器、自动清理和通知都在 Web 界面里配置。
• ChatOps：QQ 和 Telegram 支持 /help、/status、/tasks、/sites、/torrents、/pause、/resume、/delete、/addrss、/delrss、/bind 和 /unbind。通道的两栏名单决定谁能与机器人对话；用绑定码完成绑定的账号都能执行管理命令，所以绑定码只发给信任的人。见 ChatOps 快速开始。
• 命令行：pt-tools web 启动服务，pt-tools secret 导出、导入加密密钥，pt-tools clean 预览并清理已轮转的日志、暂存种子和旧备份，见命令行。

文档

文档站 firlab.app/pt-tools（中文，English）的内容来自本仓库的 docs/ 目录，在 GitHub 上也可以从文档中心按主题浏览。

每个版本的功能、修复和升级说明见 Releases 与 CHANGELOG。

开发

仓库固定使用 Go 1.26.7、Node.js 25.2.0 和 pnpm 10.25.0。克隆后运行完整的本地门禁：

make check

常用目标：

make fmt             # Go 与前端格式化
make lint            # Go、前端 lint 与类型检查
make test            # 前端构建与单测，Go race 测试
make docs-check      # 仓库内 Markdown 的相对链接与锚点
make build-local     # 构建前端和当前平台的二进制
make build-extension # 校验站点并打包浏览器扩展

贡献前请阅读开发指南和仓库根目录的 AGENTS.md。提交与 PR 标题遵循 Conventional Commits；新增站点只在 site/v2/definitions/ 添加定义，并补齐 fixture 测试。文档站的写作约定与上线流程见 docs/README.md。

社区

• GitHub Issues
• GitHub Discussions
• Telegram
• QQ 群：274984594
• 微信公众号：六月水蓝，微信扫描下方二维码关注

许可证

MIT License

免责声明：本工具仅供学习和研究使用。请遵守各 PT 站点的规则，并自行评估自动化访问的风险。