accusoft/prizmdoc-serverPrizmDoc Server 是 PrizmDoc Viewer 产品后端架构的核心组件(了解 PrizmDoc Viewer 整体架构及 PrizmDoc Server 的定位)。作为官方 Docker 镜像,它适用于将 PrizmDoc Server 部署到 Docker 主机的生产环境。
注意: 此镜像专为生产部署设计。若需快速评估产品或进行本地开发,建议使用 accusoft/prizmdoc-viewer-eval 镜像。
运行 PrizmDoc Server 容器需具备 Docker 主机(已安装 Docker 的机器),详见 Docker 官方文档。
部署前必须配置 Docker 以分配足够的硬件资源,若 CPU 或内存不足,服务可能无法正常运行。具体资源需求请参考 服务器 sizing 指南。
执行以下命令拉取最新版 PrizmDoc Server 镜像:
bashdocker pull accusoft/prizmdoc-server
首次部署需生成配置文件(若已有自定义配置文件,可跳过此步骤直接进入步骤 4)。可通过镜像的 init-config 命令生成默认配置文件 prizm-services-config.yml。
Windows (PowerShell)
先创建本地 config 目录:
powershellmkdir config
再执行以下命令生成配置文件:
powershelldocker run --rm -e ACCEPT_EULA=YES --volume $pwd/config:/config accusoft/prizmdoc-server init-config
配置文件将生成在本地路径 .\config\prizm-services-config.yml。
Mac 或 Linux (bash)
直接执行以下命令生成配置文件:
bashdocker run --rm -e ACCEPT_EULA=YES --volume $(pwd)/config:/config accusoft/prizmdoc-server init-config
配置文件将生成在本地路径 ./config/prizm-services-config.yml。
需根据生产需求修改配置文件,具体配置选项参考 PrizmDoc Server 配置文档。生产环境至少需配置许可证信息。
根据操作系统执行以下命令启动容器,默认配置下需挂载配置、日志(及 Linux 环境的数据)目录。
Windows (PowerShell)
先创建本地 logs 目录:
powershellmkdir logs
启动容器:
powershelldocker run -d --rm --env ACCEPT_EULA=YES --publish ***:*** --volume $pwd/config:/config --volume $pwd/logs:/logs --name prizmdoc-server accusoft/prizmdoc-server
Mac (bash)
bashdocker run -d --rm --env ACCEPT_EULA=YES --publish ***:*** --volume $(pwd)/config:/config --volume $(pwd)/logs:/logs --name prizmdoc-server accusoft/prizmdoc-server
Linux (bash)
bashdocker run -d --rm --env ACCEPT_EULA=YES --publish ***:*** --volume $(pwd)/config:/config --volume $(pwd)/logs:/logs --volume $(pwd)/data:/data --name prizmdoc-server accusoft/prizmdoc-server
Docker 运行参数说明
| 参数 | 说明 |
|---|---|
-d | 后台运行容器 |
--rm | 容器停止后自动删除 |
--env ACCEPT_EULA=YES | 必须设置,表明接受 软件许可协议 |
--publish ***:*** | 映射容器的 *** 端口到主机(默认公共端口),若启用集群需额外映射 *** 端口(集群端口) |
--volume ...:/config | 挂载本地配置目录,需包含 prizm-services-config.yml 文件 |
--volume ...:/logs | 挂载本地日志目录,容器停止后日志保留在主机 |
--volume ...:/data | Linux 环境特有,挂载数据目录(因 PrizmDoc Server 使用内存映射文件,仅 Linux 支持该挂载) |
--name prizmdoc-server | 指定容器名称,便于后续管理 |
服务启动需几分钟,完全就绪后可通过以下方式验证健康状态:
Windows (PowerShell)
powershellInvoke-WebRequest -Uri http://localhost:***/PCCIS/V1/Service/Current/Health
成功时返回状态码 200,示例输出:
StatusCode : 200 StatusDescription : OK Content : {79, 75} ...
Mac 或 Linux (bash)
bashcurl -i http://localhost:***/PCCIS/V1/Service/Current/Health
成功时返回状态码 200,示例输出:
HTTP/1.1 200 OK X-Server***: 69a6d22f90b9 ... OK
注意: 服务启动过程中可能返回无响应或错误,需等待几分钟后重试。若始终无响应,可通过浏览器访问管理状态页排查:http://localhost:***/admin。
通过容器名称停止服务:
bashdocker stop prizmdoc-server

manifest unknown 错误
TLS 证书验证失败
DNS 解析超时
410 错误:版本过低
402 错误:流量耗尽
身份认证失败错误
429 限流错误
凭证保存错误
来自真实用户的反馈,见证轩辕镜像的优质服务