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 部署
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 目录里,升级只需换镜像重启。
第一次配置
系统设置里填 qBittorrent 的地址、账号、密码,点「测试连接」。qB 要开 WebUI,地址形如 http://192.168.1.2:8080。
站点配置页「新增站点」填域名、中文名、站点类型。选 NexusPHP 的站点会自动识别;登录态用 cookie,可以手工粘,也可以走 CookieCloud 同步。
刷流配置页选哪些站参与、下载哪些促销类型(免费 / 2X 免费 / 2X 上传 / 50% 下载)、工作时间段、刷流间隔、候选上限、最低速度等。保存后立即生效,不用重启。
即将过期、长时间无活跃、条件删种、动态删种各自有独立阈值;带 H&R 的种子有单独标记,默认不参与「无脑清理」。
自动升级
程序启动后读一次版本清单(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 目录。
