
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具,协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题,请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可:
请先完整阅读并严格遵守以下文档中的全部规则与要求:
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前,不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式,不推荐豆包 AI;Cursor 等编辑器可在对话 @ 该链接,或加入 User Rules。 若 AI 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。
PrizmDoc Server 是 PrizmDoc Viewer 产品后端架构的核心组件(了解 PrizmDoc Viewer 整体架构及 PrizmDoc Server 的定位)。作为官方 Docker 镜像,它适用于将 PrizmDoc Server 部署到 Docker 主机的生产环境。
注意: 此镜像专为生产部署设计。若需快速评估产品或进行本地开发,建议使用 https://hub.docker.com/r/accusoft/prizmdoc-viewer-eval%E3%80%82
运行 PrizmDoc Server 容器需具备 Docker 主机(已安装 Docker 的机器),详见 Docker 官方文档。
部署前必须配置 Docker 以分配足够的硬件资源,若 CPU 或内存不足,服务可能无法正常运行。具体资源需求请参考 服务器 sizing 指南。
1. 获取最新镜像
执行以下命令拉取最新版 PrizmDoc Server 镜像:
bashdocker pull accusoft/prizmdoc-server
2. 初始化默认配置文件
首次部署需生成配置文件(若已有自定义配置文件,可跳过此步骤直接进入步骤 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。
3. 自定义配置文件
需根据生产需求修改配置文件,具体配置选项参考 PrizmDoc Server 配置文档。生产环境至少需配置许可证信息。
4. 启动 PrizmDoc Server
根据操作系统执行以下命令启动容器,默认配置下需挂载配置、日志(及 Linux 环境的数据)目录。
Windows (PowerShell)
先创建本地 logs 目录:
powershellmkdir logs
启动容器:
powershelldocker 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)
bashdocker 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)
bashdocker 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 运行参数说明
| 参数 | 说明 |
|---|---|
-d | 后台运行容器 |
--rm | 容器停止后自动删除 |
--env ACCEPT_EULA=YES | 必须设置,表明接受 软件许可协议 |
--publish 18681:18681 | 映射容器的 *** 端口到主机(默认公共端口),若启用集群需额外映射 *** 端口(集群端口) |
--volume ...:/config | 挂载本地配置目录,需包含 prizm-services-config.yml 文件 |
--volume ...:/logs | 挂载本地日志目录,容器停止后日志保留在主机 |
--volume ...:/data | Linux 环境特有,挂载数据目录(因 PrizmDoc Server 使用内存映射文件,仅 Linux 支持该挂载) |
--name prizmdoc-server | 指定容器名称,便于后续管理 |
5. 检查服务健康状态
服务启动需几分钟,完全就绪后可通过以下方式验证健康状态:
Windows (PowerShell)
powershellInvoke-WebRequest -Uri http://localhost:18681/PCCIS/V1/Service/Current/Health
成功时返回状态码 200,示例输出:
StatusCode : 200 StatusDescription : OK Content : {79, 75} ...
Mac 或 Linux (bash)
bashcurl -i http://localhost:18681/PCCIS/V1/Service/Current/Health
成功时返回状态码 200,示例输出:
HTTP/1.1 200 OK X-Server-Chain: 69a6d22f90b9 ... OK
注意: 服务启动过程中可能返回无响应或错误,需等待几分钟后重试。若始终无响应,可通过浏览器访问管理状态页排查:http://localhost:18681/admin。
6. 停止容器
通过容器名称停止服务:
bashdocker stop prizmdoc-server
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
来自真实用户的反馈,见证轩辕镜像的优质服务