Ubuntu 编译安装 qBittorrent WebUI(qbittorrent-nox)完整教程

本文介绍在 Ubuntu 系统 下,通过 源码编译方式安装 qBittorrent WebUI(qbittorrent-nox),适用于服务器或无图形界面的环境。


一、安装编译所需依赖环境

1. 安装基础编译工具和 Boost 库

apt-get update
apt-get install -y build-essential \
libboost-dev libboost-system-dev \
libboost-chrono-dev libboost-random-dev \
libssl-dev libgeoip-dev

2. 安装 Git 与构建工具

apt-get install -y git pkg-config automake libtool

3. 安装 Qt5 开发库(qBittorrent WebUI 依赖)

apt-get install -y qtbase5-dev qttools5-dev-tools

4. 安装 Python 与 GeoIP 数据库

apt-get install -y python geoip-database

二、编译安装 libtorrent

1. 下载 libtorrent 源码

git clone https://github.com/arvidn/libtorrent.git
cd libtorrent

2. 切换到 1.0.x 稳定分支

git checkout RC_1_0

3. 编译并安装 libtorrent

./autotool.sh
./configure --disable-debug --enable-encryption \
--prefix=/usr --with-libgeoip=system

make clean
make
make install


三、编译安装 qBittorrent(WebUI 模式)

1. 下载 qBittorrent 源码包

qBittorrent 历史版本下载地址:
https://github.com/qbittorrent/qBittorrent/releases

3.3.11 版本 为例:

wget https://github.com/qbittorrent/qBittorrent/archive/release-3.3.11.tar.gz
tar -zxvf release-3.3.11.tar.gz
cd qBittorrent-release-3.3.11

2. 编译安装 qBittorrent WebUI

./configure --prefix=/usr --disable-gui
make
make install

3. 如提示缺少 zlib

apt-get install -y zlib1g-dev

安装后重新执行 make && make install


四、运行与配置 qBittorrent WebUI

1. 启动 qbittorrent-nox

qbittorrent-nox

首次运行会提示协议确认,输入 y 并回车。


2. WebUI 访问地址

http://服务器IP:8080

默认登录信息:

  • 用户名:admin

  • 密码:adminadmin

登录后请第一时间修改默认密码,确保安全。


3. 设置 WebUI 中文语言

  1. 登录 WebUI

  2. 进入【设置 → Web UI】

  3. 将语言改为 中文

  4. Ctrl + C 停止 qbittorrent-nox

  5. 重新运行:

qbittorrent-nox

刷新页面即可生效


五、总结

通过以上步骤,即可在 Ubuntu 系统下成功 编译安装 qBittorrent WebUI(qbittorrent-nox),适合:

  • VPS / 云服务器

  • 无桌面 Ubuntu

  • 需要长期后台运行 BT 客户端的场景

原创文章,作者:admin,如若转载,请注明出处:https://hostingchat.cn/18580.html

(0)
admin的头像admin
上一篇 2025年12月28日 下午7:56
下一篇 2025年12月29日

相关推荐

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注

QQ
分享本页
返回顶部