wkhtmltopdf 安装部署教程

部署步骤

下载中间件（离线环境安装）

首先，我们需要根据现场服务器的系统发行版本及CPU架构类型，下载对应的中间件(目前使用版本为0.12.6)，对于一些所谓的国产系统，需要搞清楚是基于哪些上游发行版，具体链接如下：

• 官网：https://wkhtmltopdf.org/index.html
• 下载地址：https://wkhtmltopdf.org/downloads.html
  

安装

离线环境

将下载的中间件上传到服务器上，并在上传目录下执行安装命令即可，部分发行版安装命令如下：

• Centos：rpm -ivh [包名]
• Debian：dpkg -i [包名]

在线环境

debian系

执行如下命令安装中间件，可能会提示需要安装缺失的依赖，依据提示进行安装即可。

//更新软件列表
apt-get update
//安装中间件
apt-get install wkhtmltopdf

验证

注意，一般情况下，安装完成后，wkhtmltopdf与wkhtmltoimage这两个文件会放在/usr/local/bin路径下，我们需要查看一下环境变量,输入echo $PATH命令, 如下图，查看这个路径是否在环境变量中，若没有，可以把这俩文件复制到环境变量中已存在的路径，比如/usr/bin

输入wkhtmltopdf命令，若看到如下界面，即安装成功。

可能遇到的问题

内网环境安装时提示缺少依赖

• 项目一般部署在内网环境，所以当依赖缺失过多时，建议搭建完全离线的yum仓库，尝试使用yum安装缺失依赖。
• 依赖缺失较少时，可从此网站下载相关依赖：https://pkgs.org/

生成的PDF上中文字体无法显示

主要缺失wqy-zenhei、cjkuni-uming、wqy-microhei，将字体文件挪到/usr/share/fonts, 然后执行如下命令即可。

mkfontscale
mkfontdir
fc-cache
fc-list