飞牛NAS（fnOS）作为一款面向家庭和个人用户的国产NAS系统，凭借其简洁的界面和强大的Docker支持，正在成为不少玩家手中的“宝藏设备”。今天，我们不聊系统设置，也不聊影音管理，而是聚焦一个非常实用的下载工具——qBittorrent。qBittorrent是一款开源、无广告、跨平台的BT下载软件，功能上完全可以媲美µTorrent，而且没有“全家桶”烦恼。本文将手把手带你，在飞牛NAS上通过Docker部署qBittorrent，并将其配置成一台随时待命、下载速度可观的全能下载机。
准备工作：获取必要信息
在开始部署之前，请先登录你的飞牛NAS后台，并确认以下信息：
- 系统版本：建议使用fnOS最新稳定版，确保Docker功能正常。
- 存储路径：规划好下载目录和配置目录。建议在NAS的存储空间下新建一个名为
qbit 的文件夹，里面再建 config 和 downloads 两个子文件夹，便于后期管理。
- 网络环境：确保NAS能正常访问外网，且路由器支持UPnP或你拥有端口转发权限（用于提升下载连通率）。
第一步：在Docker中搜索镜像
打开飞牛NAS的「Docker」应用，进入「镜像」页面，点击「搜索」。在搜索框输入 qbittorrent，回车。你会看到多个镜像，这里推荐使用 lscr.io/linuxserver/qbittorrent 这个版本，它是LinuxServer.io团队维护的，更新及时，稳定性高，且默认配置对新手友好。
找到镜像后，点击「下载」，标签选择 latest 即可。等待镜像拉取完成。
第二步：创建并配置容器
镜像下载完成后，不要急着运行，我们先点击「创建容器」，进行详细的配置。这一步是核心，请仔细操作。
2.1 基础设置
在「容器」创建向导中，给容器起个名字，比如 qbit。启用「高级权限」或「特权模式」？这里建议不要开启特权模式，我们只需映射端口和挂载目录即可。
2.2 端口映射
qBittorrent的Web界面默认端口是 8080，而BT下载的监听端口（Peers端口）是 6881。我们需要将它们映射到NAS的物理网口上。
在「端口设置」中，添加两条映射规则：
- 本地端口
8080 映射容器端口 8080（用于Web界面访问）
- 本地端口
6881 映射容器端口 6881（用于DHT和Peer连接）
如果你有多个下载任务，建议同时映射TCP和UDP协议的 6881 端口。如果你的路由器支持UPnP，Docker会自动尝试映射，但手动映射更稳妥。
2.3 存储空间映射
点击「存储空间」选项卡，我们将NAS上的文件夹挂载到容器内。
- 将你之前创建的
qbit/config 目录挂载到 /config
- 将
qbit/downloads 目录挂载到 /downloads
这样，下载的文件会直接存放到NAS的存储池中，方便后续通过飞牛的文件管理或SMB共享访问。
2.4 环境变量
qBittorrent镜像支持通过环境变量调整一些参数。我们主要设置两项：
PUID=1000 和 PGID=1000，这是为了让容器内文件与NAS用户权限一致，避免文件无法删除或修改。TZ=Asia/Shanghai，设置时区为中国标准时间，确保日志和计划任务时间正确。
如果你不清楚PUID/PGID，可以在飞牛的「终端」或SSH中执行 id 命令查看当前用户的ID，一般第一个用户都是1000。
2.5 网络模式
网络选择 bridge（桥接模式）即可。如果你希望使用NAS的独立IP来访问qBittorrent，可以选择 host 模式，但那样端口映射会变得复杂，不建议新手使用。
一切配置完成后，点击「创建」并「启动」容器。
第三步：初始化与基础配置
容器启动后，在浏览器中访问 http://你的NAS_IP:8080。首次打开，qBittorrent会提示你设置Web UI的登录密码。默认用户名是 admin，密码会随机生成在容器日志中。你可以通过飞牛Docker的「日志」功能查看，找到类似 The Web UI administrator password is set to: xxxxxx 的字样。
登录后，强烈建议立即修改密码：点击界面右上角的「齿轮」图标，进入「Web UI」选项卡，在「认证」设置中修改用户名和密码。
3.1 调整下载与连接设置
进入「选项」->「连接」，将「端口用于传入连接」设置为 6881，确保与端口映射一致。勾选「使用UPnP / NAT-PMP端口转发」以优化外网连通性。
在「BitTorrent」选项卡中，建议开启「启用DHT」和「启用PeX」，这有助于找到更多资源，尤其是冷门种子。
3.2 设置自动保存与分类
在「下载」选项卡中，设置「默认保存路径」为 /downloads。你还可以在此添加分类，比如“电影”、“音乐”、“软件”，每个分类指定独立的子文件夹，实现自动归档。
第四步：进阶玩法与技巧
部署完成后，qBittorrent已经可以正常工作了。这里再分享几个提升体验的小技巧：
qBittorrent内置RSS订阅功能。你可以将某些资源站的RSS链接添加到「RSS」选项卡中，并设置「下载规则」按关键词（比如剧集名）自动下载。这样新番更新时，NAS会自动为你拉取资源。
4.2 设置速度限制
在「选项」->「速度」中，可以设置全局下载/上传限速。建议设置一个合理的上传速度，避免抢占家庭带宽，影响其他设备上网。
4.3 使用备用Web UI
qBittorrent默认Web界面比较简洁。你可以下载主题包，放在 qbit/config 的 themes 目录下，然后在「Web UI」中切换，让界面更美观。社区流行的 vuetorrent 主题值得一试。
4.4 定期清理与监控
由于下载任务会占用空间，建议开启「自动清理」功能：在「BitTorrent」选项卡中，设置「当磁盘空间低于X GB时自动停止任务」。另外，可以安装飞牛自带的「资源监控」小组件，随时查看容器CPU和内存占用。
常见问题排查
如果你发现下载速度上不去，或者无法连接Peer，请依次检查：
- 路由器是否正确转发了
6881 端口？可以在qBittorrent的「连接」页面点「测试端口」按钮验证。
- 防火墙是否拦截了Docker的端口？飞牛NAS默认防火墙通常放行，但如果你自定义过规则，需要手动添加入站规则。
- 检查种子是否健康，有些资源本身做种人数极少，速度慢属于正常现象。
总结
通过飞牛NAS的Docker功能，我们仅用几步就完成了一个功能完整的qBittorrent下载机部署。它不仅支持BT/磁力链，还具备RSS订阅、限速、分类管理等实用功能，能够轻松应对日常下载需求。更重要的是，借助飞牛NAS的存储管理，下载的文件可以无缝融入你的家庭影音中心。希望这篇教程能帮你顺利搭建出属于自己的高速下载环境，享受省心高效的下载体验。