bambulab-metrics-exporter

bambulab-metrics-exporter

Application Docker from BlackBush's Repository

Vue d'ensemble

Prometheus exporter for Bambu Lab printers on Unraid. Exposes /metrics, /health, and /ready. Quick setup: 1) Set required values: BAMBULAB_TRANSPORT, BAMBULAB_SERIAL, BAMBULAB_SECRET_KEY (example: openssl rand -base64 48). 2) cloud_mqtt: set BAMBULAB_CLOUD_EMAIL (code/token fields can be left empty for first run and may auto-populate). 3) local_mqtt: set BAMBULAB_HOST and BAMBULAB_ACCESS_CODE. Then start the container and open WebUI for status. Scrape /metrics from Prometheus.

Arguments d'exécution

Interface utilisateur Web
http://[IP]:[PORT:9109]/
Réseau
bridge
Coquille
sh
Privilégié
false

Configuration du modèle

Web UI PortPorttcp

Exporter HTTP port

Cible
9109
Défaut
9109
Valeur
9109
Config DirPathrw

Persistent config and encrypted credentials

Cible
/config/bambulab-metrics-exporter
Défaut
/mnt/user/appdata/bambulab-metrics-exporter
Valeur
/mnt/user/appdata/bambulab-metrics-exporter
Listen HostVariable

HTTP bind host

Cible
LISTEN_HOST
Défaut
0.0.0.0
Valeur
0.0.0.0
Listen PortVariable

HTTP bind port

Cible
LISTEN_PORT
Défaut
9109
Valeur
9109
TransportVariable

Select transport mode

Cible
BAMBULAB_TRANSPORT
Défaut
cloud_mqtt|local_mqtt
Valeur
cloud_mqtt
Printer SerialVariable

Printer device serial (required)

Cible
BAMBULAB_SERIAL
Secret KeyVariable

Strong key for encrypted credentials. Generate example: openssl rand -base64 48

Cible
BAMBULAB_SECRET_KEY
Cloud EmailVariable

Used only when Transport=cloud_mqtt. Recommended/required for automatic cloud auth flow.

Cible
BAMBULAB_CLOUD_EMAIL
Cloud One-Time CodeVariable

Used only when Transport=cloud_mqtt. Optional verification code from email; if empty, startup can trigger code flow and ask for restart.

Cible
BAMBULAB_CLOUD_CODE
Cloud User IDVariable

Used only when Transport=cloud_mqtt. Usually auto-filled by startup auth process; can stay empty on first run.

Cible
BAMBULAB_CLOUD_USER_ID
Cloud Access TokenVariable

Used only when Transport=cloud_mqtt. Usually auto-filled by startup auth process; leave empty unless setting manually.

Cible
BAMBULAB_CLOUD_ACCESS_TOKEN
Cloud Refresh TokenVariable

Used only when Transport=cloud_mqtt. Auto-filled when available by startup auth process; optional for manual setup.

Cible
BAMBULAB_CLOUD_REFRESH_TOKEN
Cloud MQTT HostVariable

Cloud MQTT host

Cible
BAMBULAB_CLOUD_MQTT_HOST
Défaut
us.mqtt.bambulab.com
Valeur
us.mqtt.bambulab.com
Cloud MQTT PortVariable

Cloud MQTT port

Cible
BAMBULAB_CLOUD_MQTT_PORT
Défaut
8883
Valeur
8883
Local Host/IPVariable

Used only when Transport=local_mqtt. Required printer IP/hostname.

Cible
BAMBULAB_HOST
Local Access CodeVariable

Used only when Transport=local_mqtt. Required LAN access code from printer settings.

Cible
BAMBULAB_ACCESS_CODE
Local MQTT PortVariable

Used only when Transport=local_mqtt. Usually keep default 8883.

Cible
BAMBULAB_PORT
Défaut
8883
Valeur
8883
Local MQTT UsernameVariable

Used only when Transport=local_mqtt. Usually keep default bblp.

Cible
BAMBULAB_USERNAME
Défaut
bblp
Valeur
bblp
PUIDVariable

User ID to run container as (Unraid: usually 99)

Défaut
99
Valeur
99
PGIDVariable

Group ID to run container as (Unraid: usually 100)

Défaut
100
Valeur
100
UMASKVariable

File creation mask

Défaut
002
Valeur
002
Config Dir EnvVariable

Internal config path

Cible
BAMBULAB_CONFIG_DIR
Défaut
/config/bambulab-metrics-exporter
Valeur
/config/bambulab-metrics-exporter
Credentials FileVariable

Encrypted credentials filename

Cible
BAMBULAB_CREDENTIALS_FILE
Défaut
credentials.enc.json
Valeur
credentials.enc.json
Polling IntervalVariable

Polling interval in seconds

Cible
POLLING_INTERVAL_SECONDS
Défaut
10
Valeur
10
Request TimeoutVariable

Request timeout in seconds

Cible
REQUEST_TIMEOUT_SECONDS
Défaut
8
Valeur
8
Log LevelVariable

DEBUG/INFO/WARNING/ERROR

Cible
LOG_LEVEL
Défaut
INFO
Valeur
INFO
Printer Name LabelVariable

Prometheus label value; leave empty to auto-fill from printer serial

Cible
PRINTER_NAME

Détails

Référentiel
ghcr.io/theblackbush/bambulab_metrics_exporter:latest
Dernière mise à jour2026-05-31
Première vue2026-03-30

Exécutez bambulab-metrics-exporter sur Unraid.

bambulab-metrics-exporter est listé dans Community Apps pour Unraid OS. Explorez Unraid pour créer un serveur domestique flexible, un NAS ou un laboratoire domestique.