Appearance
部署文档打印工具
文档打印工具
提供更好的打印效果,可以实现与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访问请查看)
