docker-qbittorrent-ghost

镜像概述和主要用途

docker-qbittorrent-ghost是一个基于linuxserver/qbittorrent的Docker配置包装器镜像。该镜像旨在简化qBittorrent（一款流行的BitTorrent客户端）的部署与配置管理过程，通过集成配置封装逻辑，帮助用户更便捷地设置和运行qBittorrent服务，减少手动配置的复杂度。

核心功能和特性

• 配置简化：作为linuxserver/qbittorrent的配置包装层，提供更简洁的配置入口，降低初始部署门槛。
• 兼容性：完全兼容linuxserver/qbittorrent镜像的核心功能与运行机制，确保qBittorrent客户端功能完整。
• 配置持久化：支持配置文件的持久化存储，通过卷挂载确保配置变更在容器重启后不丢失。
• 灵活扩展：保留自定义配置能力，用户可通过环境变量或配置文件调整qBittorrent参数。

使用场景和适用范围

• 个人用户：适合需要快速部署qBittorrent且希望减少配置步骤的个人用户。
• 家庭媒体服务器：在家庭NAS或媒体服务器中集成qBittorrent时，简化配置流程。
• 小型部署环境：适用于对qBittorrent配置管理有简化需求的小型服务器或测试环境。

详细使用方法和配置说明

基本部署命令

通过docker run命令快速启动容器：

bash
docker run -d \
  --name=qbittorrent-ghost \
  -p 8080:8080 \  # Web UI访问端口
  -p 6881:6881 \  # BT协议TCP监听端口
  -p 6881:6881/udp \  # BT协议UDP监听端口
  -v /本地路径/config:/config \  # 配置文件持久化目录
  -v /本地路径/downloads:/downloads \  # 下载文件存储目录
  --restart unless-stopped \
  [镜像名称]:[标签]  # 替换为实际镜像名称和标签

环境变量配置

该镜像支持通过环境变量调整基础配置（具体变量需参考***镜像文档，以下为常见示例）：

卷挂载说明

docker-compose配置示例

yaml
version: '3'
services:
  qbittorrent-ghost:
    image: [镜像名称]:[标签]  # 替换为实际镜像信息
    container_name: qbittorrent-ghost
    ports:
      - "8080:8080"
      - "6881:6881"
      - "6881:6881/udp"
    volumes:
      - /本地/config路径:/config
      - /本地/downloads路径:/downloads
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Asia/Shanghai
      - WEBUI_PORT=8080
    restart: unless-stopped

注意事项

• 确保本地挂载目录具有正确的读写权限（建议与PUID/PGID匹配），避免权限问题导致配置无法保存或下载失败。
• 该镜像的核心功能依赖于linuxserver/qbittorrent，详细的qBittorrent客户端功能（如种子管理、速度限制等）可参考linuxserver/qbittorrent***文档。
• 如需自定义高级配置，可直接编辑/config目录下的qBittorrent.conf文件，修改后重启容器生效。