Stirling-PDF 的优势

• 广泛的 PDF 功能：访问 50+ 工具，包括签名、转换、合并等。

• 高级定制：深度定制、主题和环境变量。

• 企业特色：SSO、用户管理和权限控制。

• 数据安全：本地文件处理，任务后自动删除。

• 可扩展性和自动化：使用 Docker 和 Kubernetes 支持进行批处理。

• API集成：使用 API 进行自动化和外部集成。

• 开源：社区驱动，具有频繁的更新和 GitHub 支持。

• 多语言支持：提供 38+ 种语言版本，并提供有效的翻译。

1、创建专属桥接网络

若已创建，可跳过此步骤。

2、部署项目

2.1、创建项目

2.2、Compose配置

services:
  stirling-pdf:
    image: frooodle/s-pdf:latest
    container_name: stirling-pdf
    restart: always
    networks:
      - app_network
    ports:
      - '8082:8080'
    volumes:
      - ./data/trainingData:/usr/share/tesseract-ocr/5/tessdata
      - ./data/extraConfigs:/configs
      - ./data/customFiles:/customFiles/
      - ./data/logs:/logs/
      - ./data/pipeline:/pipeline/
    environment:
      # 设置为false，不启用账号安全
      // [!code ++]
      - DOCKER_ENABLE_SECURITY=false
      # 设置为true，启用账号安全，同时初始化默认账号和密码
      // [!code highlight:3]
      // [!code ++]
      - DOCKER_ENABLE_SECURITY=true
      // [!code ++]
      - SECURITY_INITIALLOGIN_USERNAME=admin
      // [!code ++]
      - SECURITY_INITIALLOGIN_PASSWORD=stirling
networks:
  app_network:
    external: true

复制代码后，请手动删除以 // [!code ++] 和 // [!code highlight:3] 开头的相关注释内容。

./data/trainingData：额外的OCR语言数据；

./data/extraConfigs：存放配置数据；

./data/customFiles：自定义文件；

./data/logs：日志文件；

./data/pipeline：流水线数据；

'8082:8080'：若端口占用，将8082替换为其他端口，8080不允许调整，访问路径：http://NasIP:8082；

DOCKER_ENABLE_SECURITY=false：是否启用安全模式，false：不启用，关闭账号登录，true：启用，开启账号登录。

仅当 DOCKER_ENABLE_SECURITY=true 时，以下配置信息才会生效。

默认用户名：admin

默认密码：stirling

注意：用户在首次登录时将被迫更改密码

可以使用以下环境变量设置自定义初始凭据：

SECURITY_INITIALLOGIN_USERNAME=用户名

SECURITY_INITIALLOGIN_PASSWORD=密码

特别提醒：部署完成后，不支持通过修改 Docker 配置来调整系统设置，仅能通过修改配置文件中的相关配置项进行更新。若需彻底变更配置，请先删除所有本地配置文件，然后重新部署 Docker 容器。

官方文档：https://docs.stirlingpdf.com/Advanced%20Configuration/How%20to%20add%20configurations