linux安装无头模式的qBittorrent

在 Linux 上部署无头模式的 qBittorrent，需要安装 qbittorrent-nox，配置 WebUI 和下载参数，并用 systemd 管理服务。下面给出具体流程步骤。

安装 qbittorrent-nox（无头版本）

qbittorrent-nox 是 qBittorrent 的无头版本，专门为服务器环境设计，没有图形界面。根据 Linux 发行版选择对应包管理器安装：

• Debian/Ubuntu：sudo apt update && sudo apt install qbittorrent-nox
• CentOS/RHEL：sudo yum install epel-release && sudo yum install qbittorrent-nox（如果尚未启用 EPEL 仓库）
• Fedora：sudo dnf install qbittorrent-nox
• Arch Linux：sudo pacman -S qbittorrent-nox

安装完成后，确认版本是否正确。默认登录凭据：

用户名: admin
密码: adminadmin  或者  admin

配置 qBittorrent

qbittorrent-nox 的配置文件通常位于 ~/.config/qBittorrent/qBittorrent.conf。需要编辑此文件来设置用户名、密码、监听端口等。

• 创建配置文件（如果不存在）：第一次运行 qbittorrent-nox 可能会自动创建配置文件。如果没有，可以手动运行一次，然后停止它。
• 编辑配置文件：使用文本编辑器打开配置文件，例如：nano ~/.config/qBittorrent/qBittorrent.conf
• 重要配置项：
  • WebUI\Enabled=true：启用 Web 用户界面。
  • WebUI\Username=YOUR_USERNAME：设置 Web 用户界面的用户名。
  • WebUI\Password_PBKDF2=YOUR_ENCRYPTED_PASSWORD：设置 Web 用户界面的密码。注意：不要直接设置明文密码。可以使用 qbittorrent-nox 命令生成加密后的密码。在命令行中输入 qbittorrent-nox --webui-port=8080，然后程序会提示你输入密码，它会生成加密后的密码，复制粘贴到配置文件中。确保替换 YOUR_USERNAME 和 YOUR_ENCRYPTED_PASSWORD 为自定义的值。
  • WebUI\Port=8080：设置 Web 用户界面的端口（默认是 8080，可以修改）。
  • ListenPort=YOUR_PORT：设置监听端口（BT 下载使用的端口，默认是 6881，建议修改）。
  • Downloads\SavePath=YOUR_DOWNLOAD_PATH：设置下载文件的保存路径。
• 保存配置文件：保存并关闭配置文件。

版本提示：qBittorrent-nox 5.1 的初始密码策略是否已经更新，在现有讨论中未给出进一步结论。配置密码时，应以实际安装版本的运行提示和生成的配置值为准。

使用 systemd 运行 qbittorrent-nox

可以直接在终端运行 qbittorrent-nox，但更常见的做法是将其作为 systemd 服务运行，以便在系统启动时自动启动。

• 创建 systemd 服务文件：创建一个名为 qbittorrent-nox.service 的文件，通常位于 /etc/systemd/system/。使用 sudo nano /etc/systemd/system/qbittorrent-nox.service 创建并编辑文件。

• 服务文件内容示例：

      [Unit]
      Description=qBittorrent Bittorrent client
      After=network.target
  
      [Service]
      User=YOUR_USER
      ExecStart=/usr/bin/qbittorrent-nox -d --webui-port=8080
      Restart=on-failure
  
      [Install]
      WantedBy=multi-user.target

  • User=YOUR_USER：将 YOUR_USER 替换为运行 qBittorrent 的用户名。
  • ExecStart：指定启动 qBittorrent-nox 的命令。-d 参数表示以守护进程模式运行。

• 启用并启动服务：

      sudo systemctl enable qbittorrent-nox.service
      sudo systemctl start qbittorrent-nox.service
      sudo systemctl status qbittorrent-nox.service  # 检查服务状态

访问 Web 用户界面

在浏览器中输入 http://YOUR_SERVER_IP:8080（将 YOUR_SERVER_IP 替换为服务器 IP 地址）即可访问 qBittorrent 的 Web 用户界面。使用配置文件中设置的用户名和密码登录。

小结与注意事项

• 正确安装 qbittorrent-nox 版本，确保安装的是无头版本，而不是图形界面版本。
• 安全配置 Web 用户界面：必须设置用户名和密码，并使用加密后的密码，防止未经授权的访问。
• 使用 systemd 管理服务，方便管理和自动启动，确保 qBittorrent 在服务器重启后自动运行。
• 配置防火墙，确保允许访问 Web 用户界面端口（默认 8080）和 qBittorrent 的监听端口，否则无法正常使用。

建议定期更新 qBittorrent 以获取最新的安全修复和功能；监控服务器资源使用情况，确保 qBittorrent 不会过度占用 CPU 和内存；如有隐私需求，可考虑使用 VPN 或代理服务器。