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

适用环境：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（内存溢出）。

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 内存

三、 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 总内存)