wkhtmltoimage 命令

常用示例

说明

wkhtmltoimage converts HTML pages to images using the WebKit rendering engine. It can process local HTML files or fetch remote URLs, producing PNG, JPEG, BMP, or SVG output. The tool runs headlessly without requiring a display server, making it suitable for server-side image generation. It supports JavaScript execution, custom stylesheets, cookies, and HTTP authentication. Part of the wkhtmltopdf suite, it shares the same rendering engine and many options with its PDF counterpart.

参数

--width _int_

Set screen width (used as guideline).

--height _int_

Set screen height.

-f, --format _format_

Output format: png, jpg, bmp, svg.

--quality _int_

Output quality 0-100 (default 94, for JPEG).

--crop-x _int_

X coordinate for cropping.

--crop-y _int_

Y coordinate for cropping.

--crop-w _int_

Width for cropping.

--crop-h _int_

Height for cropping.

-n, --disable-javascript

Disable JavaScript execution.

--javascript-delay _msec_

Wait milliseconds for JavaScript to finish.

--user-style-sheet _path_

Apply custom CSS stylesheet.

--cookie _name_ _value_

Set a cookie (repeatable).

--custom-header _name_ _value_

Set custom HTTP header (repeatable).

--zoom _float_

Zoom factor for rendering (e.g., 2.0 for 2x).

--disable-smart-width

Use strict width instead of guideline.

--encoding _encoding_

Set the default text encoding for input.

-p, --proxy _proxy_

Use a proxy.

--username _username_

HTTP authentication username.

--password _password_

HTTP authentication password.

--run-script _js_

Run additional JavaScript after the page finishes loading (repeatable).

--load-error-handling _handler_

How to handle pages that fail to load: abort, ignore, or skip (default: abort).

--allow _path_

Allow files from the specified folder to be loaded (repeatable).

--no-images

Do not load or print images.

--stop-slow-scripts

Stop slow-running JavaScript.