WebViewer Server 镜像文档

镜像概述和主要用途

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

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

核心功能和特性

高性能文档渲染：与 Apryse SDK 深度集成，高效处理各类文档渲染任务
与 WebViewer 无缝集成：作为 WebViewer 前端的后端服务，提升文档处理能力
稳定运行环境：基于 Debian 系统和 Apache Tomcat，确保服务可靠运行
负载均衡支持：可与 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);

环境变量配置

环境变量	说明	默认值
`INCLUDE_DEMO`	是否启用演示应用	`false`
`TRN_PDFNET_KEY`	许可证密钥，用于解锁完整功能（可从官网获取演示密钥）	未设置

Docker Compose 部署（参考）

官网提供包含 wv-load*** 和 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