qBittorrent 4.6.5 (libtorrent v1.2) 稳定性优化指南

__2026年1月31日 __0条评论 __450次阅读 __0人点赞 __Tao_Qi

适用环境 ：4GB RAM / 3 TiB HDD / 机械硬盘保护 / MoviePilot 自动化

一、 系统与硬件基础

• 磁盘分区 ：3 TiB 硬盘必须使用 GPT 分区表，MBR 格式最大仅支持 2.2 TB。
• 文件系统 ：推荐使用 ext4 或 xfs。
• 挂载建议 ：将下载目录与媒体库目录挂载在同一个分区（如 /home/down/media），以确保硬链接 (Hard Link) 秒级完成且不占双倍空间。

• • *

二、 Docker Compose 部署配置

针对 4GB 内存进行了限制，防止 qBittorrent 压力过大时导致系统 OOM（内存溢出）。
[code]

services:
  qbittorrent:
    image: linuxserver/qbittorrent:4.6.5-libtorrentv1  # 已修正标签
    container_name: qbittorrent
    environment:
      - PUID=0
      - PGID=0
      - TZ=Asia/Shanghai
      - UMASK_SET=022 # 核心：确保 MoviePilot 拥有修改文件的权限
      - WEBUI_PORT=8080
    volumes:
      - /home/docker/qbt/config:/config
      - /home/down/media:/home/down/media
    ports:
      - 8080:8080
      - 64803:64803
      - 64803:64803/udp
    restart: unless-stopped
    deploy:
      resources:
        limits:
          memory: 2G # 给系统和 MoviePilot 预留 2G 内存

[/code]

三、 WebUI 关键设置方案

1. 连接与上传（保护磁头寿命）

• 全局最大连接数 ：200
• 每 torrent 最大连接数 ：50
• 全局上传窗口上限 ：勾选并设为 20
• 每 torrent 上传窗口上限 ：勾选并设为 5

2. 下载选项（功能需求）

• 为未完成的文件添加 .!qB 扩展名 ：勾选。
• 启用子分类 ：勾选。
• 预分配所有文件空间 ：必须勾选 （防止产生大量碎片，降低 3 TiB 硬盘 I/O 报错率）。

3. 高级选项（底层稳定性优化）

• 磁盘缓存 ：手动设为 256 或 384 (MiB)。
• 磁盘 IO 读取/写入模式 ：均选择 “启用操作系统缓存” 。
• 合并读写 ：勾选 （libtorrent v1.2 核心优化，平滑机械盘读写）。
• 异步 I/O 线程数 ：设为 4 （针对单磁头机械盘的优化）。
• 最大活动检查任务数 ：设为 1 （强制排队校验，防止 I/O 崩溃）。
• Tracker 停止超时 ：设为 0 。

四、 内存分配预览 (4GB 总内存)

五、 备份说明

1. I/O 报错排查 ：若日志出现 Input/output error，优先检查是否开启了“预分配空间”以及“最大检查任务数”是否为 1。
2. 硬链接校验 ：在 MoviePilot 整理后，使用 ls -i 命令查看源文件与目标文件，若 inode 号一致则硬链接成功。

• • *

本作品采用 知识共享署名-相同方式共享 4.0 国际许可协议 进行许可

__点赞 __分享

__ __ __ __ __ __ 打开微信“扫一扫”，打开网页后点击屏幕右上角分享按钮

__No Tag

最后编辑：2026年1月31日

< 上一篇

下一篇 >

发表回复 取消回复

电子邮件地址不会被公开。必填项已用 * 标注

__

*

__

*

__

*

__