已配置开机自启:通过创建/etc/systemd/system/qbittorrent-nox.service服务文件,执行systemctl daemon-reload、enable和start命令,即可实现系统启动时自动运行qbittorrent-nox。

如果您已成功安装 qBittorrent-nox,但每次重启系统后都需要手动启动服务才能继续下载任务,则说明尚未配置开机自动启动。以下是针对不同部署方式设置 qBittorrent 开机自启的具体操作步骤:
一、使用 systemd 服务配置自启动(推荐用于 Debian/Ubuntu 等主流 Linux 发行版)
该方法通过创建标准 systemd 服务单元文件,使系统在启动时自动拉起 qbittorrent-nox 进程,并以指定用户身份持续运行。适用于直接通过 apt 安装的 qbittorrent-nox。
1、使用 nano 编辑新服务文件:sudo nano /etc/systemd/system/qbittorrent-nox.service
2、粘贴以下完整服务定义内容(注意保持格式无缩进错误):
[Unit]
Description=qBittorrent-nox
After=network.target
[Service]
User=root
Type=forking
RemainAfterExit=yes
ExecStart=/usr/bin/qbittorrent-nox -d
[Install]
WantedBy=multi-user.target
3、保存并退出 nano:按 Ctrl+O → Enter → Ctrl+X
4、重载 systemd 配置以识别新服务:sudo systemctl daemon-reload
5、启用开机自启:sudo systemctl enable qbittorrent-nox
6、立即启动服务验证:sudo systemctl start qbittorrent-nox
二、使用传统 SysV init 脚本方式(适用于旧版或精简系统)
当系统未启用 systemd 或需兼容 init.d 机制时,可手动创建 service 脚本并注册为系统服务,通过 service 命令统一管理启停行为。
1、创建初始化脚本:sudo nano /etc/init.d/qbittorrent
2、填入以下内容(确保第一行 #!/bin/sh 存在且路径正确):
#!/bin/sh
### BEGIN INIT INFO
# Provides: qbittorrent
# Required-Start: $local_fs $network
# Required-Stop: $local_fs
# Default-Start: 2 3 4 5
# Default-Stop: 0 1 6
# Short-Description: qBittorrent daemon
### END INIT INFO
case "$1" in
start)
su -c "/usr/bin/qbittorrent-nox -d" -s /bin/sh root
;;
stop)
killall qbittorrent-nox
;;
restart)
$0 stop
$0 start
;;
*)
echo "Usage: /etc/init.d/qbittorrent {start|stop|restart}"
exit 1
esac
exit 0
3、赋予执行权限:sudo chmod +x /etc/init.d/qbittorrent
4、注册为系统服务:sudo update-rc.d qbittorrent defaults
5、测试启动:sudo service qbittorrent start
三、Docker 部署场景下的自启动配置
若 qBittorrent 以 Docker 容器方式运行,其开机自启依赖于 Docker 服务本身已启用自启,并通过容器的重启策略实现。关键在于确保容器始终处于运行状态。
1、确认 Docker 已启用开机自启:sudo systemctl enable docker
2、检查当前 qBittorrent 容器的重启策略:docker inspect qbittorrent | grep -i restartpolicy
3、如未设置或策略为 "no",重新运行容器并指定 --restart=always 参数:docker run -d --name qbittorrent --restart=always -p 8080:8080 -v /path/to/config:/config -v /path/to/downloads:/downloads linuxserver/qbittorrent
4、若容器已存在,先停止并移除:docker stop qbittorrent && docker rm qbittorrent
5、按第3步命令重新创建并启动容器
四、NAS 设备(如绿联云、群晖)中的自启动设置
多数成品 NAS 提供图形化应用中心或容器管理界面,自启动由平台统一调度,无需手动编写服务文件。操作核心是启用“开机自动运行”开关并确保容器配置持久化。
1、进入 NAS 的“Docker”或“容器管理”应用界面
2、定位已部署的 qBittorrent 容器,点击“编辑”或“设置”
3、在“高级设置”或“重启策略”中,选择:总是重新启动
4、确认“自动启动”或“开机自启”选项已被勾选
5、检查挂载路径是否全部设为“读写”,特别是 /config 和 /downloads 目录映射正确
6、保存配置并重启 NAS 验证容器是否自动拉起











