Linux系统下通过宝塔面板安装qBittorrent-nox

一、环境准备

1. 确保系统已安装宝塔面板

2. 建议使用screen会话防止中断：

   sudo apt install screen -y
   screen -S qb_install

二、安装步骤

1. 下载主程序

# 创建下载目录（可按需修改）
QB_DIR="/www/wwwroot/downloads"
sudo mkdir -p $QB_DIR

# 下载静态编译版qBittorrent
sudo wget -qO $QB_DIR/qbittorrent-nox \
https://github.com/userdocs/qbittorrent-nox-static/releases/latest/download/x86_64-qbittorrent-nox

# 授予执行权限
sudo chmod 700 $QB_DIR/qbittorrent-nox

2. 创建系统服务

sudo tee /etc/systemd/system/qbittorrent-nox.service <<EOF
[Unit]
Description=qBittorrent Daemon Service
After=network.target

[Service]
User=www  # 建议使用非root用户
Type=forking
LimitNOFILE=infinity
ExecStart=$QB_DIR/qbittorrent-nox -d \
          --webui-port=8088 \
          --profile=$QB_DIR \
          --confirm-legal-notice
ExecStop=/usr/bin/killall -s 9 qbittorrent-nox
Restart=on-failure

[Install]
WantedBy=multi-user.target
EOF

# 重载服务配置
sudo systemctl daemon-reload

3. 启动服务

sudo systemctl start qbittorrent-nox.service
sudo systemctl enable qbittorrent-nox.service

# 检查状态
systemctl status qbittorrent-nox.service

4. 配置WebUI访问

1. 首次访问：http://服务器IP:8088

2. 停止服务修改配置：

   sudo systemctl stop qbittorrent-nox.service

3. 修改配置文件：

   sudo nano $QB_DIR/qBittorrent/qBittorrent.conf

   添加/修改以下内容：

   [Preferences]
   WebUI\Port=8088
   WebUI\Username=admin
   WebUI\Password_PBKDF2="@ByteArray(ARQ77eY1NUZaQsuDHbIMCA==:0WMRkYTUWVT9wVvdDtHAjU9b3b7uB8NR1Gur2hmQCvCDpm39Q+PsJRJPaCU51dEiz+dTzh8qbPsL8WkFljQYFQ==)"

4. 重启服务：

   sudo systemctl start qbittorrent-nox.service

三、访问管理

• 访问地址：http://服务器IP:8088

• 初始凭证：

  • 用户名：admin
  • 密码：adminadmin
• 首次登录后请立即修改密码

四、安全建议

1. 建议在宝塔面板配置反向代理和SSL证书
2. 可考虑修改默认端口（8088）

3. 配置防火墙放行端口：

   sudo ufw allow 8088/tcp
   sudo ufw allow 6881/tcp  # BT端口

五、卸载方法

# 停止并禁用服务
sudo systemctl stop qbittorrent-nox.service
sudo systemctl disable qbittorrent-nox.service

# 移除服务文件
sudo rm -f /etc/systemd/system/qbittorrent-nox.service
sudo systemctl daemon-reload

# 删除程序文件
sudo rm -rf $QB_DIR/qbittorrent-nox
sudo rm -rf $QB_DIR/qBittorrent

# 清理残留（谨慎操作）
sudo find / -name "*qbittorrent*" -exec rm -rf {} + 2>/dev/null
sudo find / -name "*qBittorrent*" -exec rm -rf {} + 2>/dev/null

常见问题

1. 端口冲突：修改--webui-port参数和配置文件中的端口号
2. 内存不足：添加交换空间sudo fallocate -l 2G /swapfile && sudo mkswap /swapfile && sudo swapon /swapfile
3. 登录问题：检查qBittorrent.conf文件权限应为600