rudransh404/hplip-printer-app

hplip-printer-app

hplip-printer-app Docker镜像为HP和Apollo打印机提供基于HP HPLIP驱动套件的容器化解决方案，通过PAPPL与cups-filters 2.x桥接经典CUPS驱动与现代容器环境，支持USB/网络打印机管理。

核心功能

• HPLIP驱动集成：使用hpcups驱动及HPLIP PPD文件实现高质量打印（含照片打印）。
• 设备发现：通过hp CUPS后端发现USB打印机，通过hp-probe工具发现网络打印机。
• 多协议支持：兼容IPP、IPPS、LPD、socket协议，支持IEEE-1284.4同步打印/扫描（需设备支持）。
• IPP属性映射：自动将标准IPP属性转换为打印机特定选项，保障客户端兼容性。
• 插件支持：通过Web界面下载激光打印机专有HPLIP插件。
• 数据处理：用Ghostscript将PDF/PostScript转换为非PostScript打印机的raster数据。
• 可靠源码：采用Debian修补的HPLIP源码提升稳定性。

使用场景

• 企业/个人在容器化环境中管理HP/Apollo打印机。
• 云原生架构下保留legacy打印机支持。
• 简化打印机部署与配置流程。

配置说明

拉取镜像

sh
sudo docker pull rudransh404/hplip-printer-app

运行容器

1. 创建持久化卷：

sh
sudo docker volume create hplip-printer-app

2. 启动容器：

sh
sudo docker run -d \
    --name hplip-printer-app \
    --network host \
    -e PORT=<port> \
    -v hplip-printer-app:/var/lib/hplip-printer-app \
    -v /dev/bus/usb:/dev/bus/usb:ro \
    --device-cgroup-rule='c 189:* rmw' \
    rudransh404/hplip-printer-app:latest

参数说明

• PORT（可选）：应用端口，默认8000（占用则递增）。
• --network host：必需，用于网络打印机发现。
• -v /dev/bus/usb:/dev/bus/usb:ro：授予USB设备只读访问权限。
• --device-cgroup-rule：确保USB设备访问权限。

本地构建

1. 克隆仓库：

sh
git clone https://github.com/rudra-iitm/hplip-printer-app -b rudransh404
cd hplip-printer-app

2. 安装Rockcraft：

sh
sudo snap install rockcraft --classic

3. 构建并转换镜像：

sh
rockcraft pack -v
sudo rockcraft.skopeo --insecure-policy copy oci-archive:<rock_image> docker-daemon:hplip-printer-app:latest

Web界面

访问http://localhost:<port>/，可完成打印机添加、驱动配置、介质设置等操作。

包含组件

pappl v1.4.8、ghostscript v10.05.0、cups v2.4.11、cups-filters v2.0.1、libcupsfilters 2.1.1、libppd 2.1.0、pyppd 1.1.0、hplip 3.22.10。

工作原理

• 通过hp后端实现USB打印机高级通信。
• 自动映射IPP属性到PPD选项（如颜色/质量）。
• 支持PostScript与raster打印机，配置持久化于Docker卷。
• 结合HP探测与CUPS后端完成设备发现。
• 提供手动添加网络打印机功能及USB设备兼容性修复。