会众云·零搭

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 registry.cn-hangzhou.aliyuncs.com/hzy0code/hzy-utils:print.x86.1.1.0

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

重启服务

注意

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

[CONTAINER ID]表示容器ID，使用docker ps命令可以查看容器ID

示例：

bash
docker restart [CONTAINER ID]

3.配置文档打印工具 ​

将打印插件地址配置到管理后台，即可启用插件打印

注意

请将替换下方示例的IP、端口（IP也可以使用域名替换）

特别说明

当系统已经使用了HTTPS插件，并配置了https访问方式，这里必须配置为域名访问！

浏览器安全机制：不允许https网站调用http链接

配置方式如下：

假设域名为https://test.123.com，则访问链接配置为https://test.123.com/print

HTTPS 插件支持自动代理 /print 的请求到 18086 端口