OnePrinter 打印软件

OnePrinter是北京网为科技有限公司（简称：网为®）推出的一款企业级免费共享打印软件，致力于为企业提供高效、稳定的打印机共享、管理与调用解决方案。

OnePrinter不挑打印机、不挑网络环境、不挑操作系统、不挑终端设备、不用下载APP。

• 支持打印机不限。
• 支持断网、内网独立运行。
• 支持外网（互联网或云端）打印。
• 支持电脑端客户端发起预览打印。
• 支持Web、软件通过POST请求（本地、内网、外网），传参唤起系统打印机进行批量打印。
• 支持端口号自定义。
• 支持Word、Excel、PowerPoint、PDF、图片、Base64等文件类型。
• 支持隔空打印，可限定分享的打印机、文件类型、限次、限时、份数、横版、双面、页码、彩色、纸张、验证口令、审核等，其他手机/电脑可扫码、打开链接或小程序上传打印。
• 支持自助打印，可为打印店、自助打印机快速实现智慧打印。
• 支持可视化打印模板设计（二维码、条形码、图片、方形、图片、文字等）、批量打印。
• 支持本机打印。
• 支持局域网设备管理，包括扫描、详情、备注、禁用/激活指定设备。
• 支持打印日志管理，包括详情、暂停、删除、清空、审核、拒绝等操作。
• 支持隔空打印的打印审核，开启后打印请求需审核后才发起打印。
• 支持Windows、MacOS、Linux等操作系统。

• 多网络环境下的打印机共享（不在一个网络下的打印机共享，适用于办公、家庭、打印店等）。
• 密保单位的内网打印。
• 打印店、单位等对打印机的集中管理。
• 自助打印机器（接口打印有本地/内网/外网接口，可快速对接全网打印请求）。
• 批量打印票据、订单、发票、胸卡、标签、图片、二维码、条形码、文档等。
• 其他

https://www.oneprinter.cn

https://docs.wangwei.ltd/guide/oneprinter/

请与OnePrinter服务端 1.1.36及以上版本配合使用。第1次运行请使用【以管理员身份】打开软件并安装好虚拟打印机。

相关数据的可视化显示。

::: window title="OnePrinter 系统首页" :::

::: window title="OnePrinter 英文版" :::

设置分享名称、指定分享打印机、选择网络范围、选择是否开启并设置口令、可限次、限时、选择是否开启份数、横版、双面、页码、彩色、纸张供用户选择，然后确定即可创建用于分享的二维码和链接。 此二维码和链接永久有效，可张贴或转发给需要打印的用户。 此二维码有2种形式，局域网的为H5页面、互联网的为微信小程序页面，都可在电脑或手机上打开。 用户在此界面上可发起打印任务。

::: window title="OnePrinter 隔空打印" :::

::: window title="OnePrinter 隔空打印 - 用户端" :::

0元开店、超低费率。打印店只需设置好店铺名称、店铺地址、客服电话和店招广告，并开启文档、照片打印，设置相应的纸张类型及相应价格，即可快速实现自助打印功能。客户扫描店铺二维码，可制作、预览和发送打印文件，系统会自动计算订单金额。客户支付成功后会生成一个6位取件码，凭取件码可扫码取件。

::: window title="OnePrinter 自助打印 - 店铺概况" :::

::: window title="OnePrinter 自助打印 - 店铺设置" :::

::: window title="OnePrinter 自助打印 - 订单明细" :::

::: window title="OnePrinter 自助打印 - 提现记录" :::

可拖拽设计打印模板，进行批量打印。内含文本、圆形、方形、直线、二维码、条形码等元素，支持FDF和图片导出，支持接口打印。适用于如卡证、面单、小票、合格证等场景。

::: window title="OnePrinter 模板打印" :::

web或其他软件将数据通过POST请求发送给本机或局域网URL，即可发起静默批量打印。可指定打印机，不限打印机及任务。

::: window title="OnePrinter 接口打印" :::

请先安装OnePrinter服务端，然后打开本演示地址进行测试。

演示地址：https://demo.oneprinter.cn/

// 获取打印机列表（含打印机对应的纸张列表）。
import {Post} from "@/util/http";
// 可使用本机、内网、外网接口。本机、内网端口可在服务端的【系统设置】-【高级设置】修改。
let apiUrl = "http://127.0.0.1:10081/getPrinter"
// let apiUrl = "http://192.168.31.104:10081/getPrinter"
// let apiUrl = "http://api.oneprinter.cn/api/getPrinter"
export async function getPrinter() {
    let obj = {
        secret_key:"", // 外网接口请传入secret_key，在【我的账户】获取。
    };
    const res = await Post(apiUrl, obj);
    if (res.data.code === 1) {
        console.log("结果",res.data.data)
        // 执行成功。
    }else{
        // 执行失败。
    }
}

// 发起打印（支持网络文件、Base64和模板打印）。
import {Post} from "@/util/http";
// 可使用本机、内网、外网接口。本机、内网端口可在服务端的【系统设置】-【高级设置】修改。
let apiUrl = "http://127.0.0.1:10081/print"
// let apiUrl = "http://192.168.31.104:10081/print"
// let apiUrl = "http://api.oneprinter.cn/api/print"
export async function toPrint() {
    let obj = {
        secret_key:"", // 外网接口请传入secret_key，请在【我的账户】获取。
        printer:"", // 打印机名称。
        paper_size:"", // 纸张名称。
        copies:1, // 打印份数。
        url: "", // 打印文件的地址，如 https://static.wangwei.ltd/image/oneprinter_log.png，url或base64，二选一。
        base64: "", // 打印文件的base64代码,url或base64，二选一。
        // 以下内容，请在【模板打印】中设计模板，然后【下载字段】。
        template:{
            code:"", 
            data:[], 
        }
    };
    const res = await Post(apiUrl, obj);
    if (res.data.code === 1) {
        console.log("结果",res.data.data)
        // 执行成功。
    }else{
        // 执行失败。
    }
}

选择打印机、横版、份数、双面、纸张、彩色，然后将文件拖入其中即可发起打印任务。

::: window title="OnePrinter 本机打印" :::

对所有打印行为进行相应管理。

注意：磁盘空间会不断占用，点击【一键清空】即可清空所有记录。也可以在【系统设置】-【高级设置】中对文件存储路径进行修改。

::: window title="OnePrinter 打印日志" :::

设备管理可以管理局域网内所有发起打印的终端设备，并可禁止/激活相应设备。

::: window title="OnePrinter 设备管理" :::

可以设置临时文件存储地址、端口号、语言、护眼模式、字号、配色等。

::: window title="OnePrinter 系统设置" :::

OnePrinterClient是北京网为科技有限公司（简称:网为®）专为电脑发起打印开发的客户端软件。使用虚拟打印机发起打印任务，无论内外网均可发起打印。最终打印体验、效果与传统发起打印一致。

OnePrinterClient负责在客户端电脑发起打印请求，OnePrinter负责打印任务的接收、分发和执行，二者相互协作完成打印。

::: note 前提1 必须安装OnePrinter作为服务端（可以在其他电脑上）作为服务端，并创建1个隔空共享。 :::

在OnePrinter服务端创建至少一个隔空共享。下载接口文件.json，该文件包含客户端配置信息。

::: window title="OnePrinter 下载接口文件" :::

在电脑上安装OnePrinterClient客户端（同一台机器也可以）。之后，第1次运行请使用【以管理员身份】打开软件，再安装OnePrinterClient打印机。

::: window title="OnePrinterClient 打印机安装" :::

在客户端的【系统配置】中，【导入配置】该.json文件或使用【账号同步】同步功能。

::: window title="OnePrinterClient 系统配置" :::

::: window title="OnePrinterClient 系统配置" :::

安装完成后，该电脑上即会出现OnePrinterClient虚拟打印机，在Word、PPT、Excel、PDF、图片等文档中执行打印时，选择OnePrinterClient即可发起打印，打印请求发送成功后会显示“发送成功”弹窗，即表示发送成功。

::: window title="OnePrinterClient 预览打印" :::

::: window title="OnePrinterClient 预览打印" :::

::: window title="OnePrinterClient 预览打印" :::

::: window title="OnePrinterClient 选择云端打印机" :::

如需结束进程，请使用Ctrl+Alt+Del调出任务管理器，找到OnePrinterClient结束进程即可。

如需卸载软件，请在当前文件夹的地址框中输入CMD回车，打开命令窗口输入：

OnePrinterClient.exe -uninstall

咨询、加群、购买授权，可加微信二维码，备注：OnePrinter。

部分Windows10、Windows11电脑可能需要安装WebWiew2组件，请在微软官网下载，并用管理员权限自行安装。下载地址：

https://developer.microsoft.com/zh-cn/microsoft-edge/webview2/?form=MA13LH

部分国产打印机的自定义纸张可能不存在，可以在windows的【打印机和扫描仪】-【打印服务器属性】- 添加相应的纸张规格。

第1运行，请使用右键的【以管理员身份运行】打开软件，比如虚拟打印机、目录权限可能需要授权。

得力dl720系列标签打印机默认设置可能存在毛边或锯齿问题，请在首选项->图形->混色调整为无

新增：

• 服务端自助打印店铺设置的省地市、地图选点；

优化：

• 服务端自助打印扫码核销、查询、批量导出，店铺概况等，去掉取件码改为订单号；

• 内网用户端打印界面；

修复：

• 服务端模板打印文本输入时导致误删元素问题；

• 服务端图片打印自动旋转问题；

• 小程序端部分型号手机的取件码显示问题；

新增：

• 自助打印模块，打印店可0元开店，快速部署无线打印方案；

新增：

• 隔空打印发打印时的内网预览；

新增：

• 模板打印设计器的“页码”元素，在设计多纸张模板时，可以加入页码元素，自动生成对应的页码；

优化：

• 模板打印设计器的对齐选中判断，仅当选择一个元素时，对齐方式将以纸张为基准对齐；

• 模板打印设计器的手型工具改成选中判断，在纸张中是光标可选择，在画布中是手型可拖拽；

• 模板打印设计器的头部“添加页”按钮，并对头部进行了简化；

修复：

• 模板打印设计器的批量打印的纸张选择、份数等问题；

• 接口打印旋转的问题；

优化：

• 模板打印设计器纸张网格线调为5mm、条形码（支持CODE128、UPC-A、UPC-E、EAN-13、CODE39、MSI、Pharmacode等条形码格式）；

修复：

• 接口打印使用打印模板时，纸张和份数失效问题；

新增：

• 服务端接口打印获取打印机时，可获取所有打印机及该打印机所支持的纸张列表（含名称、宽度、高度），发起打印时请指定纸张名称；

• 服务端报错提醒；

修复：

• 服务端模板设计器纵向文字断行问题；

• 服务端解绑后机器与账号关联失效的问题；

新增：

• 服务端模板设计：文字的方向、样式、字体（增加了思源黑体、思源宋体、得意体、阿里巴巴普惠体、阿里妈妈数黑体、阿里妈妈方圆体、阿里妈妈刀隶体、阿里妈妈东方大楷、钉钉进步体、淘宝买菜体，以及系统自带的其础字体）；

修复：

• 服务端模板设计，文字过多时的错位问题、打印预览是放大到2倍后预览错位问题、元素拖拽导致画布边界问题；

新增：

• 服务端系统首页模板打印统计；

• 服务端模板设计元素对齐功能、元素组功等；

优化：

• 服务端模板打印的部分细节；

新增：

• 服务端模板打印：图片上传功能，通用纸张类型，打印数据界面的模板编辑跳转；

优化：

• 服务端模板打印：打印方向固定（不再旋转90度），打印白边问题；

新增：

• 服务端模板打印【导入模板】、【导出模板】功能；

• 服务端接口打印【份数】传参；

优化：

• 服务端隔空打印列表、模板打印列表；

新增：

• 模板打印模块，支持拖拽设计、多张纸、批量excel数据导入、批量打印、接口打印、导出pdf、导出图片、导出字段等；

新增：

• 客户端账号同步功能，可一键同步所有隔空打印接口；

• 客户端默认设计功能；

优化：

• 服务端为适配客户端OnePrinterClient1.1.7版，调整隔空打印接口文件下载格式;

• 客户端系统配置功能；

优化：

• 隔空打印根据打印机限定纸张；

新增：

• 输入激活码授权功能，方便断网环境中激活；

修复：

• 16位色深导致的部分图片转化失败问题；

新增：

• 打印份数统计；

优化：

• “设备管理”变更为“网络设备”

• 图片打印自适应（部分打印机没有无边框模式时也可以无边框）；

修复：

• 隔空打印、设备管理的详情页返回列表时，不在当前页码的问题；

修复：

• 客户端预览打印时的审核功能；

新增：

• 服务端内部升级功能；
• 客户端一键导入配置功能；

优化：

• 客户端预览发起打印时，默认为彩色；

修复：

• 双击系统托盘图标恢复；
• 隔空打印内网的选择系统文件，苹果/安卓均支持；
• 隔空打印外网的微信图片选择器、选择系统文件（请根据提示重启小程序），苹果/安卓均支持；
• 邮箱账号功能，在国外的朋友请使用邮箱账号；

修复：

• MicroSoft Office文档引擎多进程转化时导致崩溃的问题；

新增：

• 隔空打印达到限定数量时提醒；
• 我的账户可充值、购买、激活、解绑、获取安全码（外网接口打印）等功能；
• 接口打印（外网）功能，使用接口可自行开发自助打印功能；
• 预览打印客户端的外网打印功能；

新增：

• 支持office和wps原生文档转化，转化效果更佳（重大更新）；

优化：

• 图片打印时的旋转；

优化：

• 小程序聊天窗口中文件发起打印时参数接收的问题；

优化：

• 客户端（预览）打印接口；

新增：

• 隔空打印dwg、cad格式支持；
• 隔空打印的二维码样式；
• 接口打印的外网接口；

优化：

• 界面最大化时不再盖住windows系统任务栏；
• 设备管理和隔空打印列表部分显示细节；
• 左侧菜单护眼模式下文字颜色细节；
• 日志细节；
• 隔空打印详情中的日志；
• 打印日志中的链接；

新增：

• 分享详情的日志功能，可以查看到每一个分享的打印日志；
• 网络设备的备注功能，可以为每一个网络设备添加备注，同时在日志中显示；
• 网络设备的详情功能，可以查看每一个网络设备的打印详情；

新增：

• 增加电脑打印客户端功能，支持内/外网接口、支持预览打印、支持虚拟打印机、支持在word、pdf、图片等软件中发起打印，真实还原传统打印模式；
• 增加电脑客户端的接口下载功能；

优化：

• 自动获取打印机时，不再获取虚拟打印机；
• 自动获取打印机对应的纸张；
• 接口测试切换打印机不再设置为默认打印机，改为post传参时传入打印机；
• 内网用户端的“局域网”改成“内网”统一识别；
• 内网路径优化，避免端口修改引发访问失败问题；

新增：

• 隔空共享的打印审核功能。一旦开启，需要在打印日志中进行审核，需审核后才能打印；
• 隔空共享的格式限定，一旦开启，需要适配的格式才能打印；
• 内外网用户端中英文切换；

修复：

• 打印日志中api名称、二维码显示问题；

新增：

• 启用口令直接呼出键盘；
• 增加接口编码（为后续打印客户端准备）；
• 非法打印请求拦截；

优化：

• 去除局域网与互联网的选择，改成自动创建（无外网时只创建内网）；

优化：

• 彩色打印指令（部分彩色打印机可能无效，如无效请扫码联系我们）；
• 隔空打印列表、详情、编辑样式；

修复：

• 本地打印纸张选择问题；

新增：

• 接口打印全面免费（支持网页域名发起打印）；
• 重复启动判断，避免重复启动失误；
• 微信聊天中点击文件打唤起打印；

优化：

• 局域网设备IP扫描逻辑；

修复：

• 隔空打印分享编辑无效/逻辑不严谨的问题；
• 修正首页打印趋势显示问题；

新增：

• 隔空共享与分享日志合并，重新组织了创建/编辑/详情/统计/列表功能；
• 打印通知声音的开关持久化；

优化：

• 隔空共享的名称统一限定为8字以内；
• 隔空共享的纸张状态改为选择；

修复：

• 首页数据图表不正确的问题；

修复：

• 紧急修复横板导致的图片打印失败问题；
• 首页数据统计起止时间问题；

新增：

• 系统首页打印机使用情况、打印类型饼图；
• 开机自动启动设置；

优化：

• 隔空打印创建时的打印机选择，用户端（本地）当只有一台打印机时自动设为默认打印机（无需选择）；

新增：

• 隔空打印的口令功能；
• 隔空打印的颜色功能；
• 隔空打印创建时的Loading状态；
• 接口打印测试功能；

优化：

• 隔空打印布局；
• 接口打印布局；

修复：

• 接口打印日期文件��创建问题；

优化：

• 打印日志、隔空打印、分享日志的字段保持一致；
• 局域网隔空打印功能；
• 接口打印描述；

新增：

• 统计数据图表；
• 打印分享名称

优化：

• 左侧菜单将更常用的放在前面；
• 更改了小程序二维码的调用方式，避免Base64导致数据库容量过大，重要！
• 调整了界面宽高；
• 修改文件命名规则
• 文件名称按日期存储

修复

• 小程序中指定纸张、指定页码和布局失效的问题；

新增：

• 布局设置；
• 打印机多选；
• 纸张多选；
• 互联网打印小程序，用户可以选择微信中的文件、系统文件和相册；

修复：

• 图片太宽时打印不出来的问题；

新增：

• 隔空打印用户端、本地打印增加拖拽文件打印；

修复：

• 打印日志部分参数记录不全问题；

新增：

• 隔空打印的打印份数、双面打印、纸张大小、指定页码等功能；
• 用户端增加【局域网/互联网】标识;

优化：

• 优化分享日志路径、显示、统计；
• 优化打印日志路径、显示、打印机；
• 调整系统设置；

新增：

• 打印日志增加实时显示能力；

优化：

• 文档打印改成LibreOffice；

新增：

• 互联网打印；
• 隔空打印限定；
• 打印提示音；

优化：

• 隔空打印逻辑

新增：

• 英文版；
• 网页打印、本机打印、隔空打印分别可以自定义打印机。
• 隔空打印功能配置及分享日志。

新增：

• 设备管理功能，可以禁用/开启某设备的打印服务；
• 存储目录切换功能；
• 版本检测功能；

新增：

• 打开磁盘；

优化：

• base64打印功能；
• 时区修正；
• 局域网打印优化；

新增：

• 本机打印、隔空打印、打印日志等功能；
• windows防火墙规则自动设置；

新增：

• 版本重构
• 端口切换能力

新增：

• 局域网打印能力

新增：

• 默认打印机设置能力

优化：

• 优化顶级域名授权、子域名授权功能。

优化：

• 临时文件存储和删除。

新增：

• 图形化界面，可缩小至系统托盘长驻内存。

• 域名绑��和注册授权功能。

• 支持Base64功能。