qBittorrent可通过GUI设置、配置文件编辑或Web API三种方式实现定时限速:一、在“工具→选项→速度”中启用计划备用限速并设定时段;二、手动修改qBittorrent.ini/conf文件,确保SchedulerEnabled=true及正确From/To时间;三、调用Web API接口动态切换限速模式。

如果您在使用qBittorrent时希望在特定时间段自动启用较低的下载或上传速度,以避免影响日常网络使用,则需正确配置备用速度限制及其时间调度功能。以下是实现该目标的具体操作路径与多种可行方案:
一、通过图形界面启用并配置时间调度限速
此方法利用qBittorrent内置的GUI设置,直接在“选项”中开启计划式备用限速,适用于大多数桌面环境(Windows/macOS/Linux)。
1、启动qBittorrent客户端,点击顶部菜单栏的工具 → 选项。
2、在弹出的设置窗口中,左侧选择速度选项卡。
3、在“总速度限制”区域,勾选上传和下载复选框,并分别输入您期望的全局限速值(KB/s)。
4、向下滚动至“备用速度限制”区域,输入您希望在调度时段启用的替代上传与下载限速值(KB/s)。
5、勾选计划备用限制速度使用时间复选框。
6、在下方“从”和“到”字段中,输入24小时制时间(例如:22:00 和 07:00),注意:若希望限速在每日22:00至次日07:00生效,必须填写From: 22:00、To: 07:00,而非反向填写(部分旧版本存在UI逻辑倒置问题,但4.4+版本已修正)。
7、点击确定保存全部设置。
二、手动编辑配置文件强制启用调度(绕过GUI异常)
当界面勾选后限速未按预期切换时,可能因GUI缓存或配置写入失败导致。此时可直接修改qBittorrent的配置文件,确保调度参数被准确加载。
1、关闭qBittorrent主程序,确保进程完全退出。
2、定位配置文件路径:
Windows:%APPDATA%\qBittorrent\data\qBittorrent.ini
Linux:~/.config/qBittorrent/qBittorrent.conf
macOS:~/Library/Application Support/qBittorrent/qBittorrent.conf
3、用文本编辑器打开该文件,在[Preferences]节区内查找或添加以下键值对:
4、确认存在以下行且值为true:SchedulerEnabled=true。
5、设置起止时间(格式为HH:mm,不带空格):SchedulerFrom=22:00,SchedulerTo=07:00。
6、指定调度生效日期模式:SchedulerDays=7(7表示Every day;1-5为工作日;6+7为周末)。
7、保存文件,重新启动qBittorrent。
三、使用API接口动态控制限速时段(适用于远程/自动化场景)
对于部署在服务器、Docker容器或需集成进脚本的用户,可通过qBittorrent Web API在指定时刻触发限速切换,实现毫秒级响应与外部系统联动。
1、确保qBittorrent已启用Web UI:在工具 → 选项 → Web UI中勾选启用Web用户界面(远程控制),并设置登录凭证。
2、使用curl命令在时间临界点调用API:
3、在22:00执行启用备用限速:curl -X POST "http://localhost:8080/api/v2/transfer/setSpeedLimitsMode" --data "mode=1" -u "admin:password"(mode=1表示启用备用限速)。
4、在07:00执行恢复全局限速:curl -X POST "http://localhost:8080/api/v2/transfer/setSpeedLimitsMode" --data "mode=0" -u "admin:password"(mode=0表示禁用备用限速,使用全局值)。
5、将上述命令写入系统定时任务(如Linux cron):0 22 * * * curl -X POST "http://localhost:8080/..." -u "admin:password"。

















