qBittorrent 安装与配置教程

qBittorrent 是当前最流行的 PT 种子下载工具,支持全平台客户端,速度快且功能强大。本教程适合 PT 下载入门用户,涵盖手动安装和 Docker 部署,操作简单,复制粘贴即可完成!

演示系统:Debian 10/11


究极无敌螺旋简单版(不带开机启动,v4.3.5)

  1. 下载 qBittorrent

    wget https://github.com/userdocs/qbittorrent-nox-static/releases/download/release-4.3.5_v2.0.4/x86_64-qbittorrent-nox
  2. 赋予执行权限

    chmod +x x86_64-qbittorrent-nox
  3. 首次运行

    • 运行后会提示同意条款,输入 y 确认。

      ./x86_64-qbittorrent-nox
  4. 后台运行

    ./x86_64-qbittorrent-nox -d &
  5. 自定义端口

    ./x86_64-qbittorrent-nox -d --webui-port=8088
  6. 自定义端口 + 后台运行

    ./x86_64-qbittorrent-nox -d --webui-port=8088 &

访问地址http://IP:8080http://IP:8088
默认用户名admin
默认密码adminadmin


进阶版(带开机启动,v4.3.9)

  1. 下载 qBittorrent

    • 国外 VPS:

      sudo wget -qO /usr/local/bin/qbittorrent-nox https://github.com/userdocs/qbittorrent-nox-static/releases/download/release-4.3.9_v1.2.15/x86_64-icu-qbittorrent-nox
    • 国内 VPS:

      sudo wget -qO /usr/local/bin/qbittorrent-nox https://download.おうか.tw/userdocs/qbittorrent-nox-static/releases/download/release-4.3.9_v1.2.15/x86_64-icu-qbittorrent-nox
  2. 赋予执行权限

    sudo chmod +x /usr/local/bin/qbittorrent-nox
  3. 首次运行

    • 运行后会提示同意条款,输入 y 确认,然后按 Ctrl+C 停止。

      /usr/local/bin/qbittorrent-nox --webui-port=8088
  4. 编写守护文件

    cat << "EOF" > /etc/systemd/system/qbittorrent-nox.service
    [Unit]
    Description=qBittorrent Daemon Service
    After=network.target
    
    [Service]
    User=root
    Type=forking
    LimitNOFILE=infinity
    ExecStart=/usr/local/bin/qbittorrent-nox -d --webui-port=8088 --profile=/usr/local/etc
    ExecStop=/usr/bin/killall -s 9 qbittorrent-nox
    Restart=on-failure
    
    [Install]
    WantedBy=multi-user.target
    EOF
    • 注意

      • --profile=/usr/local/etc:指定配置目录,可删除。
      • --webui-port=8088:自定义端口,可删除。
  5. 启动与管理

    • 启动:

      systemctl start qbittorrent-nox
    • 查看状态:

      systemctl status qbittorrent-nox
    • 开机启动:

      systemctl enable qbittorrent-nox
    • 重启:

      systemctl restart qbittorrent-nox
    • 停止:

      systemctl stop qbittorrent-nox

访问地址http://IP:8080http://IP:8088
默认用户名admin
默认密码adminadmin


常见问题解决

  1. 公网 IP 访问提示“Unauthorized”

    • 修改默认端口(8080)为其他端口。
    • 修改配置文件 /usr/local/etc/qBittorrent.conf,添加或修改:

      WebUI\HostHeaderValidation=false
    • 重启 qBittorrent 或主机。
  2. 修改中文界面

    • 依次点击:设置(齿轮)→ WebUI → Language → 选择语言 → 保存(Save)
  3. 无法下载,一直等待中

    • 修改监听端口(默认 6881 可能被 PT 站点屏蔽)。
    • 打开 WebUI:设置 → 连接 → 修改监听端口

标签: linux, pt, qBittorrent, debian, 优化, 安装

添加新评论