群晖Docker部署qbittorrent

Qbittorrent项目旨在提供 µTorrent 的开源软件替代方案。 qBittorrent 基于 Qt 工具包和 libtorrent-rasterbar 库。

Docker Compose部署

• docker-compose.yml
• docker-compose up -d # 执行 Docker Compose 命令
• 至于配置可自行添加或更改，具体可参考官方Configuration

version: "3"
services:
  qbittorrent:
    container_name: qbittorrent 
    image: linuxserver/qbittorrent
    volumes:
      - ./config:/config
      - ./downloads:/downloads
    ports: 
      # 查看端口占用
      # netstat -tunlp | grep 端口号
      - 12311:16611
      - 12312:16612
      - 12312:16612/udp
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Asia/Shanghai
      - WEBUI_PORT=12311
      - TORRENTING_PORT=12312
    restart: always

初始账号、密码请查看容器日志

• admin
• 3V5xhP7dF

qbittorrent
date	stream	content
2024/05/12 21:19:22	stdout	[ls.io-init] done.
2024/05/12 21:19:22	stderr	Connection to localhost (127.0.0.1) 12311 port [tcp/*] succeeded!
2024/05/12 21:19:22	stdout	You should set your own password in program preferences.
2024/05/12 21:19:22	stdout	The WebUI administrator password was not set. A temporary password is provided for this session: 3V5xhP7dF
2024/05/12 21:19:22	stdout	The WebUI administrator username is: admin
2024/05/12 21:19:22	stdout	
2024/05/12 21:19:22	stdout	To control qBittorrent, access the WebUI at: http://localhost:2311
2024/05/12 21:19:22	stdout	******** Information ********
2024/05/12 21:19:22	stdout	
2024/05/12 21:19:21	stdout	WebUI will be started shortly after internal preparations. Please wait...
2024/05/12 21:19:21	stdout	[custom-init] No custom files found, skipping...

qBittorrent 无法访问，提示 Unauthorized

• 下面的操作步骤我没测试，仅供参考。
• 只是之前遇到，但后来执行上述Docker-compose未出现

1、进入docker容器

docker exec -it qbittorrent  /bin/bash

2、编辑配置文件

进入容器后，找到qBittorrent的配置文件/config/qBittorrent/qBittorrent.conf，使用vim等编辑器打开该文件。

vim /config/qBittorrent/qBittorrent.conf

3、修改认证信息

在配置文件中找到以下两行，并进行相应修改：

# 将<your_username>和<your_password>替换为你自己设置的用户名和密码。
WebUI\Username=<your_username>
WebUI\Password=<your_password>

4、保存配置文件

保存修改后的配置文件，并退出编辑器。

5、重启docker容器

docker restart qbittorrent

若上述不行则参考如下：

1. 确保启动参数无误，尤其是配置文件的目录，必须是 qbittorrent 的父级目录，不可以到 qbittorrent 这一层。
2. 如果你是在外网通过 IP 访问内网服务器，则需查看 qbittorrent.conf 中，是否设置了 WebUI\HostHeaderValidation=true 参数，如有，请改为 false。
3. 如果你是在外网通过域名访问内网服务器，则第二条同样适用；但安全起见，建议改为 true 并把值设置为你的域名。
4. 如果你并未配置 HTTPS 证书，或未安装相关组件，则需查看 qbittorrent.conf 中，是否设置了 WebUI\HTTPS\Enabled=ture 参数，如有，请改为 false。
5. 如果你设置了 Nginx 反向代理，则需要根据官方 Wiki 设置以下参数（请删除其他所有参数）：
   • https://github.com/qbittorrent/qBittorrent/wiki/NGINX-Reverse-Proxy-for-Web-UI

roxy_pass         http://127.0.0.1:30000/; # 根据你的 IP 地址和端口号修改
proxy_http_version 1.1;
 
proxy_set_header   Host               127.0.0.1:30000; # 根据你的 IP 地址和端口号修改
proxy_set_header   X-Forwarded-Host   $http_host;
proxy_set_header   X-Forwarded-For    $remote_addr;
 
# 以下参数不适用于 qBittorrent！请务必移除（若有）
#proxy_set_header   X-Forwarded-Proto  $scheme;
#proxy_set_header   X-Real-IP          $remote_addr;
 
# 可选，设置后可一次性添加 100M 的种子
#client_max_body_size 100M;
 
# 从 4.2.2 版本起，若你在 qBittorrent 内部设置了 HTTPS，则不需要设置以下参数。否则，必须设置以下参数用以保证 Cookie 的安全性
proxy_cookie_path  /                  "/; Secure";