vincejv/qbittorrent-exporter Docker 镜像 - 轩辕镜像

qbittorrent-exporter

镜像概述和主要用途

qbittorrent-exporter是qBittorrent应用的Prometheus exporter，基于Quarkus Fork以降低内存使用和加快启动速度。需配合qBittorrent 4.1.0及更高版本使用，特别适用于与qbittorrent-grafana-dashboard集成，实现qBittorrent运行状态的监控与可视化。

项目GitHub仓库：[]
DockerHub地址：[]

核心功能和特性

• 作为Prometheus exporter，收集qBittorrent的运行指标
• 基于Quarkus Fork，相比原版降低内存占用并加快启动速度
• 支持通过环境变量配置qBittorrent连接信息
• 可与Grafana仪表盘无缝集成，实现监控数据可视化

使用场景和适用范围

适用于需要监控qBittorrent下载器运行状态的用户，尤其是在资源受限环境中（如低配置服务器、NAS设备等），通过Prometheus收集指标并结合Grafana展示，可实时掌握下载速度、种子状态、资源占用等关键信息。

使用方法和配置说明

Docker运行

通过以下命令直接运行容器：

bash
docker run \
    --name=qbittorrent-exporter \
    -e QBITTORRENT_USERNAME=username \  # qBittorrent用户名
    -e QBITTORRENT_PASSWORD=password \  # qBittorrent密码
    -e QBITTORRENT_BASE_URL=http://localhost:8080 \  # qBittorrent基础URL
    -p ***:*** \  # 暴露 exporter 端口
    vincejv/qbittorrent-exporter:latest

Docker Compose配置

创建docker-compose.yaml文件：

yaml
version: "3"
services:
  qbt-exporter:
    image: vincejv/qbittorrent-exporter:latest
    container_name: qbt-exporter
    networks:
      int-static-br:
        ipv4_address: 172.18.0.34  # 根据实际网络配置调整
    environment:
      - QBITTORRENT_USERNAME=none  # qBittorrent用户名
      - QBITTORRENT_PASSWORD=none  # qBittorrent密码
      - QBITTORRENT_BASE_URL=[***]  # qBittorrent基础URL
      - QBITTORRENT_LOCALE=en-US  # 区域设置
    extra_hosts:
      - "host.docker.internal:host-gateway"  # 允许容器访问宿主机
    restart: unless-stopped  # 除非手动停止，否则自动重启
    depends_on:
      - qbittorrent  # 依赖qbittorrent服务
    logging:
      options:
        max-size: "20m"  # 日志文件最大大小
        max-file: "5"  # 最大日志文件数
        compress: "true"  # 压缩日志

参数说明

配置Prometheus

在Prometheus服务器的prometheus.yml配置文件中添加以下scrape_configs：

yaml
scrape_configs:
  - job_name: 'qbittorrent'
    static_configs:
      # 更新为qbittorrent-exporter的IP地址和端口
      - targets: [ '192.168.1.100:***' ]

本地构建

通过以下命令本地构建应用和Docker镜像：

bash
./gradlew build  # 构建应用
docker build .   # 构建Docker镜像