群晖安装qBittorrent

群晖 NAS 部署 qBittorrent 教程（基于 Container Manager）

本教程适用于群晖 DSM 7.2 及以上版本，使用 Container Manager 图形界面进行部署。

🧩 一、前置准备

  • 群晖系统已安装 Container Manager
  • 群晖设备支持 Docker host 模式网络
  • 已准备好下载文件夹（如 /volume2/Media）
  • 了解你的局域网代理地址（如有）

📁 二、创建项目和下载目录结构

使用 File Station 或通过 SSH 终端创建以下目录：

qBittorrent目录

1
mkdir -p /volume1/docker/qbittorrent/config

下载目录（根据你自己的情况来）

1
2
mkdir -p /volume2/Media/downloads #下载目录
mkdir -p /volume2/Media/link  #硬链接目录

🧰 三、创建项目（Container Manager 操作）

  1. 打开 DSM > Container Manager

  2. 点击左侧菜单栏中的 项目

  3. 点击右上角的 新增 按钮

  4. 项目名称 可填 qbittorrent

  5. 设置 项目路径 为：

    1
    /volume1/docker/qbittorrent

  6. 在”docker-compose”配置框中粘贴以下内容：

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    version: "3"
    services:
      qbittorrent:
        image: linuxserver/qbittorrent:latest
        container_name: qbittorrent
        environment:
          - WEBUI_PORT=8085
          - PUID=1000
          - PGID=1000
          - TZ=Asia/Shanghai
          - NO_PROXY=172.17.0.1,127.0.0.1,localhost
          - ALL_PROXY=http://192.168.121.165:7890
          - HTTP_PROXY=http://192.168.121.165:7890
        volumes:
          - /volume1/docker/qbittorrent/config:/config
          - /volume2/Media:/media   # 你的下载目录
        network_mode: host
        restart: unless-stopped

🚀 四、启动项目

  1. 检查配置无误后点击页面右下角的 创建并启动
  2. 容器将自动拉取镜像并启动服务
  3. 启动完成后，可在”容器”页面看到 qBittorrent 正常运行

🌐 五、访问 qBittorrent

  • Web 界面访问地址：

    http://你的群晖IP:8085

  • 默认登录信息：

    • 用户名：admin
    • 密码：adminadmin

⚙️ 六、基本设置

  1. 修改默认密码

    • 登录后点击”工具” > “选项”
    • 在”Web UI”选项卡中修改密码

  2. 配置下载目录

    • 点击”工具” > “选项”
    • 在”下载”选项卡中设置默认保存路径为 /media/downloads

  3. 配置代理（可选）

    • 点击”工具” > “选项”
    • 在”连接”选项卡中配置代理服务器

🔧 七、常见问题

1. 代理设置

如果需要修改代理设置：

  1. 在Container Manager中停止qBittorrent容器
  2. 编辑容器设置
  3. 修改环境变量中的代理相关配置：
    1
    2
    - ALL_PROXY=http://你的代理地址:端口
    - HTTP_PROXY=http://你的代理地址:端口

2. 权限问题

如果遇到权限问题：

  1. 确保下载文件夹的权限设置正确
  2. 检查PUID和PGID设置是否正确
  3. 可以尝试使用root用户运行（user: “0:0”）

3. 性能优化

  • 使用host网络模式提升网络性能
  • 适当设置并发连接数
  • 使用SSD缓存提升性能
  • 定期清理日志文件

🔒 八、安全建议

  1. 设置强密码
  2. 启用HTTPS（可选）
  3. 限制远程访问
  4. 及时更新容器版本
  5. 注意代理服务器的安全性

📚 九、参考资源