Stirling-PDF Docker 部署指南#

本指南介绍使用 Docker Compose 部署 Stirling-PDF 的步骤，包括配置帐户密码。

项目地址： https://github.com/Stirling-Tools/Stirling-PDF

1. 环境准备

• 确保已安装 Docker 和 Docker Compose。

2. 创建项目目录并初始化 Docker Compose 文件

• 创建名为 Stirling-PDF 的目录。
• 在 Stirling-PDF 目录中，新建文件 docker-compose.yml。

3. 配置 Docker Compose 文件 (无密码配置)

将以下内容复制到 docker-compose.yml 文件:

1
version: '3.3'
2
services:
3
  stirling-pdf:
4
    image: frooodle/s-pdf:latest
5
    ports:
6
      - '56315:8080'  # 修改端口
7
    volumes:
8
      - ./trainingData:/usr/share/tessdata # Required for extra OCR languages
9
      - ./extraConfigs:/configs
10
      # - ./customFiles:/customFiles/
11
      # - ./logs:/logs/
12
    environment:
13
      - DOCKER_ENABLE_SECURITY=false
14
      - INSTALL_BOOK_AND_ADVANCED_HTML_OPS=false
15
      - LANGS=zh_CN

解释：

• version: '3.3': 指定 Docker Compose 文件的版本。

• services: stirling-pdf:: 定义一个名为 stirling-pdf 的服务。

• image: frooodle/s-pdf:latest: 使用 frooodle/s-pdf 镜像的最新版本。

• ports: - '56315:8080': 将宿主机的 56315 端口映射到容器的 8080 端口（Stirling-PDF 默认端口）。

• volumes: 挂载数据卷：

  • ./trainingData:/usr/share/tessdata: 用于额外的 OCR 语言数据 (可选)。
  • ./extraConfigs:/configs: 用于存储额外的配置 (可选)。

• environment: 设置环境变量：

  • DOCKER_ENABLE_SECURITY=false: 禁用安全性，默认没有用户名密码。
  • INSTALL_BOOK_AND_ADVANCED_HTML_OPS=false: 禁用安装书籍和高级HTML操作。
  • LANGS=zh_CN: 设置语言为简体中文。

4. 配置帐户密码

要启用安全性并设置初始用户名和密码，将 docker-compose.yml 文件内容替换为以下内容：

1
version: '3.3'
2
services:
3
  stirling-pdf:
4
    image: frooodle/s-pdf:latest
5
    ports:
6
      - '56315:8080'  # 修改端口为56315
7
    volumes:
8
      - ./trainingData:/usr/share/tessdata # Required for extra OCR languages
9
      - ./extraConfigs:/configs
10
      - ./configs:/configs  # 添加配置文件挂载
11
    environment:
12
      - DOCKER_ENABLE_SECURITY=true  # 启用安全性
13
      - SECURITY_ENABLE_LOGIN=true  # 启用登录功能
14
      - SECURITY_INITIALLOGIN_USERNAME=admin  # 初始用户名
15
      - SECURITY_INITIALLOGIN_PASSWORD=stirling  # 初始密码
16
      - INSTALL_BOOK_AND_ADVANCED_HTML_OPS=false
17
      - LANGS=en_GB

解释：

• DOCKER_ENABLE_SECURITY=true: 启用安全性功能。
• SECURITY_ENABLE_LOGIN=true: 启用登录页面。
• SECURITY_INITIALLOGIN_USERNAME=admin: 设置初始用户名 (默认为 admin)。
• SECURITY_INITIALLOGIN_PASSWORD=stirling: 设置初始密码 (默认为 stirling)。 首次登录后，强烈建议更改此密码。
• LANGS=en_GB: 设置语言为英语 (英国).

5. 启动 Stirling-PDF 容器

1. 打开终端，进入 Stirling-PDF 目录 (cd /Stirling-PDF).

2. 执行以下命令启动容器：

   1
   docker compose up -d
   

1
`-d` 参数表示在后台运行容器。

6. 访问 Stirling-PDF

1. 在浏览器中输入 http://localhost:56315 访问 Stirling-PDF。
2. 使用 admin 用户名和 stirling 密码登录 (如果配置了密码)。

注意：

• 首次登录后，务必立即更改密码，以确保安全性。
• 根据需要配置额外的配置文件和 OCR 语言数据。