您好，登录后才能下订单哦！
密码登录
登录注册
点击 登录注册 即表示同意《亿速云用户服务条款》
# Linux中如何安装和使用wkhtmltopdf
## 目录
1. [wkhtmltopdf简介](#wkhtmltopdf简介)
2. [安装前准备](#安装前准备)
3. [安装方法](#安装方法)
- [3.1 使用包管理器安装](#31-使用包管理器安装)
- [3.2 手动安装二进制文件](#32-手动安装二进制文件)
- [3.3 从源码编译安装](#33-从源码编译安装)
4. [基本使用方法](#基本使用方法)
5. [常用参数详解](#常用参数详解)
6. [高级应用场景](#高级应用场景)
7. [常见问题解决](#常见问题解决)
8. [性能优化建议](#性能优化建议)
9. [总结](#总结)
<a id="wkhtmltopdf简介"></a>
## 1. wkhtmltopdf简介
wkhtmltopdf是一个开源的命令行工具，使用WebKit渲染引擎将HTML文档转换为PDF格式。它支持大多数HTML5和CSS3特性，能够很好地处理现代网页内容。
主要特点：
- 基于WebKit引擎，渲染质量高
- 支持页眉页脚、目录(TOC)生成
- 提供丰富的命令行参数控制输出
- 跨平台支持(Linux/Windows/macOS)
典型应用场景：
- 网页快照存档
- 电子发票/报表生成
- 自动化文档处理
- 网页内容离线保存
<a id="安装前准备"></a>
## 2. 安装前准备
在安装wkhtmltopdf前，请确保系统满足以下要求：
**系统要求：**
- Linux内核版本2.6.23或更高
- X11或Xvfb（用于无头模式运行）
- 基础开发工具链（如需编译安装）
**依赖检查：**
```bash
# 检查系统架构
uname -m
# 检查已安装的依赖
ldd --version
gcc --version
建议先更新系统软件包：
sudo apt update && sudo apt upgrade -y # Debian/Ubuntu
sudo yum update -y # CentOS/RHEL
Debian/Ubuntu系统：
sudo apt install -y xfonts-75dpi xfonts-base
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
CentOS/RHEL系统：
sudo yum install -y xorg-x11-fonts-75dpi xorg-x11-fonts-Type1
wget https://github.com/wkhtmltopdf/packaging/releases/download/0.12.6-1/wkhtmltox-0.12.6-1.centos8.x86_64.rpm
sudo rpm -Uvh wkhtmltox-0.12.6-1.centos8.x86_64.rpm
验证安装：
wkhtmltopdf --version
wget https://github.com/wkhtmltopdf/wkhtmltopdf/releases/download/0.12.5/wkhtmltox-0.12.5-1.centos7.x86_64.rpm
sudo rpm -ivh wkhtmltox-0.12.5-1.centos7.x86_64.rpm
sudo ln -s /usr/local/bin/wkhtmltopdf /usr/bin/wkhtmltopdf
sudo apt install -y git cmake build-essential qt5-default libqt5webkit5-dev
git clone https://github.com/wkhtmltopdf/wkhtmltopdf.git
cd wkhtmltopdf
git checkout 0.12.5
./scripts/build.py posix-local
sudo cp bin/wkhtmltopdf /usr/local/bin/
简单转换：
wkhtmltopdf http://example.com example.pdf
本地HTML文件转换：
wkhtmltopdf input.html output.pdf
多页面合并：
wkhtmltopdf page1.html page2.html multi_page.pdf
设置页面大小：
wkhtmltopdf --page-size A4 input.html output.pdf
| 参数 | 说明 | 示例 |
|---|---|---|
--dpi |
设置DPI分辨率 | --dpi 300 |
--margin-top |
上边距(mm) | --margin-top 15 |
--header-html |
自定义页眉HTML | --header-html header.html |
--footer-center |
页脚居中文字 | --footer-center "[page]" |
--disable-smart-shrinking |
禁用智能缩放 | --disable-smart-shrinking |
--orientation |
页面方向 | --orientation Landscape |
--toc |
生成目录 | --toc |
--javascript-delay |
JS延迟(ms) | --javascript-delay 2000 |
完整参数列表：
wkhtmltopdf --extended-help
wkhtmltopdf --enable-javascript --no-stop-slow-scripts \
--javascript-delay 5000 http://example.com dynamic.pdf
#!/bin/bash
for url in $(cat urls.txt); do
filename=$(echo $url | md5sum | cut -d' ' -f1).pdf
wkhtmltopdf $url $filename
done
xvfb-run --server-args="-screen 0, 1024x768x24" \
wkhtmltopdf http://example.com output.pdf
wkhtmltopdf --user-style-sheet style.css input.html styled.pdf
问题1：字体显示异常
sudo apt install -y fonts-wqy-zenhei # 安装中文字体
问题2：段错误(Segmentation Fault)
export QT_XKB_CONFIG_ROOT=/usr/share/X11/xkb
问题3：SSL证书错误
wkhtmltopdf --ignore-ssl-errors http://example.com output.pdf
问题4：内存不足
ulimit -v 1048576 # 限制内存使用为1GB
wkhtmltopdf --disable-javascript --no-images input.html output.pdf
wkhtmltopdf --cache-dir /tmp/wkhtml_cache input.html output.pdf
wkhtmltopdf --load-error-handling ignore input.html output.pdf
wkhtmltopdf作为一款强大的HTML转PDF工具，在Linux环境下通过多种安装方式可以满足不同场景需求。掌握其丰富的参数配置和优化技巧，能够高效处理各类文档转换任务。对于企业级应用，建议结合Xvfb实现无头模式运行，并通过脚本实现批量化自动处理。
延伸学习： - wkhtmltopdf官方文档 - 高级配置示例 - PDF生成最佳实践 “`
注：本文档约3000字，包含了wkhtmltopdf在Linux系统中的完整安装使用指南。实际使用时可根据具体系统版本和需求调整命令参数。建议在测试环境验证后再投入生产使用。
免责声明：本站发布的内容（图片、视频和文字）以原创、转载和分享为主，文章观点不代表本网站立场，如果涉及侵权请联系站长邮箱：is@yisu.com进行举报，并提供相关证据，一经查实，将立刻删除涉嫌侵权内容。