Sign inSign up

xinya585/ptbrush

By xinya585

•Updated 1 day ago

Image
0

290

xinya585/ptbrush repository overview

⁠PTBrush

一个自用的 PT 站点刷流工具:Flask 后端 + Vue 3 / Element Plus 前端,跑在单个 Docker 容器里。按 MoviePilot 的站点管理与刷流思路重写,支持多站点、多下载器、免费种筛选、自动删种和可视化仪表盘。

  • 镜像:xinya585/ptbrush:1.0.3(同时有 latest)
  • 平台:linux/amd64
  • 默认端口:容器内由 WEB_PORT 指定,示例用 44445

⁠功能

站点管理

  • 两种解析器:NexusPHP(填地址 + 浏览器 Cookie,覆盖绝大多数国内 PT 站)、M-Team(x-api-key 鉴权),另支持 RSS 源
  • 站点卡片展示上传量 / 下载量 / 分享率 / 做种数,可刷新、编辑、新增、删除;排序只保留「中文名称」和「上传量」
  • 站点库(pre-dessert-sites):195 个站点的域名→中文名映射与 128px 图标,每周一 04:10 自动同步,也可手动「立即更新」

刷流

  • 选种条件:促销类型(free / free_2x / 2x / half_down / all)、体积区间、做种人数、发布时间、排除 H&R、免费剩余时间门槛
  • 运行控制:刷流间隔、检查周期、下载位上限、最小剩余磁盘空间、工作时间段
  • 失败站点按退避时间跳过,不会每轮重试
  • 下载器可配多个(别名区分),站点按别名绑定;支持账号密码或 qBittorrent v5.2+ 的 API Key

删种(每条规则可单独开关)

  • 做种时长达到上限
  • H&R 种子做种时长
  • 分享率达到目标
  • 低速下载持续 N 分钟(只看下载速度,不占下载位的那部分种子不会被误删)
  • 无上传超时
  • 免费结束前 N 分钟
  • 促销失效(不再是免费/2X)
  • 长期处于等待状态
  • 手动删除

删种都会写入记录表,仪表盘按规则分类展示最近 60 条;同一 hash 在 180 秒内重复写入会去重。

其他

  • 仪表盘:总上传/下载、实时速度、剩余空间、活跃种子、刷流站点账号数据(每 10 分钟更新)、删种记录
  • CookieCloud 同步:把浏览器 Cookie 按域名写进站点,公共服务器默认 https://cookie.scy.cc.cd
  • 登录密码保护、日志页自动刷新(8 秒)、系统设置里可改密码

⁠快速开始

services:
  ptbrush:
    image: xinya585/ptbrush:1.0.3
    container_name: ptbrush
    restart: always
    network_mode: host
    environment:
      - PUID=1000
      - PGID=1000
      - WEB_PORT=44445
    volumes:
      - /path/to/ptbrush/data:/app/data
docker compose up -d

浏览器打开 http://<NAS-IP>:44445。

⁠环境变量
变量说明默认
PUID运行容器的用户 UID,挂载目录的属主要对上镜像内 app 用户
PGID对应 GID同上
WEB_PORTWeb 端口8000
⁠为什么用 host 网络

PTBrush 要直接访问 qBittorrent,宿主机上的 qB 填 http://127.0.0.1:<端口> 最省事;而且站点抓取、CookieCloud 都按容器的真实网络走。用 host 网络时容器和宿主共用端口空间,WEB_PORT 不能和已有服务冲突。若要改成桥接,把 network_mode 换成 ports: ["44445:44445"],qB 地址改填宿主 IP。

⁠首次使用

  1. 打开页面,用 data/config.toml 里 [web].password 登录;该项默认为空,建议进「系统设置」先设一个密码。
  2. 「下载器配置」里加 qBittorrent:别名、地址、账号密码(或 API Key)、默认保存路径。第一个是主下载器,剩余空间/任务数/限速按它判断。
  3. 「站点配置」里加站点:NexusPHP 站填地址 + Cookie;M-Team 填地址 + x-api-key。站点上的「下载器」按别名选。
  4. 「刷流配置」里选参与刷流的站点(开关改动立即保存),再按需调选种条件与删种规则。页面上有「默认值」和「抢上传推荐值」两个按钮可一键回填。
  5. 「仪表盘」看实时状态与删种记录。

⁠刷流机制要点

  • 刷流任务按「刷流间隔」跑一轮;「检查周期」负责检查已下载种子的状态(做种、删种)。
  • 只有促销类型命中、体积/做种数/发布时间满足、且不在 H&R 排除范围的种子才会被加入。
  • H&R 判定:优先看列表页标签;彩虹岛这类只在详情页写 H&R: 3day / 5day 的站点会按详情页要求做种(72 / 120 小时),与「H&R 种子做种时长」取较大值,未满时间不会因分享率达标被删。
  • 剩余磁盘低于阈值、或下载位已满时不会再加种。
  • 活动种子数超过下载位上限不会立刻删,交给删种规则去处理。
  • 站点连续失败会按「加种失败退避」跳过,避免撞 429;站点 429 时也会进入冷却。

⁠数据目录

容器内 /app/data,建议挂到宿主固定目录:

data/
├── config.toml        # 全部配置(刷流、下载器、站点、Web 密码)
├── ptbrush.db         # SQLite:站点数据、种子状态、刷流失败记录、删种记录
├── ptbrush.log        # 运行日志(10MB 轮转,保留 10 天)
├── brush_report.json  # 每轮刷流的诊断快照
└── predessert/        # 站点库(图标、适配映射、同步报告)

备份只需要拷 data/ 目录;换机器时整目录搬过去即可。

⁠常用接口

页面之外也可以用 HTTP 直接查:

  • GET /api/version — 版本(免登录)
  • GET /api/config — 全部配置
  • GET /api/sites — 站点列表与账号数据
  • GET /api/stats — 下载器实时状态与种子列表
  • GET /api/brush/report — 最近一轮刷流诊断
  • GET /api/brush/deletions?limit=60 — 删种记录
  • POST /api/brush/run — 手动跑一轮刷流

⁠常见问题

Q:qB 登录失败? 先确认容器能访问该地址(host 网络下 qB 在同一台机器就用 http://127.0.0.1:<端口>)、账号密码正确、qB 的 WebUI 没有被 IP 白名单限制。「下载器配置」里有「测试连接」,失败原因会直接提示;qB v5.2.0 以上也可以改用 API Key 登录,绕过密码。

Q:站点报「读取站点失败」 多数是 Cookie 过期或被站点反爬拦了,先在浏览器重新登录该站、更新 Cookie,再看日志页的具体错误。

Q:改了刷流间隔没生效? 刷流配置保存后会重排调度,但当前正在跑的那一轮不会中断;等这一轮结束才按新间隔走。

Q:删种记录能留多久? 没有过期清理,只按条数展示最近 60 条,历史都在 ptbrush.db 的 brushdelrecord 表里。

⁠版本

1.0.3。VERSION 文件和页面上的 ?v= 静态串用于判断当前部署版本。

⁠说明

本项目基于 huihuidehui/ptbrush⁠ 的运行时与依赖,在其之上重写了站点管理、选种/删种逻辑与前端界面;容器镜像以该镜像为基础层,只替换 /app 下的源码。

Tag summary

Content type

Image

Digest

sha256:da059a190…

Size

113.4 MB

Last updated

1 day ago

docker pull xinya585/ptbrush