想在群晖NAS上搭建一个稳定高效的BT/PT下载环境，qBittorrent无疑是首选。不过，它的安装方式不止一种，选对方法能让后续管理省心不少。这里有三套经过实测的部署方案，从“一键搞定”到“精细掌控”都有覆盖，你可以根据自己的技术偏好来选。

一、套件中心一键安装（新手适用）

对于刚接触NAS下载的朋友来说，最省事的办法莫过于直接使用群晖自带的套件中心。官方维护的qBittorrent套件在这里可以直接安装，整个过程不用碰任何命令行或Docker界面，系统会自动处理好所有依赖。

安装后，Web管理界面默认运行在8080端口，初始的用户名和密码分别是admin和adminadmin。具体操作步骤如下：

1. 登录群晖DSM系统，打开桌面上的【套件中心】。

2. 在右上角的搜索框里输入“qBittorrent”进行搜索。如果没找到结果，可能需要先开启第三方套件源：进入【套件中心】的【设置】选项，找到【信任等级】，勾选“任何发布者”后，再重新搜索一次。

3. 找到qBittorrent套件后，直接点击【安装】按钮，等待进度条走完即可。

4. 安装完成后，你可以在套件中心列表里，点击qBittorrent右侧的【打开】按钮。或者，直接在浏览器地址栏输入 http://你的NAS_IP地址:8080 来访问Web界面。

5. 首次登录后，务必立即修改默认密码：点击右上角的用户名，进入【选项】->【用户账户】，在这里设置一个新的用户名和强密码。

二、Container Manager图形化Docker部署（通用推荐）

如果你希望拥有更大的控制权，同时又能享受图形化操作的便利，那么通过Container Manager（Docker的群晖版本）来部署是更推荐的方式。它不仅能让你用上最新版本的qBittorrent，还能灵活配置端口、文件路径，并支持IPv6、UPnP等高级功能。

1. 首先，确保你的群晖上已经安装了【Container Manager】套件。如果还没装，去套件中心搜索安装即可。

2. 打开Container Manager，在左侧选择【注册表】，然后在右侧搜索框输入“qbittorrent”。在结果中找到“linuxserver/qbittorrent”这个官方镜像，点击右侧的【下载】按钮，标签选择“latest”，然后点击【应用】等待镜像拉取完成。

3. 下载完成后，切换到【映像】标签页。找到刚下载的qbittorrent镜像，右键点击并选择【运行】。给容器起个名字，比如“qbittorrent”，并务必勾选上【启用自动重新启动】选项。

4. 点击【下一步】进入高级设置。在【网络】选项卡中，将网络模式设置为“host”。这个模式能避免在bridge模式下可能出现的IPv6支持问题和端口转发异常。

5. 切换到【卷】选项卡，这里需要挂载两个关键目录：点击【添加文件夹】，在左侧选择NAS上你打算存放配置文件的路径（例如 /volume1/docker/qbittorrent/config），右侧容器路径填写“/config”。用同样的方法，再添加一个下载目录，映射到“/downloads”。

6. 接下来是【端口设置】。建议先清空默认的端口映射，然后手动添加两条：将主机的8099端口映射到容器的8080端口（这是Web管理界面）；再将主机的52000端口映射到容器的6881端口（用于BT连接，TCP和UDP协议都需要，选用非常用端口可以避开一些ISP的限制）。

7. 最后，在【环境】选项卡中添加几个必要的变量：WEBUI_PORT=8080, PUID=1026（这里填写你DSM系统第一个用户的UID，通常就是管理员）, PGID=100（默认用户组的GID）, TZ=Asia/Shanghai。

8. 点击【下一步】然后【完成】，回到【容器】标签页，启动你刚刚创建的qbittorrent容器就大功告成了。

三、Docker Compose命令行部署（进阶可控）

对于追求极致控制和自动化的进阶用户，Docker Compose方案是首选。它通过一个YAML配置文件定义所有服务参数，特别适合需要批量管理、锁定软件版本，或者未来打算集成微信通知、自动化脚本等高级玩法的场景。所有配置一目了然，备份和迁移也变得异常简单。

1. 首先需要开启群晖的SSH功能：进入【控制面板】->【终端机和SNMP】，勾选【启用SSH服务】，端口默认22即可，点击【应用】。

2. 使用PuTTY、Terminal等SSH工具连接到你的NAS。连接成功后，执行以下命令来创建项目目录并进入：

mkdir -p /volume1/docker/qbittorrent/compose && cd /volume1/docker/qbittorrent/compose

3. 使用nano编辑器创建配置文件：

nano docker-compose.yml

4. 将以下配置内容粘贴进去（注意：YAML文件对缩进敏感，请使用两个空格，不要用Tab键）：

version: "3"
services:
  qbittorrent:
    image: lscr.io/linuxserver/qbittorrent:latest
    container_name: qbittorrent
    environment:
      - PUID=1026
      - PGID=100
      - TZ=Asia/Shanghai
      - WEBUI_PORT=8080
      - TORRENTING_PORT=6881
    volumes:
      - /volume1/docker/qbittorrent/config:/config
      - /volume1/QB_Downloads:/downloads
    ports:
      - 8099:8080
      - 52000:6881/tcp
      - 52000:6881/udp
    restart: unless-stopped

5. 粘贴后，按 Ctrl+O 保存文件，回车确认文件名，再按 Ctrl+X 退出编辑器。

6. 在同一个目录下，执行命令启动服务：

docker-compose up -d

7. 你可以用下面的命令来确认容器是否正常运行：

docker ps | grep qbittorrent

8. 一切就绪后，打开浏览器，访问 http://你的NAS_IP地址:8099，使用默认账号密码登录，就可以开始你的下载之旅了。

《夸克》非常好用的免费AI浏览器

下载APP查看