pdftron/webviewer-server

WebViewer Server 镜像文档

镜像概述和主要用途

WebViewer Server 是一个可定制的后端服务，与 WebViewer 和 Apryse SDK 集成，提供高性能且易于使用的文档渲染任务执行体验。该容器基于 Debian 系统，运行 Apache Tomcat 并部署 WebViewer Server Apryse SDK。

容器默认以演示模式运行，可通过传入许可证密钥获取完整功能。

核心功能和特性

• 高性能文档渲染：与 Apryse SDK 深度集成，高效处理各类文档渲染任务
• 与 WebViewer 无缝集成：作为 WebViewer 前端的后端服务，提升文档处理能力
• 稳定运行环境：基于 Debian 系统和 Apache Tomcat，确保服务可靠运行
• 负载均衡支持：可与 https://hub.docker.com/r/pdftron/wv-load***/ 配合，实现多实例负载分担、请求粘性保持及故障实例隔离
• 可定制配置：支持通过环境变量和配置文件调整服务参数

使用场景和适用范围

WebViewer Server 适用于需要后端文档渲染支持的应用场景，尤其适合与 WebViewer 前端集成，为以下场景提供高性能文档处理能力：

• 企业文档管理系统
• 在线文档查看与协作平台
• 文档预览服务
• 需要处理复杂文档渲染任务的 Web 应用

支持的标签

• latest,2.4.0, 2.3.8, 2.3.7, 2.3.6r2, 2.3.5, 2.3.4, 2.3.3, 2.3.2, 2.3.1,2.3.0, 2.2.5, 2.2.4, 2.2.3, 2.2.2, 2.2.1,2.2.0, 2.1.9, 2.1.8, 2.1.7, 2.1.6, 2.1.5, 2.1.4r1, 2.1.2, 2.1.1, 2.1.0,2.0.0, 1.5.8, 1.5.7,1.5.6,1.5.5, 1.5.4, 2.0, 2.1,2.2, 2.3, 2.4, 1.5, nightly_arm_experimental,nightly_arm_experimental_{year-month-day}, nightly_experimental_master_{year-month-day}, nightly_stable_release_2.1.7_{year-month-day}
• arm64-latest, arm64-2.4, arm64-2.4.0, arm64-2.3, arm-2.3.8, arm-2.3.7, arm-2.3.6

使用方法和配置说明

基本使用

运行 WebViewer Server 容器

bash
docker run --name webviewer-server -p 8090:8090 -e INCLUDE_DEMO='true' pdftron/webviewer-server:latest

访问演示应用

若启用演示模式，可通过以下地址访问演示应用：

[服务地址]:8090/demo?s

与 WebViewer 集成

将 WebViewer Server 地址添加到 WebViewer 构造函数的配置中：

javascript
options.webViewerServerUrl = 'http://localhost:8090/';
var myWebViewer = new PDFTron.WebViewer(options, viewerElement);

环境变量配置

Docker Compose 部署（参考）

官网提供包含 wv-loadbalancer 和 webviewer-server 的组合部署方案，详情可参考 官方部署指南。以下为基础示例：

yaml
version: '3'
services:
  webviewer-server:
    image: pdftron/webviewer-server:latest
    ports:
      - "8090:8090"
    environment:
      - INCLUDE_DEMO='true'
      - TRN_PDFNET_KEY='your_license_key'
    restart: always

参考信息

• 官方文档：WebViewer Server 部署指南
• 获取帮助：Apryse 支持团队
• 问题反馈：通过 官网表单 提交
• 维护者：Apryse
• 支持架构：当前仅支持 amd64
• 支持 Docker 版本：2.0 及以上