PrizmDoc Server

镜像概述和主要用途

PrizmDoc Server 是 PrizmDoc Viewer 产品后端架构的核心组件（了解 PrizmDoc Viewer 整体架构及 PrizmDoc Server 的定位）。作为官方 Docker 镜像，它适用于将 PrizmDoc Server 部署到 Docker 主机的生产环境。

注意： 此镜像专为生产部署设计。若需快速评估产品或进行本地开发，建议使用 accusoft/prizmdoc-viewer-eval 镜像。

核心功能和特性

• 提供文档转换与处理的后端服务能力，支持多种格式的文档解析、转换和渲染
• 作为 PrizmDoc Viewer 的核心后端组件，处理文档处理任务的调度与执行
• 支持通过配置文件自定义服务参数，适应不同生产环境需求

使用场景和适用范围

• 适用场景：企业级文档管理系统、在线文档预览平台、文档协作工具等需要高效文档处理能力的生产环境
• 适用范围：需部署 PrizmDoc Viewer 后端服务的 Docker 环境，要求稳定的文档转换、处理性能

推荐硬件要求

运行 PrizmDoc Server 容器需具备 Docker 主机（已安装 Docker 的机器），详见 Docker 官方文档。

部署前必须配置 Docker 以分配足够的硬件资源，若 CPU 或内存不足，服务可能无法正常运行。具体资源需求请参考 服务器 sizing 指南。

详细使用方法和配置说明

部署 PrizmDoc Server

1. 获取最新镜像

执行以下命令拉取最新版 PrizmDoc Server 镜像：

docker pull accusoft/prizmdoc-server

2. 初始化默认配置文件

首次部署需生成配置文件（若已有自定义配置文件，可跳过此步骤直接进入步骤 4）。可通过镜像的 init-config 命令生成默认配置文件 prizm-services-config.yml。

Windows (PowerShell)

先创建本地 config 目录：

mkdir config

再执行以下命令生成配置文件：

docker run --rm -e ACCEPT_EULA=YES --volume $pwd/config:/config accusoft/prizmdoc-server init-config

配置文件将生成在本地路径 .\config\prizm-services-config.yml。

Mac 或 Linux (bash)

直接执行以下命令生成配置文件：

docker run --rm -e ACCEPT_EULA=YES --volume $(pwd)/config:/config accusoft/prizmdoc-server init-config

配置文件将生成在本地路径 ./config/prizm-services-config.yml。

3. 自定义配置文件

需根据生产需求修改配置文件，具体配置选项参考 PrizmDoc Server 配置文档。生产环境至少需配置许可证信息。

4. 启动 PrizmDoc Server

根据操作系统执行以下命令启动容器，默认配置下需挂载配置、日志（及 Linux 环境的数据）目录。

Windows (PowerShell)

先创建本地 logs 目录：

mkdir logs

启动容器：

docker run -d --rm --env ACCEPT_EULA=YES --publish 18681:18681 --volume $pwd/config:/config --volume $pwd/logs:/logs --name prizmdoc-server accusoft/prizmdoc-server

Mac (bash)

docker run -d --rm --env ACCEPT_EULA=YES --publish 18681:18681 --volume $(pwd)/config:/config --volume $(pwd)/logs:/logs --name prizmdoc-server accusoft/prizmdoc-server

Linux (bash)

docker run -d --rm --env ACCEPT_EULA=YES --publish 18681:18681 --volume $(pwd)/config:/config --volume $(pwd)/logs:/logs --volume $(pwd)/data:/data --name prizmdoc-server accusoft/prizmdoc-server

Docker 运行参数说明

5. 检查服务健康状态

服务启动需几分钟，完全就绪后可通过以下方式验证健康状态：

Windows (PowerShell)

Invoke-WebRequest -Uri http://localhost:18681/PCCIS/V1/Service/Current/Health

成功时返回状态码 200，示例输出：

StatusCode        : 200
StatusDescription : OK
Content           : {79, 75}
...

Mac 或 Linux (bash)

curl -i http://localhost:18681/PCCIS/V1/Service/Current/Health

成功时返回状态码 200，示例输出：

HTTP/1.1 200 OK
X-Server***: 69a6d22f90b9
...
OK

注意： 服务启动过程中可能返回无响应或错误，需等待几分钟后重试。若始终无响应，可通过浏览器访问管理状态页排查：http://localhost:18681/admin。

6. 停止容器

通过容器名称停止服务：

docker stop prizmdoc-server

产品文档

• PrizmDoc Viewer 概述
• PrizmDoc Server 配置选项

法律信息

• 版权信息
• 软件许可协议
• 第三方归因