如何在 Ubuntu 上安装 WKHTMLtoPDF（分步指南）

Source: Dev.to

什么是 WKHTMLtoPDF？

WKHTMLtoPDF 是一个命令行工具，用于将 HTML 页面转换为 PDF 文档。它在以下场景中被广泛使用：

• Laravel 应用
• PHP 项目
• Node.js 后端
• 服务器端 PDF 生成
• 自动化报告系统

你可以从 WKHTMLtoPDF 官方网站下载正式版。

为什么在 Ubuntu 上使用 WKHTMLtoPDF？

Ubuntu 服务器常用于网页托管和后端应用。 在 Ubuntu 上安装 WKHTMLtoPDF 可以让你：

• 自动生成发票
• 创建 PDF 格式的报告
• 将动态网页转换为可下载的 PDF
• 自动化文档工作流

安装步骤

步骤 1：更新 Ubuntu 系统

sudo apt update && sudo apt upgrade -y

这将确保所有依赖都是最新的。

步骤 2：安装必需的依赖

sudo apt install -y fontconfig libxrender1 libxext6 xfonts-base xfonts-75dpi

这些库保证了字体渲染和显示的正常工作。

步骤 3：下载 Ubuntu 版 WKHTMLtoPDF

建议安装官方的 .deb 包，而不是使用默认的 Ubuntu 软件源（可能已过期）。

wget https://github.com/wkhtmltopdf/packaging/releases/download/0.12.6-1/wkhtmltox_0.12.6-1.focal_amd64.deb
sudo dpkg -i wkhtmltox_0.12.6-1.focal_amd64.deb

如果遇到依赖错误，可使用以下命令修复：

sudo apt --fix-broken install

验证安装：

wkhtmltopdf --version

你应该能看到已安装的版本号。

步骤 4：测试 HTML 转 PDF

wkhtmltopdf https://example.com output.pdf

如果 PDF 成功生成，说明安装已完成。

常见安装错误及解决办法

• 找不到 WKHTMLtoPDF

  which wkhtmltopdf

  如果该命令没有返回路径，请重新安装该软件包。

• 缺少共享库

  sudo apt install -f

  这会自动安装所有缺失的依赖。

• 字体渲染不正常

  sudo apt install ttf-mscorefonts-installer

生产服务器的最佳实践

• 始终使用官方稳定版。
• 相比 Snap 安装，优先使用 .deb 包以获得更好的稳定性。
• 保持必需依赖的最新状态。
• 对于 Laravel 项目，考虑使用 barryvdh/laravel-snappy 来轻松从 Blade 模板生成 PDF。

最后感想

只要按照正确的步骤并安装相应的依赖，在 Ubuntu 上安装 WKHTMLtoPDF 是非常简便的。无论是构建自动化报告、发票，还是动态 PDF 系统，WKHTMLtoPDF 都是服务器端 HTML‑to‑PDF 转换的可靠解决方案。