🖨️ 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架构设备,请替换为对应架构镜像标签
📋 初始化步骤
- 🌐 浏览器访问
http://设备IP:8910,首次进入密码设置页面 - 🔍 进入【设备设置】→【扫描USB设备】,选择标记「打印接口」的USB设备并保存
- ✅ 状态变为在线,即可添加打印机开始打印
🧩 客户端接入教程
- 🪟 Windows:添加TCP/IP打印机|填入服务端IP,协议
RAW,端口9100,安装对应打印机驱动 - 🍎 macOS:添加IP打印机|协议选择
HP JetDirect - 📱 手机:打印APP内填写IP、端口9100,协议RAW
⚠️ 重要提醒
- 🚫 9100端口禁止暴露公网:该端口无鉴权,直接映射公网等于打印机裸奔;外网管理面板建议使用Tailscale内网穿透
- 💾 必须挂载data目录:密码、推送配置、打印记录全部持久化在此,不挂载重建容器数据全部丢失
📜 许可说明
非商业许可:允许个人自由使用、二次开发;禁止商用,二次分发需保留原版权信息
📎 项目地址:https://github.com/meyzh/p910nd-panel