Linux中如何安裝和使用wkhtmltopdf

# 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

3. 安裝方法

3.1 使用包管理器安裝

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

3.2 手動安裝二進制文件

1. 下載預編譯二進制包：

wget https://github.com/wkhtmltopdf/wkhtmltopdf/releases/download/0.12.5/wkhtmltox-0.12.5-1.centos7.x86_64.rpm

1. 解壓并安裝：

sudo rpm -ivh wkhtmltox-0.12.5-1.centos7.x86_64.rpm

1. 創建符號鏈接：

sudo ln -s /usr/local/bin/wkhtmltopdf /usr/bin/wkhtmltopdf

3.3 從源碼編譯安裝

1. 安裝編譯依賴：

sudo apt install -y git cmake build-essential qt5-default libqt5webkit5-dev

1. 克隆源碼并編譯：

git clone https://github.com/wkhtmltopdf/wkhtmltopdf.git
cd wkhtmltopdf
git checkout 0.12.5
./scripts/build.py posix-local

1. 安裝到系統：

sudo cp bin/wkhtmltopdf /usr/local/bin/

4. 基本使用方法

簡單轉換：

wkhtmltopdf http://example.com example.pdf

本地HTML文件轉換：

wkhtmltopdf input.html output.pdf

多頁面合并：

wkhtmltopdf page1.html page2.html multi_page.pdf

設置頁面大?。?/strong>

wkhtmltopdf --page-size A4 input.html output.pdf

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

sudo apt install -y fonts-wqy-zenhei  # 安裝中文字體

export QT_XKB_CONFIG_ROOT=/usr/share/X11/xkb

wkhtmltopdf --ignore-ssl-errors http://example.com output.pdf

ulimit -v 1048576  # 限制內存使用為1GB