print-blockage-stopper

概述

Automated maintenance prints for any network printer (especially pigment printers like Canon imagePROGRAF, Epson SureColor, HP DesignJet, etc.). Sends a small test image on a configurable schedule (default: every 3 days) to keep all ink channels flowing and prevent costly pigment clogs and cleaning cycles. Features: multi-printer support, network printer discovery, per-printer schedules, smart skip (won't print if the printer was recently used), preset test images for 4/6/8/11/12-colour printers, custom image upload, notifications (webhook, email, Home Assistant), and a modern React dashboard with dark mode.

要求

Any network printer with IPP Everywhere support (usually any modern networked printer). Especially useful for pigment printers.

运行时参数

网络用户界面: http://[IP]:[PORT:8631]
网络: bridge
特权: false
额外参数: --cap-drop=ALL --cap-add=DAC_OVERRIDE --cap-add=CHOWN --cap-add=FOWNER --cap-add=SETUID --cap-add=SETGID --security-opt=no-new-privileges

模板配置

DashboardPorttcp

Web dashboard for managing printers, schedules, and test images.

目标: 8631
默认值: 8631
价值: 8631

CUPS Web UIPorttcp

CUPS print server interface for advanced monitoring.

目标: 631
默认值: 631
价值: 631

Printer IP AddressVariable

(Optional) IP address of a printer to auto-add on first boot. You can also add printers from the dashboard after starting the container.

目标: PRINTER_IP

Default Print ScheduleVariable

Default cron expression for new printers. Can be customised per-printer in the dashboard. Default: every 3 days at 10 AM.

目标: SCHEDULE
默认值: 0 10 */3 * *
价值: 0 10 */3 * *

Default Paper SizeVariable

Default paper size for new printers (e.g., A4, Letter, A3). Can be changed per-printer.

目标: PAPER_SIZE
默认值: A4
价值: A4

Default Skip HoursVariable

Default hours to skip maintenance print if printer was recently used. Adjustable per-printer in the dashboard.

目标: SKIP_HOURS
默认值: 72
价值: 72

Connection TypeVariable

Default connection type for new printers: 'ipp' (recommended) or 'socket' (port 9100).

目标: CONNECTION
默认值: ipp
价值: ipp

Webhook URLVariable

(Optional) URL for print success/failure notifications. Works with Slack incoming webhooks, Discord webhooks, ntfy.sh, or any endpoint accepting JSON POST.

目标: WEBHOOK_URL

Printer PortVariable

Default port for socket connections (only used when Connection Type is 'socket').

目标: PRINTER_PORT
默认值: 9100
价值: 9100

Data / LogsPath

Persistent storage for printer config, logs, uploads, and CUPS state.

目标: /data
默认值: /mnt/user/appdata/print-blockage-stopper
价值: /mnt/user/appdata/print-blockage-stopper

Unraid NotificationsPath

Mount Unraid's notification script to get alerts on print failures. Leave default for standard Unraid installs.

目标: /unraid/notify
默认值: /usr/local/emhttp/webGui/scripts/notify
价值: /usr/local/emhttp/webGui/scripts/notify

类别

Productivity Tools > Utilities

下载统计数据

991

下载总数

链接

模板支持 Docker Hub Pro连接

详细信息

存储库

abadrdh/print-blockage-stopper

登记处

https://hub.docker.com/r/abadrdh/print-blockage-stopper

最后更新2026-04-05

初见2026-03-29

在Unraid 上运行 print-blockage-stopper 。

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

探索Unraid OS