hiprint-transit-java

hiprint-transit-java 是一个基于 node-hiprint-transit 基底开发，用于在 electron-hiprint 客户端和 vue-plugin-hiprint 库之间充当中转服务，实现这些组件之间的无缝连接和打印操作。

免费服务-用爱发电

版本	服务器信息	服务商	地域	有效期	服务器地址	Token
0.0.5	2C2G4M 300G/m	Tencent Cloud	GZ	2026-07-16	https://v5.printjs.cn:17521	hiprint*

以上服务免费开放，0.0.3 版本未进行 token 隔离，仅推荐用于开发测试。

本项目免费开源，承诺不会窃取以上免费服务运行中产生的任何数据，但不能保证服务过程中不会受到黑客攻击而导致数据泄露问题。

如果你的服务追求更高的 稳定性、安全性、可靠性，建议自行独立部署，有自研能力的团队可以使用后端语言重新编写。

使用 JDK 启动项目

1. 命令执行

 nohup java -Dname=hiprint-transporter.jar  -Duser.timezone=Asia/Shanghai -Xms512m -Xmx1024m -XX:MetaspaceSize=128m -XX:MaxMetaspaceSize=512m -XX:+HeapDumpOnOutOfMemoryError -XX:+PrintGCDateStamps  -XX:+PrintGCDetails -XX:NewRatio=1 -XX:SurvivorRatio=30 -XX:+UseParallelGC -XX:+UseParallelOldGC -jar hiprint-transporter.jar --spring.config.location=config/application.yml 

配置

首次使用时，您需要需要修改配置文件

这将会引导你一步步完成初始化

./resources/application-prod.yml

hiprint:
  host: 0.0.0.0
  # 服务端端口
  port: 17521
  epoll: false
   # 服务端token
  auth-token: print_mes

如果你的配置有误或需要调整修改端口、token值，只需要重启即可。 （eg: 个人习惯都是把配置文件单独放在一个目录，方便修改）

events打印注意：

1. 从 hiwebSocket 中发送 news、render-print 、render-jpeg、render-pdf ，目前参数接收为Object参数（其他参数会报错），
2. hiwebSocket进行emit时对应提交事件名称( 参考文档docs)

eg:（新增render类型事件回调成功、失败数据显示）

// java对应的注册事件注解中引用对应的是emit仲提交事件名称
`@OnEvent("news")`, `@OnEvent("render-print")` , `@OnEvent("render-jpeg")`, `@OnEvent("render-pdf")`
// hiwebSocket之间提交事件
const socket = hiwebSocket.socket;
socket.emit("render-jpeg", {
 template: panel, // 模板对象
 data: printData, // Object打印数据
});

如果你不提供 client 中转服务将抛出一个 error

Window 系统启动项目

1. 下载打包文件

点击下载

2. 指定解压缩路径

3. 运行 start.bat 脚本

如果该项目对你有所帮助，请给我一个 star，谢谢！

周边生态项目

项目名称	项目地址	下载地址	描述
vue-plugin-hiprint	github、gitee	npm	打印设计器
electron-hiprint	github、gitee	releases	直接打印客户端
node-hiprint-transit	github、gitee	-	web 与客户端中转服务 Node 实现
uni-app-hiprint	github	-	uni-app 项目通过 webview 使用 vue-plugin-hiprint demo
node-hiprint-pdf	github	-	提供通过 node 对 vue-plugin-hiprint 模板生成 矢量 pdf、image、html