# Oneprinter
**Repository Path**: chenrongbin/oneprinter
## Basic Information
- **Project Name**: Oneprinter
- **Description**: OnePrinter是北京网为科技有限公司（简称:网为®）开发的打印控件，专注于解决打印机调用问题。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 3
- **Forks**: 1
- **Created**: 2025-12-21
- **Last Updated**: 2026-05-27
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
## 关于
`OnePrinter`是北京网为科技有限公司（简称:`网为®`）开发的打印控件，专注于解决打印机调用问题。
`OnePrinter`可以轻松实现打印机集中管理，并进行隔空共享打印、网页静默打印等功能，也可以实现共享打印全流程化管理，满足一般企业的打印机共享需求。
* 支持Web通过POST请求，传参唤起系统打印机进行批量打印。
* 支持端口号自定义。
* 支持Word、Excel、PowerPoint、PDF、图片、Base64等大部分办公打印需求。
* 支持局域网/互联网调用，可在其他设备传参打印或隔空打印。
* 支持隔空打印，可限定分享的打印机、局域网/互联网、次数、时间、份数、横版、双面、页码、彩色、纸张、设置验证口令等，其他手机/电脑可扫码、打开链接或小程序上传打印。
* 支持本机打印。
* 支持局域网设备管理，包括详情、扫描、禁用/激活指定设备。
* 支持分享日志管理，包括详情、暂停、删除、清空等操作
* 支持打印日志管理，包括详情、删除、清空等操作。
* 支持Windows、MacOS、Linux等操作系统。
## 应用场景
* 批量打印票据、订单、发票；
* 批量打印胸卡、标签；
* 批量打印图片；
* 批量打印二维码、条形码；
* 手机/电脑等隔空打印；
* 打印店、单位等，对打印机的集中管理；
* 多网络环境下的打印机统一共享；
* 不在一个办公网络下的打印机共享；
* 其他
*
## 官网地址
## 免费下载
| Windows | 下载地址 |
|-----|-----|
| 1.1.20 | |
| 1.1.19 | |
| 1.1.18 | |
## 使用说明
### 系统首页
相关数据的可视化显示。
::: window title="OnePrinter 系统首页"
:::
::: window title="OnePrinter 英文版"
:::
### 隔空打印
设置分享名称、指定分享打印机、选择网络范围、选择是否开启并设置口令、可限次、限时、选择是否开启份数、横版、双面、页码、彩色、纸张供用户选择，然后确定即可创建用于分享的二维码和链接。
此二维码和链接永久有效，可张贴或转发给需要打印的用户。
此二维码有2种形式，局域网的为H5页面、互联网的为微信小程序页面，都可在电脑或手机上打开。
用户在此界面上可发起打印任务。
::: window title="OnePrinter 隔空打印"
:::
::: window title="OnePrinter 隔空打印 - 用户端"
:::
### 本机打印
选择打印机、横版、份数、双面、纸张、彩色，然后将文件拖入其中即可发起打印任务。
::: window title="OnePrinter 本机打印"
:::
### 接口打印
web或其他软件将数据通过POST请求发送给本机或局域网URL，即可发起静默批量打印。可指定打印机，不限打印机及任务。
::: window title="OnePrinter 接口打印"
:::
### 打印日志
对所有打印行为进行相应管理。
注意：磁盘空间会不断占用，点击【一键清空】即可清空所有记录。也可以在【系统设置】-【高级设置】中对文件存储路径进行修改。
::: window title="OnePrinter 打印日志"
:::
### 设备管理
设备管理可以管理局域网内所有发起打印的终端设备，并可禁止/激活相应设备。
::: window title="OnePrinter 设备管理"
:::
### 系统设置
可以设置临时文件存储地址、端口号、语言、护眼模式、字号、配色等。
::: window title="OnePrinter 系统设置"
:::
## 请求示例
``` js
// onePrinter.js
import {Post} from "@/util/http";
export async function toPrint(url,base64) {
// url或base64，二选一。
let obj = {
printer:"", // 可指定打印机名称，优先使用该打印机
url: "", // 打印文件的地址，如 https://static.wangwei.ltd/image/oneprinter_log.png
base64: "", // 打印文件的base64代码
};
// 可在OnePrinter的【系统设置】-【高级设置】里修改端口。
const res = await Post("http://127.0.0.1:10081/print", obj); // 也可以使用局域网IP
if (res.data.code === 1) {
// 执行成功
}else{
// 执行失败
}
}
```
## 注册授权
::: note 免费授权
在社交媒体上发布1条含本软件截图及50字以上使用心得的分享贴可立减600元。
:::
| 功能 | 免费版 | 授权版 |专业版 | 定制版 |
|---------|------|------|------|------|
| 费用 | 免费 | 699元 |4999元 | 面议 |
| 面向对象 | 个人/家庭 | 技术/单位| 单位 | 单位 |
| 隔空打印 | ✅ 支持 | ✅ 支持| ✅ 支持 |✅ 支持 |
| 本机打印 | ✅ 支持 | ✅ 支持| ✅ 支持 |✅ 支持 |
| 接口打印 | ✅ 支持 | ✅ 支持| ✅ 支持 |✅ 支持 |
| 设备管理 | ✅ 支持 | ✅ 支持| ✅ 支持 |✅ 支持 |
| 打印日志 | ✅ 支持 | ✅ 支持| ✅ 支持 |✅ 支持 |
| 系统设置 | ✅ 支持 | ✅ 支持 | ✅ 支持|✅ 支持 |
| 每个分享可打印次数 | 50 | ✅ 不限| ✅ 不限 |✅ 不限 |
| 免广告 | ❌ 不支持 | ❌ 不支持| ✅ 支持 |✅ 支持 |
| 自有静态云存储功能和小程序 | ❌ 不支持 | ❌ 不支持| ❌ 不支持 |✅ 支持 |
咨询、加群、购买授权，可加微信二维码，备注：OnePrinter。
## 更新日志
#### 1.1.20（2026年05月23日）
新增：
* 启用口令直接呼出键盘；
* 增加接口编码（为后续打印客户端准备）；
* 非法打印请求拦截；
优化：
* 去除局域网与互联网的选择，改成自动创建（无外网时只创建内网）；
#### 1.1.19（2026年05月21日）
优化：
* 彩色打印指令（部分彩色打印机可能无效，如无效请扫码联系我们）；
* 隔空打印列表、详情、编辑样式；
修复：
* 本地打印纸张选择问题；
#### 1.1.18（2026年05月19日）
新增：
* 接口打印全面免费（支持网页域名发起打印）；
* 重复启动判断，避免重复启动失误；
* 微信聊天中点击文件打唤起打印；
优化：
* 局域网设备IP扫描逻辑；
修复：
* 隔空打印分享编辑无效/逻辑不严谨的问题；
* 修正首页打印趋势显示问题；
#### 1.1.17（2026年05月18日）
新增：
* 隔空共享与分享日志合并，重新组织了创建/编辑/详情/统计/列表功能；
* 打印通知声音的开关持久化；
优化：
* 隔空共享的名称统一限定为8字以内；
* 隔空共享的纸张状态改为选择；
修复：
* 首页数据图表不正确的问题；
#### 1.1.16（2026年05月16日）
修复：
* 紧急修复横板导致的图片打印失败问题；
* 首页数据统计起止时间问题；
#### 1.1.15（2026年05月16日）
新增：
* 系统首页打印机使用情况、打印类型饼图；
* 开机自动启动设置；
优化：
* 隔空打印创建时的打印机选择，用户端（本地）当只有一台打印机时自动设为默认打印机（无需选择）；
#### 1.1.14（2026年05月15日）
新增：
* 隔空打印的口令功能；
* 隔空打印的颜色功能；
* 隔空打印创建时的Loading状态；
* 接口打印测试功能；
优化：
* 隔空打印布局；
* 接口打印布局；
修复：
* 接口打印日期文件夹创建问题；
#### 1.1.13（2026年05月14日）
优化：
* 打印日志、隔空打印、分享日志的字段保持一致；
* 局域网隔空打印功能；
* 接口打印描述；
#### 1.1.12（2026年05月13日）
新增：
* 统计数据图表；
* 打印分享名称
优化：
* 左侧菜单将更常用的放在前面；
* 更改了小程序二维码的调用方式，避免Base64导致数据库容量过大，重要！
* 调整了界面宽高；
* 修改文件命名规则
* 文件名称按日期存储
修复
* 小程序中指定纸张、指定页码和布局失效的问题；
#### 1.1.11（2026年05月12日）
新增：
* 布局设置；
* 打印机多选；
* 纸张多选；
* 互联网打印小程序，用户可以选择微信中的文件、系统文件和相册；
修复：
* 图片太宽时打印不出来的问题；
#### 1.1.10（2026年05月10日）
新增：
* 隔空打印用户端、本地打印增加拖拽文件打印；
修复：
* 打印日志部分参数记录不全问题；
#### 1.1.9（2026年05月09日）
新增：
* 隔空打印的打印份数、双面打印、纸张大小、指定页码等功能；
* 用户端增加【局域网/互联网】标识;
#### 1.1.8（2026年05月08日）
优化：
* 优化分享日志路径、显示、统计；
* 优化打印日志路径、显示、打印机；
* 调整系统设置；
#### 1.1.7（2026年05月07日）
新增：
* 打印日志增加实时显示能力；
优化：
* 文档打印改成LibreOffice；
#### 1.1.6（2026年05月05日）
新增：
* 互联网打印；
* 隔空打印限定；
* 打印提示音；
优化：
* 隔空打印逻辑
#### 1.1.5（2026年04月28日）
新增：
* 英文版；
* 网页打印、本机打印、隔空打印分别可以自定义打印机。
* 隔空打印功能配置及分享日志。
#### 1.1.4（2026年04月27日）
新增：
* 设备管理功能，可以禁用/开启某设备的打印服务；
* 存储目录切换功能；
* 版本检测功能；
#### 1.1.3（2026年04月23日）
新增：
* 打开磁盘；
优化：
* base64打印功能；
* 时区修正；
* 局域网打印优化；
#### 1.1.2（2026年04月21日）
新增：
* 本机打印、隔空打印、打印日志等功能；
* windows防火墙规则自动设置；
#### 1.1.1（2026年04月20日）
新增：
* 版本重构
* 端口切换能力
#### 1.0.6（2026年03月23日）
新增：
* 局域网打印能力
#### 1.0.5（2026年03月19日）
新增：
* 默认打印机设置能力
#### 1.0.4（2025年12月22日）
优化：
* 优化顶级域名授权、子域名授权功能。
#### 1.0.3（2025年12月21日）
优化：
* 临时文件存储和删除。
#### 1.0.2（2025年12月19日）
新增：
* 图形化界面，可缩小至系统托盘长驻内存。
* 域名绑定和注册授权功能。
* 支持Base64功能。