SeedFlow使用教程

写在前面
为什么要做 SeedFlow?
如果你手上有 多台 VPS / NAS / 盒子,相信你都遇到过这些问题:
• 不同站点限速策略不同手动改很麻烦
• 不同站点发种时偶尔忘了限速导致超速封号
• 新种子忘记打标签观感不好
• 服务器多了以后不知道哪台还活着(指qBSeedFlow 的出现就是为了解决这些问题:
• 一个 Web 面板,统一管理所有 qB
• 用「规则」而不是「手动操作」控制限速
• 自动根据 Tracker 打标签
• 被控端一条命令部署,支持新/旧版本qBSeedFlow 能做什么
适用于
- 经常发种忘了限速(
我本人 - 有 2 台及以上 qBittorrent 客户端的用户
- PT / BT 用户,希望精细化限速
- 不想写脚本,但想要「自动化」的人
整体架构简介
SeedFlow 分为三部分:
| 模块 | 技术栈 | 作用 |
|---|---|---|
| 前端 Web | React | 提供管理界面、规则配置、状态展示 |
| 服务端 Server | Node.js / Express | 保存配置、提供 API、向 Agent 下发规则 |
| 被控端 Agent | Go | 部署在 qB 服务器,与服务端保持心跳,调用 qB API 执行限速与标签操作 |
一句话理解: Web 配规则 → Server 下发 → Agent 执行 → qB 生效
部署 SeedFlow
准备环境
- 一台服务器 / NAS
- 已安装:
- Docker
- docker-compose(可选)
小建议
如果你使用的国外服务器,我个人不推荐你安装在家里的NAS上
大部分人家里的公网v4都被回收了,当然本地qB使用就无所谓部署优先级:国外服务器 > qB自身服务器 > 家里云Nas
部署服务端
方法一
Docker Compose(推荐)
1. 创建程序所需目录
mkdir -p seedflow && cd seedflow
mkdir -p config

创建目录
Tipseedflow 是主程序目录,config 用于持久化配置文件
2. 创建 Docker编排文件
cat > docker-compose.yml << 'EOF'
services:
seedflow:
image: 52lxcloud/seedflow:latest
container_name: seedflow
ports:
- "5427:5427"
environment:
- DEFAULT_PASSWORD=lxcloud
volumes:
- ./config:/app/config
restart: unless-stopped
EOF
Warning
DEFAULT_PASSWORD是初始登录密码可以自行修改替换,或首次登录后请务必修改

手动创建编排文件
可以使用ls命令查看当前目录文件,有这两条就正常
3. 拉取最新镜像并启动容器
docker-compose pull && docker-compose up -d

启动镜像
方法二
Docker run
mkdir -p config
docker run -d \
--name seedflow \
-p 5427:5427 \
-v ./config:/app/config \
--restart unless-stopped \
52lxcloud/seedflow:latest
启动完成后访问:
默认登录密码:
lxcloud
添加qB客户端
- 进入 SeedFlow面板
- 点击「新增客户端」 填写以下信息:
- Host(IP:端口)
- 如果 SeedFlow 与 qB 在同一台服务器上,可使用
127.0.0.1或localhost
- 如果 SeedFlow 与 qB 在同一台服务器上,可使用
- 用户名 / 密码

新增 qB 客户端
- 点击「测试连接」确认可用

测试连接
部署被控端 Agent
- 点击「测试连接」旁边的 终端图标
- 点击「复制安装命令」
部分浏览器可能需要手动复制命令

复制安装命令
- 前往 需要被管理的 qB 服务器,执行复制的安装命令

安装 Agent
- 安装完成后,你将看到以下状态变化:
- Agent 自动启动
- 面板中「心跳状态」由 红色 变为 绿色
- 日志中显示对应模式已成功启动

日志状态
- qBittorrent 4.6.0 及以上版本额外配置
安装完成后,需要在 qBittorrent 中配置「外部程序」
安装命令的面板中点击 「自动配置」,一键完成设置(推荐)。

外部程序自动配置
两种模式说明
| 模式 | 支持的 qB 版本 | 工作方式 | 特点 |
|---|---|---|---|
| 标准版(推荐) | ≥ 4.6.0 | 通过「外部程序」触发 | 实时性好,性能开销低 |
| 兼容版 | 所有版本 qB | 轮询检测 | 兼容性最好 |
配置限速规则
按 「标签」 限速
个人比较推荐 先打标签,再通过标签规则进行限速
你也可以根据自己的使用习惯,选择其他匹配方式
下面演示一遍 完整的配置流程
示例配置:
- 匹配类型:标签
- 匹配值:
心站 - 下载限速:
100 MB/s

标签限速规则
新建标签规则

新建标签规则
通俗来讲的逻辑就是
当检测到 qB添加的种子 Tracker 域名包含
lxlad.com时
会自动为该种子打上 「心站」 标签
然后由标签规则匹配自动限速
按 Tracker 域名 / 分类 / 名称 限速
你可以组合多种条件,实现非常细的控制策略
配置完成后,建议查看 日志,确认规则是否已成功同步并生效

规则同步日志
测试规则是否生效
在 qB中手动添加一个符合规则条件的种子
查看 面板的日志页面

查看日志
如果日志中显示已成功匹配规则并执行操作,说明 被控端 工作正常
- 检查客户端
返回 qB页面,你应该可以看到:
- 种子已被 自动打上对应标签
- 上传速度已按规则成功限制

规则生效
自动打标签
| 支持 | 说明 |
|---|---|
| 根据 Tracker 域名 | 根据站点打标签种子分类清晰 |
| 自动打指定标签 | 配合限速规则全自动化 |
导入 / 导出配置
导出
| 类型 | 说明 |
|---|---|
| 客户端 | 已添加的 qB 客户端配置 |
| 规则 | 限速规则、标签规则 |
| 全部配置 | 完整的 SeedFlow 配置快照 |
导入
| 类型 | 说明 |
|---|---|
| 新增 | 保留现有配置,追加导入的数据 |
| 覆盖 | 清空现有配置,使用导入的数据 |
常见问题
Q:规则没有生效怎么办?
请按以下顺序排查:
检查 Agent 是否在线
- 面板中「心跳状态」应为在线(绿色)
- 如 Agent 离线,请检查被控端服务是否正常运行
确认 qBittorrent 版本与模式
- qB ≥ 4.6.0:请使用「标准版」并确认已配置外部程序
- qB < 4.6.0:请使用「兼容版」
写在最后
SeedFlow 更像是一个「qB 自动化中枢」,出发的点也只是为了各位PTer在发种时,不要因为各个站点的规则不同,从而忘了设置限速,导致账号被封禁
这篇文章写了我一个通宵,根据自己实际情况,已按最小入门版进行解释,有疑问,欢迎留言