p910nd-panel把一台 USB 打印机变成网络打印机

记录  ·  2026-11-16

🖨️ p910nd-panel

USB打印机转为网络打印的单容器服务,内置 9100 RAW / JetDirect 打印服务 + 8910 Web 管理面板

适配内核裁剪系统(飞牛fnOS等),系统无 usblp / usbprinter 模块、不存在 /dev/usb/lp* 节点时也能正常使用 原理:pyusb 直接操作 USB 打印接口 class7,绕开内核原生打印驱动

✨ 功能清单

  • 📡 9100 RAW 打印:标准JetDirect协议,全平台客户端兼容
  • 🖥️ 8910 Web面板:设备状态、打印实时监控、运行日志、数据图表、快捷操作
  • 🔐 安全认证:首次访问设置密码,无用户名,PBKDF2-SHA256加盐哈希存储
  • 🔌 热配置:扫描USB设备,点选绑定,保存后自动重连打印机,无需重启容器
  • 🔔 消息推送:Pushplus多渠道通知,支持打印机离线、恢复上线、打印任务失败提醒
  • 📝 任务记录:留存来源IP、主机名、传输大小、耗时、任务结果,最多保存100条
  • 📊 数据统计:按日汇总打印成功/失败数量、流量,保存180天,支持7/14/30天图表查看

🚀 部署方式

方式一|源码构建

git clone https://github.com/meyzh/p910nd-panel.git
cd p910nd-panel
mkdir -p data
docker compose up -d --build
必备配置(缺少将无法识别USB打印机)
privileged: true
devices:
  - /dev/bus/usb:/dev/bus/usb

方式二|镜像直拉在线部署

mkdir -p p910nd-panel && cd p910nd-panel
cat > docker-compose.yml <<EOF
services:
  p910nd-panel:
    image: ghcr.io/meyzh/p910nd-panel:latest
    container_name: p910nd-panel
    restart: unless-stopped
    privileged: true
    devices:
      - /dev/bus/usb:/dev/bus/usb
    ports:
      - "9100:9100"
      - "8910:8910"
    volumes:
      - ./data:/app/data
    environment:
      - TZ=Asia/Shanghai
EOF
docker compose pull
docker compose up -d
💡 提示:ARM架构设备,请替换为对应架构镜像标签

📋 初始化步骤

  1. 🌐 浏览器访问 http://设备IP:8910,首次进入密码设置页面
  2. 🔍 进入【设备设置】→【扫描USB设备】,选择标记「打印接口」的USB设备并保存
  3. ✅ 状态变为在线,即可添加打印机开始打印

🧩 客户端接入教程

  • 🪟 Windows:添加TCP/IP打印机|填入服务端IP,协议 RAW,端口 9100,安装对应打印机驱动
  • 🍎 macOS:添加IP打印机|协议选择 HP JetDirect
  • 📱 手机:打印APP内填写IP、端口9100,协议RAW

⚠️ 重要提醒

  • 🚫 9100端口禁止暴露公网:该端口无鉴权,直接映射公网等于打印机裸奔;外网管理面板建议使用Tailscale内网穿透
  • 💾 必须挂载data目录:密码、推送配置、打印记录全部持久化在此,不挂载重建容器数据全部丢失

📜 许可说明

非商业许可:允许个人自由使用、二次开发;禁止商用,二次分发需保留原版权信息

📎 项目地址:https://github.com/meyzh/p910nd-panel
上一篇:科技类范文
下一篇:没有了
若有想法交流,欢迎来信:me@godr.cn
亦桉. All Rights Reserved.
Your IP: 122.246.22.154

赣ICP备19000739号-6