ngosang/deluge-exporter

ngosang/deluge-exporter

![]([]

Docker镜像源代码在GitHub上 => https://github.com/ngosang/deluge-exporter

镜像概述和主要用途

ngosang/deluge-exporter是Deluge Bittorrent客户端的Prometheus导出器。它设计为使用Deluge Web API，且具有轻量级特性，已通过Deluge 2.1版本测试。

与其他Deluge导出器（如https://github.com/***%EF%BC%89%E7%9B%B8%E6%AF%94%EF%BC%8C%E6%9C%AC%E5%AF%BC%E5%87%BA%E5%99%A8%E4%B8%93%E6%B3%A8%E4%BA%8E%E5%8F%AF%E9%9D%A0%E6%80%A7%E5%92%8C%E6%80%A7%E8%83%BD%E3%80%82%E5%85%B6%E4%BB%96%E5%AF%BC%E5%87%BA%E5%99%A8%E9%80%9A%E5%B8%B8%E4%BD%BF%E7%94%A8Python%E7%9A%84https://github.com/JohnDoee/deluge-client%E5%BA%93%EF%BC%8C%E8%AF%A5%E5%BA%93%E4%BE%9D%E8%B5%96Deluge RPC API（功能更全但与Deluge版本强相关），存在https://github.com/***/issues/23%E4%B8%94%E8%B5%84%E6%BA%90%E5%8D%A0%E7%94%A8%E8%BE%83%E9%AB%98%EF%BC%8C%E8%80%8C%E6%9C%AC%E5%AF%BC%E5%87%BA%E5%99%A8%E9%80%9A%E8%BF%87Web API避免了这些问题。

核心功能和特性

• 轻量级设计：基于Deluge Web API，资源占用低
• 可靠监控：避免RPC API的版本依赖和重连问题
• 丰富指标：提供种子状态/标签计数、下载/上传速率、连接数等关键指标
• 多架构支持：兼容多种CPU架构（386、amd64、arm系列等）
• 环境变量配置：通过环境变量轻松配置，无需复杂配置文件

使用场景和适用范围

适用于需要监控Deluge Bittorrent客户端运行状态的场景，包括：

• 个人用户监控本地Deluge客户端的下载/上传性能
• 服务器管理员监控Deluge服务的资源使用和种子状态
• 集成到Prometheus+Grafana监控系统，实现可视化和告警

详细使用方法和配置说明

安装方式

从源代码安装

依赖要求：

• Python 3
• https://github.com/prometheus/client_python
• requests

bash
pip install -r /requirements.txt

export DELUGE_URL=http://192.168.1.191:8112
export DELUGE_PASSWORD=<password_here>
python deluge-exporter.py

Docker安装

Docker镜像可在https://github.com/ngosang/deluge-exporter/pkgs/container/deluge-exporter%E5%92%8Chttps://hub.docker.com/r/ngosang/deluge-exporter%E8%8E%B7%E5%8F%96%EF%BC%9A

bash
docker pull ghcr.io/ngosang/deluge-exporter
# 或
docker pull ngosang/deluge-exporter

支持的架构

本镜像支持以下架构：

• linux/386
• linux/amd64
• linux/arm/v6
• linux/arm/v7
• linux/arm64/v8
• linux/ppc64le
• linux/s390x

docker-compose配置

兼容docker-compose v2架构：

yaml
---
version: '2.1'
services:
  deluge-exporter:
    image: ngosang/deluge-exporter
    container_name: deluge-exporter
    environment:
      - TZ=Europe/Madrid
      - DELUGE_URL=http://192.168.1.191:8112
      - DELUGE_PASSWORD=<password_here>
      - LOG_LEVEL=INFO
    ports:
      - "8011:8011"
    restart: unless-stopped

Docker CLI命令

bash
docker run -d \
  --name=deluge-exporter \
  -e TZ=Europe/Madrid \
  -e DELUGE_URL=http://192.168.1.191:8112 \
  -e DELUGE_PASSWORD=<password_here> \
  -e LOG_LEVEL=INFO \
  -p 8011:8011 \
  --restart unless-stopped \
  ngosang/deluge-exporter

配置说明

所有配置通过环境变量实现：

• DELUGE_URL：Deluge Web UI URL，例如：http://192.168.1.191:8112（必填）
• DELUGE_PASSWORD：Deluge Web UI的明文密码（必填）
• LISTEN_PORT：（可选）导出器监听端口，默认8011
• LISTEN_ADDRESS：（可选）导出器监听地址，默认监听所有地址
• LOG_LEVEL：（可选）日志级别，默认INFO

导出的指标

shell
# HELP deluge_torrent_state_count 按状态分类的种子数量
# TYPE deluge_torrent_state_count gauge
deluge_torrent_state_count{state="all"} 18.0
deluge_torrent_state_count{state="active"} 0.0
deluge_torrent_state_count{state="allocating"} 0.0
deluge_torrent_state_count{state="checking"} 0.0
deluge_torrent_state_count{state="downloading"} 1.0
deluge_torrent_state_count{state="seeding"} 16.0
deluge_torrent_state_count{state="paused"} 1.0
deluge_torrent_state_count{state="error"} 0.0
deluge_torrent_state_count{state="queued"} 0.0
deluge_torrent_state_count{state="moving"} 0.0
# HELP deluge_torrent_label_count 按标签分类的种子数量
# TYPE deluge_torrent_label_count gauge
deluge_torrent_label_count{label=""} 1.0
deluge_torrent_label_count{label="all"} 18.0
deluge_torrent_label_count{label="educational"} 3.0
deluge_torrent_label_count{label="music"} 14.0
# HELP deluge_max_download Deluge最大下载速率指标
# TYPE deluge_max_download gauge
deluge_max_download 20000.0
# HELP deluge_max_upload Deluge最大上传速率指标
# TYPE deluge_max_upload gauge
deluge_max_upload 10000.0
# HELP deluge_max_num_connections Deluge最大连接数指标
# TYPE deluge_max_num_connections gauge
deluge_max_num_connections 500.0
# HELP deluge_num_connections Deluge当前连接数指标
# TYPE deluge_num_connections gauge
deluge_num_connections 19.0
# HELP deluge_upload_rate Deluge上传速率指标
# TYPE deluge_upload_rate gauge
deluge_upload_rate 0.0
# HELP deluge_download_rate Deluge下载速率指标
# TYPE deluge_download_rate gauge
deluge_download_rate 152602.0
# HELP deluge_download_protocol_rate Deluge协议下载速率指标
# TYPE deluge_download_protocol_rate gauge
deluge_download_protocol_rate 6642.0
# HELP deluge_upload_protocol_rate Deluge协议上传速率指标
# TYPE deluge_upload_protocol_rate gauge
deluge_upload_protocol_rate 9711.5
# HELP deluge_dht_nodes Deluge DHT节点数指标
# TYPE deluge_dht_nodes gauge
deluge_dht_nodes 389.0
# HELP deluge_has_incoming_connections Deluge是否有入站连接指标
# TYPE deluge_has_incoming_connections gauge
deluge_has_incoming_connections 1.0
# HELP deluge_free_space Deluge可用空间指标
# TYPE deluge_free_space gauge
deluge_free_space 3.588696727552e+012

Prometheus配置示例

yaml
scrape_configs:
  - job_name: 'deluge-exporter'
    static_configs:
      - targets: ['192.168.1.100:8011']  # 替换为导出器实际地址和端口

Prometheus/Alertmanager告警规则示例

yaml
  - alert: DelugeTorrentsInErrorState
    expr: deluge_torrent_state_count{state="error"} > 0
    for: 0m
    labels:
      severity: warning
    annotations:
      summary: Deluge有{{ $value }}个种子处于错误状态
      description: Deluge种子错误状态告警\n 数值 = {{ $value }}\n 标签 = {{ $labels }}

Grafana仪表板

参考Grafana仪表板可在https://raw.githubusercontent.com/ngosang/deluge-exporter/main/grafana/grafana_dashboard.json%E8%8E%B7%E5%8F%96%E3%80%82

!https://raw.githubusercontent.com/ngosang/deluge-exporter/main/grafana/grafana_dashboard.png

!https://raw.githubusercontent.com/ngosang/deluge-exporter/main/grafana/grafana_dashboard_2.png