PrintLab

PrintLab

Docker 应用程序 from techpunk's repo

概述

PrintLab is a standalone dashboard and API for Bambu printers with multi-printer monitoring, printer job tracking, MakerWorks handoff, StockWorks filament lookup, and optional timelapse upload support.

要求

Mapped /data and /config paths, printer credentials or PRINTERS_JSON, admin password hash, session secret, and Docker network makerworks-net.

运行时参数

网络用户界面
http://[IP]:[PORT:8080]/
网络
makerworks-net
外壳
bash
特权
false
额外参数
--restart unless-stopped

模板配置

Web UI PortPorttcp

Host port for the PrintLab web UI.

目标
8080
默认值
8983
价值
8983
Data PathPathrw

Persistent PrintLab data, cache, submitted jobs, and successful G-code records.

目标
/data
默认值
/mnt/user/appdata/printlab/data
价值
/mnt/user/appdata/printlab/data
Config PathPathrw

Optional PrintLab config.json and file-based secret directory.

目标
/config
默认值
/mnt/user/appdata/printlab/config
价值
/mnt/user/appdata/printlab/config
TimezoneVariable

Container timezone.

目标
TZ
默认值
Etc/UTC
价值
Etc/UTC
Log LevelVariable

Application log level.

目标
LOG_LEVEL
默认值
INFO
价值
INFO
PRINTERS_JSONVariable

Optional multi-printer JSON array. If set, overrides single PRINTER_* values.

Printer NameVariable

Friendly name for single-printer mode.

目标
PRINTER_NAME
Printer HostVariable

Single-printer LAN IP or hostname.

目标
PRINTER_HOST
Printer SerialVariable

Single-printer serial number.

目标
PRINTER_SERIAL
Printer Access CodeVariable

Single-printer LAN access code.

目标
PRINTER_ACCESS_CODE
Printer Device TypeVariable

Printer device type override.

目标
PRINTER_DEVICE_TYPE
默认值
unknown
价值
unknown
Local MQTTVariable

Use local MQTT mode.

目标
PRINTER_LOCAL_MQTT
默认值
true
价值
true
Enable CameraVariable

Enable camera retrieval.

目标
PRINTER_ENABLE_CAMERA
默认值
true
价值
true
Disable SSL VerifyVariable

Disable SSL verification for printer/cloud calls.

目标
PRINTER_DISABLE_SSL_VERIFY
默认值
false
价值
false
File Cache PathVariable

Internal cache path.

目标
FILE_CACHE_PATH
默认值
/data/cache
价值
/data/cache
Print Cache CountVariable

Cached print records count.

目标
PRINT_CACHE_COUNT
默认值
1
价值
1
Timelapse Cache CountVariable

Cached timelapse records count.

目标
TIMELAPSE_CACHE_COUNT
默认值
1
价值
1
Bambu RegionVariable

Optional Bambu cloud region.

目标
BAMBU_REGION
Bambu EmailVariable

Optional Bambu cloud email.

目标
BAMBU_EMAIL
Bambu UsernameVariable

Optional Bambu cloud username.

目标
BAMBU_USERNAME
Bambu Auth TokenVariable

Optional Bambu cloud auth token.

目标
BAMBU_AUTH_TOKEN
Require AuthVariable

Require login for UI and API access.

目标
REQUIRE_AUTH
默认值
true
价值
true
Admin UsernameVariable

Admin login username.

目标
ADMIN_USERNAME
默认值
admin
价值
admin
Admin EmailVariable

Optional admin login email.

目标
ADMIN_EMAIL
Admin Password HashVariable

Required hashed admin password. Generate with PrintLab scripts/hash_password.py.

目标
ADMIN_PASSWORD_HASH
Session SecretVariable

Required long random secret used to sign session cookies.

目标
SESSION_SECRET
Session Cookie SecureVariable

Set true when serving behind HTTPS.

目标
SESSION_COOKIE_SECURE
默认值
false
价值
false
MakerWorks Base URLVariable

MakerWorks API base URL on makerworks-net.

目标
MAKERWORKS_BASE_URL
默认值
http://MakerWorks-v2:3000
价值
http://MakerWorks-v2:3000
MakerWorks API KeyVariable

Optional MakerWorks API key.

目标
MAKERWORKS_API_KEY
MakerWorks Bearer TokenVariable

Optional MakerWorks bearer token.

目标
MAKERWORKS_BEARER_TOKEN
MakerWorks Auth HeaderVariable

Header used for MakerWorks API key.

目标
MAKERWORKS_AUTH_HEADER
默认值
X-API-Key
价值
X-API-Key
MakerWorks Webhook SecretVariable

Shared secret for callbacks sent to MakerWorks.

目标
MAKERWORKS_WEBHOOK_SECRET
MakerWorks Submit API KeyVariable

API key accepted for MakerWorks submit boundary routes.

目标
MAKERWORKS_SUBMIT_API_KEY
MakerWorks Allowed PathsVariable

Comma-separated allowlist for MakerWorks proxy paths.

目标
MAKERWORKS_ALLOWED_PATHS
默认值
/health,/api/models
价值
/health,/api/models
MakerWorks Job Callback EnabledVariable

Send job status callbacks to MakerWorks.

目标
MAKERWORKS_JOB_CALLBACK_ENABLED
默认值
false
价值
false
MakerWorks Job Callback Path TemplateVariable

Callback path, e.g. /api/printlab/jobs/{job_id}.

目标
MAKERWORKS_JOB_CALLBACK_PATH_TEMPLATE
StockWorks Base URLVariable

Optional StockWorks API base URL.

目标
STOCKWORKS_BASE_URL
默认值
http://StockWorks:8000
价值
http://StockWorks:8000
StockWorks API KeyVariable

Optional StockWorks API key.

目标
STOCKWORKS_API_KEY
YouTube Upload EnabledVariable

Enable automatic timelapse uploads to YouTube.

目标
YOUTUBE_UPLOAD_ENABLED
默认值
false
价值
false
YouTube Client IDVariable

OAuth client ID for YouTube uploads.

目标
YOUTUBE_CLIENT_ID
YouTube Client SecretVariable

OAuth client secret for YouTube uploads.

目标
YOUTUBE_CLIENT_SECRET
YouTube Refresh TokenVariable

OAuth refresh token for YouTube uploads.

目标
YOUTUBE_REFRESH_TOKEN

详细信息

存储库
ghcr.io/schartrand77/printlab:latest
最后更新2026-05-31
初见2026-05-04

在Unraid 上运行 PrintLab 。

PrintLab 已被列入Unraid OS 的社区应用程序。探索Unraid ,构建灵活的家庭服务器、NAS 或家庭实验室。