Windows 便携版

下载 zip,解压到任意目录(例如 D:\PTBrush),整个文件夹都要留着。

启动

双击 PTBrush.exe,不弹黑框,几秒后托盘出现图标并自动打开 http://127.0.0.1:44445。

常用参数

--port 8080 换端口 · --data D:\PTBrushData 换数据目录 · --console 调出控制台 · --no-tray 不显示托盘 · --autostart on|off 开关开机自启。

数据在哪

exe 同级的 data\:config.toml(配置)、ptbrush.db(站点快照)、ptbrush.log(日志)。整个文件夹拷走就等于搬家。

Docker 部署

docker-compose.yml
services:
  ptbrush:
    image: xinya585/ptbrush:latest
    container_name: ptbrush
    network_mode: host
    environment:
      - TZ=Asia/Shanghai
    volumes:
      - ./data:/app/data
    restart: unless-stopped

容器里端口由 WEB_PORT 决定(默认 8000);用 host 网络时直接访问宿主机的 8000 端口。数据全部落在挂载的 data 目录里,升级只需换镜像重启。

第一次配置

1. 下载器

系统设置里填 qBittorrent 的地址、账号、密码,点「测试连接」。qB 要开 WebUI,地址形如 http://192.168.1.2:8080。

2. 站点

站点配置页「新增站点」填域名、中文名、站点类型。选 NexusPHP 的站点会自动识别;登录态用 cookie,可以手工粘,也可以走 CookieCloud 同步。

3. 刷流规则

刷流配置页选哪些站参与、下载哪些促销类型(免费 / 2X 免费 / 2X 上传 / 50% 下载)、工作时间段、刷流间隔、候选上限、最低速度等。保存后立即生效,不用重启。

4. 清理规则

即将过期、长时间无活跃、条件删种、动态删种各自有独立阈值;带 H&R 的种子有单独标记,默认不参与「无脑清理」。

CookieCloud

浏览器装 CookieCloud 插件,把 cookie 传到服务器,PTBrush 按域名写进对应站点。

服务器

用公共服务 https://cookie.scy.cc.cd,或自建(填 http://IP:端口,地址必须能被 PTBrush 访问到)。

流程

插件里填同一个服务器 / UUID / 密码并上传 cookie → 面板点「预览」确认抓到了域名 → 点「同步到站点」按域名写入。同步是覆盖式的,以浏览器最新那份为准。

补全 PT 站点

「补全 PT 站点」会把标了 PT、有 cookie、但还没配站点的域名按 NexusPHP 站一次建好;站点名优先取 savept.icu 的中文名,取不到就用域名。

自动升级

程序启动后读一次版本清单(latest.json),发现比本地新就在托盘里提示。

手动检查

托盘右键 →「检查更新」。有新版本会弹提示,确认后下载、校验 SHA256,然后等程序退出、替换文件、自动重启。

升级包放哪

安装包与更新包放在 Cloudflare R2 存储桶,由 Workers 提供下载地址;本站只提供 latest.json 清单。

自定义清单

想换成自己的发布源,设置环境变量 PTBRUSH_UPDATE_URL 指向你的 latest.json 地址即可。

常见问题

打开页面是空白

先确认地址端口对不对;如果是白屏且控制台报 MIME 错误,1.0.3 之后已经在服务端固定 MIME,升级即可。

端口被占用

换一个:PTBrush.exe --port 8081;容器里设环境变量 WEB_PORT。

双击没反应

多半是已经有一个实例在跑(单实例锁),它会直接把浏览器打开到现有界面;真想跑第二份就用 --data 指定不同的数据目录。

开机自启怎么关

托盘右键取消勾选,或命令行 PTBrush.exe --autostart off。写的是当前用户的 HKCU Run 键,不弹 UAC。

日志在哪

data\ptbrush.log 按 10 MB 滚动、保留 10 天;容器里对应挂载的 data 目录。