vincejv/qbittorrent-exporter

qbittorrent-exporter

镜像概述和主要用途

qbittorrent-exporter是qBittorrent应用的Prometheus exporter，基于Quarkus Fork以降低内存使用和加快启动速度。需配合qBittorrent 4.1.0及更高版本使用，特别适用于与https://github.com/caseyscarborough/qbittorrent-grafana-dashboard%E9%9B%86%E6%88%90%EF%BC%8C%E5%AE%9E%E7%8E%B0qBittorrent%E8%BF%90%E8%A1%8C%E7%8A%B6%E6%80%81%E7%9A%84%E7%9B%91%E6%8E%A7%E4%B8%8E%E5%8F%AF%E8%A7%86%E5%8C%96%E3%80%82

项目GitHub仓库：https://github.com/vincejv/qbittorrent-exporter
DockerHub地址：https://hub.docker.com/r/caseyscarborough/qbittorrent-exporter

核心功能和特性

• 作为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 17871:17871 \  # 暴露 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=http://qbt.docker.internal:9089  # 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:17871' ]

本地构建

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

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