Preface

Why Build SeedFlow?

If you manage multiple VPS, NAS devices, or boxes, you've likely encountered these issues: • Manually adjusting speed limits for different trackers is cumbersome • Occasionally forgetting to limit upload speeds when seeding, leading to account bans • Forgetting to tag new torrents, resulting in messy organization • Losing track of which server is still active (referring to qB)

SeedFlow was created to solve these problems: • A single web panel to manage all qB instances • Control speed limits through "rules" instead of manual operations • Automatically apply tags based on trackers • One-command deployment on client side, supporting both new and old qB versions

What Can SeedFlow Do?

Suitable for:

• Users who often forget to set speed limits when seeding (me personally)
• Users with 2 or more qBittorrent clients
• PT/BT users who want fine-grained speed control
• Users who want automation without writing scripts

Architecture Overview

SeedFlow consists of three components:

In one sentence: Web configures rules → Server pushes → Agent executes → Changes take effect in qB

Deploying SeedFlow

Prerequisites

• A server or NAS
• Installed:
  • Docker
  • docker-compose (optional)

Small Recommendation

If you're using a foreign server, I personally don't recommend installing it on your home NAS\ Most home networks no longer have public IPv4 addresses, though it doesn't matter if you're only using it locally\ Deployment priority: Foreign server > qB's own server > Home NAS

Deploying the Server

Docker Compose (Recommended)

Docker run

1. Create Required Directories

[!TIP] "seedflow" is the main program directory, "config" is for persistent configuration files

2. Create Docker Orchestration File

[!WARNING] DEFAULT_PASSWORD is the initial login password. You can modify it during setup, or change it immediately after first login

Use the ls command to verify these files exist in the current directory

3. Pull Latest Image and Start Container

After startup, access:

• http://your-ip:5427

• Default login password: lxcloud

Adding qB Clients

1. Enter SeedFlow panel
2. Click "Add Client" and fill in the following information:

• Host (IP:Port)
  • If SeedFlow and qB are on the same server, use 127.0.0.1 or localhost
• Username / Password

3. Click "Test Connection" to verify connectivity

Deploying Agent

1. Click the terminal icon next to "Test Connection"
2. Click "Copy Installation Command"\ Some browsers may require manual copying

3. Go to the qB server you want to manage and execute the copied installation command

4. After installation, you'll see these status changes:

• Agent starts automatically
• "Heartbeat status" in panel changes from red to green
• Logs show the corresponding mode has started successfully

5. Additional Configuration for qBittorrent 4.6.0 and Above

After installation, configure "External Programs" in qBittorrent

Click "Auto Configure" in the installation command panel to complete setup with one click (recommended).

Mode Comparison

Configuring Speed Limit Rules

Speed Limit by "Tag"

I personally recommend first applying tags, then using tag-based rules for speed limiting

You can choose other matching methods based on your preferences

Below demonstrates a complete configuration process

Example Configuration:

• Match Type: Tag
• Match Value: HeartSite
• Download Speed Limit: 100 MB/s

Create new tag rule

Simply put, the logic is:

When SeedFlow detects a torrent added to qB whose tracker domain contains lxlad.com\ It will automatically apply the "HeartSite" tag to this torrent\ Then the tag rule will match and automatically apply speed limits

Speed Limit by Tracker Domain / Category / Name

You can combine multiple conditions to achieve very fine-grained control

After configuration, check the logs to confirm rules have been successfully synchronized and applied

Testing if Rules are Effective

1. Manually add a torrent in qB that matches your rule conditions

2. Check the panel's log page

If logs show successful rule matching and execution, the Agent is working properly

3. Check the client

Return to qB interface, where you should see:

• Torrent has been automatically tagged
• Upload speed has been successfully limited according to rules

Automatic Tagging

Import/Export Configuration

Export

Import

Common Issues

Q: Rules not working?

Please troubleshoot in the following order:

1. Check if Agent is online

   • "Heartbeat status" in panel should be online (green)
   • If Agent is offline, check if the client-side service is running properly

2. Confirm qBittorrent version and mode

   • qB ≥ 4.6.0: Use "Standard" mode and confirm external programs are configured
   • qB < 4.6.0: Use "Compatibility" mode

Final Thoughts

SeedFlow is more like a "qB automation hub". It was created simply to help PT users avoid forgetting to set speed limits according to different site rules, which could lead to account bans.

I spent an entire night writing this article, explaining everything based on the minimal setup scenario. If you have questions, feel free to leave comments