dersimn/brother_ql_web Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

brother_ql_web Docker镜像文档

镜像概述

本镜像基于brother_ql_web项目构建，提供Brother QL系列标签打印机的Web管理界面。其中，标签版本≤1.x基于pklaus/brother_ql_web项目，≥2.x版本基于Noloxs/brother_ql_web项目。镜像构建仓库为dersimn/brother_ql_web。

核心功能与特性

• 提供直观的Web界面，用于设计和打印标签
• 支持多种Brother QL打印机型号（如QL-700等）
• 支持不同尺寸的标签（如d24等）
• 兼容Raspberry Pi设备
• 支持持久化运行配置

使用场景

适用于需要通过Web界面管理Brother QL系列标签打印机的场景，如办公室标签打印、仓储物流标签管理、零售商品价签打印等。

使用方法

基本部署命令

bash
docker run -d --restart=always --name=brother_ql_web \
    --device=/dev/usb/lp0 \  # 挂载打印机设备
    -p 8013:8013 \            # 映射Web端口
    dersimn/brother_ql_web \
        --model QL-700 \      # 指定打印机型号
        --default-label-size d24 \  # 设置默认标签尺寸
        file:///dev/usb/lp0   # 指定打印机设备路径

参数说明

• --device=/dev/usb/lp0: 挂载打印机USB设备（需根据实际设备路径调整）
• -p 8013:8013: 将容器内8013端口映射到主机8013端口，用于访问Web界面
• --model: 指定打印机型号（如QL-700、QL-800等）
• --default-label-size: 设置默认标签尺寸（如d24、d62等）
• file:///dev/usb/lp0: 指定打印机设备路径

支持的标签

标签命名规则

• 基于SemVer语义化版本规范，如2、2.1、2.1.6会指向同一镜像（至少在特定时间点）
• 普通版本标签（如2.1.6）会在基础镜像（如python:3）更新时同步更新，因此SHA值会变化
• 若需固定镜像版本不接收更新，可使用带时间戳的标签，如2.1.6-build20230915T0815

界面截图

v2版本

!v2界面

v1版本

!v1界面