Skip to content

部署文档打印工具

文档打印工具提供更好的打印效果,可以实现与office办公软件几乎一致的打印效果。并且可以支持批量打印(注意:转换过程会耗费较多系统资源,对内存和CPU消耗较大)

提示

如果不安装文档打印工具,系统将采用默认打印方式,由于解析方式的差异,无法保证打印的效果

1.创建配置文件

创建文件

bash
# 创建文件
mkdir /etc/hzy
cd /etc/hzy
vim print.json

文件内容示例

特别说明

以下端口号18086请勿随意修改!否则配置https插件后无法进行反向代理!

json
{
  "HTTP_PORT": 18086,
  "INSTANCE_NUM": 2
}

参数说明

bash
HTTP_PORT        # 【必填】http协议端口号
INSTANCE_NUM     # 【可选】服务实例数量,默认为2(数量越大并发处理能力越强,资源消耗越大,建议不要设置超过16)

注意

若为云服务器,则还需要检查 防火墙安全组 是否开放了 18086 端口

2.运行文档打印工具

启动服务

特别说明

由于字体版权限制,仅内置以下免费商用字体

  • 方正黑体
  • 方正仿宋
  • 方正楷体

如果以上字体无法满足打印需求,可以使用自定义字体库,方法如下:

注意:请确保自定义字体库中的字体,已经获取了商用授权,未经授权使用商业字体可能有法律风险!

增加启动参数:-v [自定义字体路径]:/usr/share/fonts/own

提示:自定义字体路径是宿主机文件夹路径

完整配置示例:docker run --privileged -e TZ=Asia/Shanghai -itd -v /etc/hzy:/root/conf -v /usr/share/fonts/own:/usr/share/fonts/own --restart always --network host --name hzy-print registry.cn-hangzhou.aliyuncs.com/hzy0code/hzy-utils:print.x86.1.3.0

bash
# 注意:以下启动命令未包含「自定义字体库」,如需要包含查看上方「特别说明」
docker run --privileged -e TZ=Asia/Shanghai -itd -v /etc/hzy:/root/conf --restart always --network host --name hzy-print registry.cn-hangzhou.aliyuncs.com/hzy0code/hzy-utils:print.x86.1.3.0

重启服务

注意

修改了配置文件后,需要使用以下命令重启服务

bash
docker restart hzy-print

3.配置文档打印工具

打印插件地址配置到管理后台,即可启用插件打印(无需重启服务)

特别说明

当系统使用https访问方式,由于浏览器安全机制所以必须配置为:以https方式访问插件


配置方式一

使用https插件,插件已内置代理配置,启用插件即可


配置方式二

自建nginx反向代理,则增加以下配置

bash
#预览插件(这里必须写为 ^~ 并且放在最前面)
location ^~ /print {
	#将请求反向代理到目标服务器上
	proxy_pass http://127.0.0.1:18086;
}

配置示例

请将替换下方示例的IP端口IP也可以使用域名替换,如果是https访问请查看