dersimn/brother_ql_web

brother_ql_web Docker镜像文档

镜像概述

本镜像基于brother_ql_web项目构建，提供Brother QL系列标签打印机的Web管理界面。其中，标签版本≤1.x基于https://github.com/pklaus/brother_ql_web%E9%A1%B9%E7%9B%AE%EF%BC%8C%E2%89%A52.x%E7%89%88%E6%9C%AC%E5%9F%BA%E4%BA%8Ehttps://github.com/Noloxs/brother_ql_web%E9%A1%B9%E7%9B%AE%E3%80%82%E9%95%9C%E5%83%8F%E6%9E%84%E5%BB%BA%E4%BB%93%E5%BA%93%E4%B8%BAhttps://github.com/dersimn/brother_ql_web%E3%80%82

核心功能与特性

• 提供直观的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版本

!https://raw.githubusercontent.com/dersimn/brother_ql_web/master/screenshots/Label-Designer_Desktop.png

v1版本

!https://github.com/dersimn/brother_ql_web/raw/v1/master/static/images/screenshots/Label-Designer_Desktop.png