不想把 PDF 丢进在线工具站?Docker 部署 Stirling PDF,浏览器打开就能处理

不想把 PDF 丢进在线工具站？Docker 部署 Stirling PDF，浏览器打开就能处理

一、本文镜像是什么？ · 二、环境要求 · 三、拉取镜像 · 四、Docker Compose 部署（推荐）

文 / 轩辕镜像

14 PARTS

CONTENTS · 本章导览

14 PARTS

TEXT

浏览器 ──HTTP:8080──▶  stirlingpdf（:8080）

　　　　　　　　　　　　　　　　　　　　　　　　　├── 合并 / 压缩 / 水印 / 文本编辑 …

　　　　　　　　　　　　　　　　　　　　　　　　　├── OCR、LibreOffice 转换

　　　　　　　　　　　　　　　　　　　　　　　　　└── 配置与 H2 → /configs

BASH

docker --version

docker compose version

BASH

bash <(wget -qO- https://get.xuanyuan.cloud/docker.sh)

BASH

bash <(wget -qO- https://get.xuanyuan.me/docker.sh)

BASH

docker pull docker.xuanyuan.run/casjaysdevdocker/stirlingpdf:2608

TEXT

2608: Pulling from casjaysdevdocker/stirlingpdf

4f4fb700ef54: Pull complete

703b030c7813: Pull complete

…（中间层省略）

225d6ffcb9a3: Pull complete

Digest: sha256:e5bd44e70e4d1b0d4c94ab85a61999eb458e5c10da5d122a11d8b2b70e555438

Status: Downloaded newer image for docker.xuanyuan.run/casjaysdevdocker/stirlingpdf:2608

docker.xuanyuan.run/casjaysdevdocker/stirlingpdf:2608

BASH

docker images docker.xuanyuan.run/casjaysdevdocker/stirlingpdf:2608

TEXT

IMAGE                                                   ID             DISK USAGE   CONTENT SIZE   EXTRA

docker.xuanyuan.run/casjaysdevdocker/stirlingpdf:2608   e5bd44e70e4d       3.38GB         1.07GB

BASH

mkdir -p /www/wwwroot/stirlingpdf/{configs,logs,pipeline,tessdata,customFiles}

chown -R "$USER:$USER" /www/wwwroot/stirlingpdf

cd /www/wwwroot/stirlingpdf

BASH

cat > docker-compose.yml <<'EOF'

services:

　　stirlingpdf:

　　　　image: docker.xuanyuan.run/casjaysdevdocker/stirlingpdf:2608

　　　　container_name: stirlingpdf

　　　　restart: unless-stopped

　　　　ports:

　　　　　　- "8080:8080"

　　　　volumes:

　　　　　　- ./configs:/configs

　　　　　　- ./logs:/logs

　　　　　　- ./pipeline:/pipeline

　　　　　　- ./tessdata:/usr/share/tesseract-ocr/5/tessdata

　　　　　　- ./customFiles:/customFiles

　　　　environment:

　　　　　　TZ: Asia/Shanghai

　　　　　　SYSTEM_DEFAULTLOCALE: zh-CN

　　　　　　SECURITY_ENABLELOGIN: "true"

　　　　　　# 实验室可改为 "false"（勿用于公网）

　　　　　　# SECURITY_INITIALLOGIN_USERNAME: admin

　　　　　　# SECURITY_INITIALLOGIN_PASSWORD: "请换成强密码"

EOF

BASH

docker compose up -d

docker compose ps

docker compose logs --tail 100

TEXT

[+] up 2/2

　✔ Network stirlingpdf_default Created

　✔ Container stirlingpdf       Started

NAME          IMAGE                                                   COMMAND                  SERVICE       CREATED         STATUS                            PORTS

stirlingpdf   docker.xuanyuan.run/casjaysdevdocker/stirlingpdf:2608   "tini -- /scripts/in…"   stirlingpdf   6 seconds ago   Up 4 seconds (health: starting)   0.0.0.0:8080->8080/tcp, [::]:8080->8080/tcp

TEXT

[init][warn] Using TESSDATA_PREFIX=/usr/share/tesseract-ocr/5/tessdata

--- Binary Versions ---

openjdk version "25.0.2" 2026-01-20 LTS

LibreOffice 26.2.2.2 620(Build:2)

tesseract 5.3.4

Detected container memory: 1798MB

Running Stirling PDF with DISABLE_ADDITIONAL_FEATURES= and VERSION_TAG=2.14.2

Starting SPDFApplication v2.14.2 using Java 25.0.2

The following 1 profile is active: "security"

Using default H2 database

Total disabled endpoints: 2. Disabled endpoints: pdf-to-cbr, url-to-pdf

Started SPDFApplication in 62.507 seconds (process running for 77.859)

Stirling-PDF running on port: 8080

Stirling-PDF Started.

Navigate to http://localhost:8080/

BASH

curl --noproxy '*' -I http://127.0.0.1:8080/

TEXT

HTTP/1.1 401 Unauthorized

X-Content-Type-Options: nosniff

X-Frame-Options: DENY

Content-Type: application/json

BASH

mkdir -p /www/wwwroot/stirlingpdf/{configs,logs,pipeline,tessdata,customFiles}

cd /www/wwwroot/stirlingpdf

docker run -d \

　　--name stirlingpdf \

　　--restart unless-stopped \

　　-p 8080:8080 \

　　-v /www/wwwroot/stirlingpdf/configs:/configs \

　　-v /www/wwwroot/stirlingpdf/logs:/logs \

　　-v /www/wwwroot/stirlingpdf/pipeline:/pipeline \

　　-v /www/wwwroot/stirlingpdf/tessdata:/usr/share/tesseract-ocr/5/tessdata \

　　-v /www/wwwroot/stirlingpdf/customFiles:/customFiles \

　　-e TZ=Asia/Shanghai \

　　-e SYSTEM_DEFAULTLOCALE=zh-CN \

　　-e SECURITY_ENABLELOGIN=true \

　　docker.xuanyuan.run/casjaysdevdocker/stirlingpdf:2608

BASH

# 拉取

docker pull docker.xuanyuan.run/casjaysdevdocker/stirlingpdf:2608

# Compose（主路径）

cd /www/wwwroot/stirlingpdf

docker compose up -d

docker compose ps

docker compose logs -f stirlingpdf

docker compose down

# 探测（就绪后多为 401）

curl --noproxy '*' -I http://127.0.0.1:8080/

# 备选 run

docker run -d --name stirlingpdf -p 8080:8080 \

　　-v /www/wwwroot/stirlingpdf/configs:/configs \

　　-e SYSTEM_DEFAULTLOCALE=zh-CN \

　　-e SECURITY_ENABLELOGIN=true \

　　docker.xuanyuan.run/casjaysdevdocker/stirlingpdf:2608