pt-tools 是自托管的 PT 站点管理工具:按 RSS 自动下载,刷流与 IYUU 辅种,订阅电影、追剧并整理进媒体库,每天签到、在封号前提醒,汇总各站点的数据,统一管理 qBittorrent 和 Transmission;手机 App、QQ、Telegram、飞书与内置的 AI 助手都能查看和操作。内置 72 个站点,支持 Docker、Linux 和 Windows。完整文档在 firlab.app/pt-tools。
Tip
不会配置,或者懒得一项项填?交给 AI。 在「AI 助手」里填一个大模型的 API Key,直接告诉它要加哪个下载器、站点、RSS 订阅或通知通道,它列出改以前、改以后,你点确认才保存。也可以打开 MCP,给令牌勾上「配置」,让你自己的 Agent(WorkBuddy、Qwen Code、Codex、Claude Code、Cursor 等)帮你读改 pt-tools 的配置。见让助手改配置。
首页、系统体检、追剧、刷流、AI 助手与手机 App 的截图(演示数据)
「长夜将尽」是编的剧,海报与背景图是生成的。
- AI 助手与 MCP:接上 OpenAI 兼容的大模型(DeepSeek、通义千问、Kimi、硅基流动、OpenRouter、Ollama 等),在网页、App、Telegram、QQ 或飞书里用自然语言查数据、搜索与推送种子、追剧和管理订阅、整理媒体库,还能帮你改配置(下载器、站点、RSS、通知通道等,密钥只写不读);改动类操作每次都先列出改以前、改以后,你确认了才执行。打开 MCP 以后,WorkBuddy、Qwen Code、Codex、Claude Code、Cursor 这类支持 MCP 的 Agent 也能调用同一套工具。
- 扫码一键创建飞书应用机器人:在网页上生成二维码,用飞书扫码并确认,pt-tools 就在扫码人所在的企业里建好应用,预填收发消息要的权限与事件,随后建好并启用通道、连上飞书,扫码的人成为管理员并直接绑定。不用去飞书开发者后台开启机器人能力、开通权限、改订阅方式、发布版本;pt-tools 主动连出到飞书,不需要公网地址。
- 追剧与媒体库:订阅电影、追剧集的一季,pt-tools 到各站点搜索并按质量档案挑资源,下载完按命名模板整理进媒体库、刮削 NFO 与海报、通知 Emby、Jellyfin 或 Plex,每部片的详情页与订阅日历写明每一集入库了没有。
- 刷流与 IYUU 辅种:从站点的种子列表里按条件挑免费的新种做种、按规则删种,收益按天统计;IYUU 找出其他站点上数据相同的种子,校验到 100% 才开始做种,数据只存一份。
- 手机 App与远程访问:Android App 扫网页上的二维码配对,先试直连、连不上再经 relay 连回 pt-tools,连接端到端加密,在外面也能看概览、管理种子与订阅。
- 首页、NAS 监控与系统体检:打开网页先到首页,上面是 NAS 的 CPU、内存、网络与存储(数据来自本机、TrueNAS、Glances 等来源)、今天播出的集与待处理的事;系统体检一次检查 TMDB、站点、下载器、媒体库、磁盘与备份,写明怎么修。
- 通知通道与消息模板:除了 QQ、Telegram 和飞书应用机器人,通知还能发到企业微信、钉钉、飞书群机器人、Bark、Server 酱、ntfy 与自定义 Webhook,每类事件的标题与正文都可以用模板改写。
- 签到与封号提醒:按站点开启每日签到,验证码与签到题可以交给 AI;长期未登录、快要封号之前提醒你去登录。
- 数据统计与分享图:每天存一份各站点的数据快照,按日、周、月看增量与走势,每日战报发到通知通道,统计可以导出成分享图(五种样式)。
- qB 兼容与 Servarr 兼容入口:MoviePilot、IYUU、Sonarr 这类工具可以把 pt-tools 当成 qBittorrent(加的种子照常经过磁盘空间与做种容量的检查),Seerr 可以把它当成 Radarr 与 Sonarr,请求的电影与剧集建成订阅。
完整的变更见 1.0 新功能。
- 站点与搜索:72 个内置站点,覆盖 NexusPHP、mTorrent、Gazelle、HDDolby 和 Rousi 等架构,支持 Cookie、API Key 和 Passkey;在一个页面查看所有站点的上传量、分享率、做种、积分和等级进度;跨站点搜索的结果可以直接推送到下载器,也可以选一部电影或剧集按条目搜索。
- RSS 自动下载:定时拉取订阅,用关键词、通配符或正则过滤标题;免费期结束时没下完的种子按每条订阅的设置暂停或删除。
- 下载器:可以添加多个 qBittorrent 和 Transmission,按 RSS 订阅、站点、默认下载器的顺序决定推送到哪一个;推送前检查剩余空间和站点做种容量,按做种时长、分享率等条件清理旧种子,并保护 H&R 种子;种子可以转移到另一台下载器继续做种。
- ChatOps:在 QQ(OneBot)、Telegram 和飞书应用机器人(扫码就能建好机器人)里查看状态、暂停或删除种子、增删 RSS 订阅、追剧,每条命令都记入操作审计;RSS 上新通知支持静默时段、合并摘要、失败重试和每小时配额。
- 浏览器扩展:PT Tools Helper 一键或定时同步站点 Cookie,并采集脱敏后的页面数据,用于申请新增站点。
- 部署与维护:Docker 镜像(amd64、arm64)与 Linux、Windows 二进制,1Panel、Unraid、飞牛 fnOS 上有应用定义;二进制部署可以在 Web 界面升级;每天定时备份数据库,可以在网页上恢复;访问站点和下载器可以走 HTTP、HTTPS 或 SOCKS5 代理,也可以只让选中的站点走代理。
Warning
RSS 未关联任何过滤规则时,pt-tools 只会下载免费种子。追剧或下载特定的非免费资源时,请创建过滤规则并按需关闭「仅免费」。
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。1Panel、Unraid 与飞牛 fnOS 的安装方法见安装。
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=v1.0.0),Linux 上用 TOOL_INSTALL_DIR 指定安装目录(默认 ~/.local/bin)。
从 Releases 下载。每个版本都附带 checksums.txt 和构建来源证明,gh attestation verify 的用法写在每个 Release 的说明里:
| 系统 | 架构 | 文件 |
|---|---|---|
| Linux | amd64 | pt-tools-linux-amd64.tar.gz |
| Linux | arm64 | pt-tools-linux-arm64.tar.gz |
| Windows | amd64 | pt-tools-windows-amd64.exe.zip |
| Windows | arm64 | pt-tools-windows-arm64.exe.zip |
解压后运行 pt-tools web --host 0.0.0.0 --port 8080。没有 macOS 二进制,macOS 请使用 Docker。systemd 服务、Windows 与更多 Docker 示例见安装、二进制运行指南和Docker 示例。
Android App 的安装包(大多数手机用 pt-tools-app-arm64-v8a.apk)在同一个 Release 里,版本号与服务端相同,见手机 App。
换成新的镜像或二进制,照常启动即可:数据库结构在启动时自动迁移,迁移以前会先自动备份一次。要回到 0.48.0,用这份升级前备份恢复,步骤见升级与备份。
需要 Go 1.26.11、Node.js 25.2.0 和 pnpm 10.25.0,运行 make build-local,详见开发指南。
- 打开 http://localhost:8080,用初始账号
admin/adminadmin登录,并立即在「系统 → 修改密码」中修改密码。 - 在「下载 → 下载器设置」中添加 qBittorrent 或 Transmission,并检查连通性。
- 在「站点 → 站点列表」中添加站点认证:Cookie 站点用 PT Tools Helper 同步,API Key 和 Passkey 站点按获取 Cookie 与 API Key 填写。
- 在站点的「RSS 订阅」分页中添加订阅,选好下载器、下载路径和免费结束时没下完的处理方式。没有关联过滤规则时只下载免费种子。
- 点底部状态栏的「RSS 任务」启动,并在同一个面板里打开「程序启动时自动运行」。
- 备份
secret.key,并确认数据目录已有外部备份。
逐步说明见文档站的快速开始,那里还写了追剧、手机 App 与 AI 助手的第一步。
- Web 界面:站点、RSS、过滤规则、下载器、媒体库、自动清理和通知都在 Web 界面里配置;手机浏览器里同样的页面以卡片显示。
- ChatOps:QQ、Telegram 和飞书应用机器人支持
/help、/status、/version、/tasks、/sites、/torrents、/pause、/resume、/delete、/signin、/addrss、/delrss,订阅与追剧的/sub、/follow、/subs、/runs、/today、/unlock,AI 助手的/newchat,以及/bind和/unbind。通道的两栏名单决定谁能与机器人对话;名单里的账号可以用绑定码绑定,也可以在「ChatOps 绑定」页直接绑定,扫码一键创建飞书应用机器人时扫码的人会被直接绑定。完成绑定的账号都能执行管理命令,所以绑定码只发给信任的人。见 ChatOps 快速开始。 - 命令行:
pt-tools web启动服务,pt-tools db backup、pt-tools db restore备份与恢复数据,pt-tools secret导出、导入加密密钥,pt-tools clean预览并清理已轮转的日志、暂存种子和旧备份,pt-tools mcp把 MCP 工具接给只支持 stdio 的客户端,pt-tools relay serve自己运行远程访问的 relay,见命令行。
文档站 firlab.app/pt-tools(中文,English)的内容来自本仓库的 docs/ 目录,在 GitHub 上也可以从文档中心按主题浏览。
| 文档 | 内容 |
|---|---|
| pt-tools 是什么 | 工作方式与界面各页的用途 |
| 1.0 新功能 | 1.0 加入的功能与重要修复 |
| 安装 | Docker、NAS、二进制、systemd 与首次登录 |
| 配置说明 | 环境变量、代理、下载器、持久化与日志 |
| RSS 订阅 | 订阅、下载器选择、免费结束策略 |
| 过滤规则与追剧 | 关键词、通配符与正则规则 |
| 自动删种与磁盘保护 | 清理条件、H&R 保护与剩余空间检查 |
| 登录状态与密钥备份 | 登录探测、封号提醒、每日签到与密钥备份 |
| ChatOps | QQ、Telegram、飞书、绑定与 RSS 上新通知 |
| 升级与备份 | 各安装方式的升级、备份与恢复 |
| 数据与安全 | 数据位置、加密范围、外连与部署建议 |
| 支持站点 | 72 个内置站点及认证方式 |
| 请求新增站点 | 用扩展采集并脱敏提交站点数据 |
| 常见问题 | 认证、RSS、下载器与数据库排障 |
每个版本的功能、修复和升级说明见 Releases 与 CHANGELOG。
仓库固定使用 Go 1.26.11、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 - 微信公众号:六月水蓝,微信扫描下方二维码关注
免责声明:本工具仅供学习和研究使用。请遵守各 PT 站点的规则,并自行评估自动化访问的风险。
