5 步验证kkFileView 在飞腾/海光上的部署与功能核对清单【免费下载链接】kkFileViewUniversal File Online Preview Project based on Spring-Boot项目地址: https://gitcode.com/GitHub_Trending/kk/kkFileViewkkFileView 是基于 Spring-Boot 的文件在线预览服务Word、PDF、CAD 转网页格式。这篇讲怎么在飞腾 FT-2000/4、海光 Dhyana 这类国产芯片上把它跑起来并逐项核对功能。读完你能完成构建镜像、跑通冒烟测试、验证 Office 与 CAD 转换、产出可交付的验证报告。先跑通4 条命令见到预览结果这一步的目标是让服务几分钟内起来。在目标机器上依次执行git clone https://gitcode.com/GitHub_Trending/kk/kkFileViewcd kkFileView/docker/kkfileview-base docker build --tag keking/kkfileview-base:local .第二条命令构建基础镜像内含 JDK21、无界面版 LibreOffice、中文字体构建说明见 docker/kkfileview-base/README.cn.md。构建产物是二进制文件架构必须和宿主机一致用下条命令核对docker inspect --format {{.Architecture}} keking/kkfileview-base:local预期输出飞腾/鲲鹏是arm64海光是amd64。对不上就说明拉错或构建错了镜像后面一切免谈。用业务镜像起服务仓库根目录的 Dockerfile 以 base 为基础cd kkFileView docker build --tag kkfileview:local . \ docker run -d -p 8012:8012 --name kkfileview kkfileview:local浏览器打开http://机器IP:8012/能看到首页就说明端口和进程都正常。环境对照表先对号入座芯片架构推荐系统内核依赖组件及最低版本飞腾 FT-2000/4arm64银河麒麟 V10≥4.19.90Docker ≥20.10、JDK21、无界面 LibreOffice、中文字体海光 Dhyanax86_64统信 UOS 20≥4.19.0同上鲲鹏 920arm64OpenEuler 22.03≥5.10.0同上注意海光是 x86_64和飞腾走的是两条完全不同的路径ARM 机器上构建运行的是 arm64 镜像x86 机器上可以顺便用docker buildx交叉构建 arm64 包给飞腾用。跨架构构建前先装 QEMU 用户模式模拟让 x86 内核能执行 arm 指令的模拟层docker run --privileged --rm tonistiigi/binfmt --install all分步验证5 步逐项核对第 1 步 镜像架构核对目的提前排除镜像与 CPU 架构不一致这个最常见故障源。操作构建完成后执行上一节的docker inspect命令。通过标准输出与uname -m对应arm64 ↔ aarch64amd64 ↔ x86_64。第 2 步 首页与冒烟用例目的确认服务端口、静态资源、常见文件类型预览链路通畅。操作浏览器访问 8012 端口首页或在 tests/e2e 下跑冒烟套件样例文件、运行步骤见 tests/e2e/README.mdcd kkFileView/tests/e2e npm install KK_BASE_URLhttp://机器IP:8012 npm run test:smoke通过标准首页可访问txt、pdf、zip 等用例全部通过各类型预览效果可对照 doc/img/preview/preview-text.png 和 doc/img/preview/preview-zip.png。第 3 步 Office 转换链路目的验证上传 → LibreOffice 转 PDF → 前端渲染这条主线这是预览服务的核心。操作上传含复杂表格、图片、中文字体混排的 .docx 和 .pptx各预览一次留意首份文件的首次转换较慢LibreOffice 冷启动属正常现象。通过标准表格边框完整、图片位置不错位、中文无方块乱码。第 4 步 CAD 矢量转换目的验证工程图纸的 SVG 矢量输出缩放不失真。操作用 tests/e2e/fixtures/text.dxf 这类小样例跑一次预览默认 aspose-cad 转换模块较耗 CPUARM64 上先跑小文件。通过标准页面为 SVG 矢量可缩放、无系统暂不支持类报错、转换耗时低于cad.timeout默认 90 秒。第 5 步 基线性能测试目的拿到与 x86 环境可对比的性能基线。操作用项目自带 e2e 性能用例见 tests/e2e/specs/perf-smoke.spec.tscd kkFileView/tests/e2e E2E_MAX_PREVIEW_MS20000 npm run test:perf通过标准txt/docx/xlsx 预览响应低于设定的E2E_MAX_PREVIEW_MS阈值把耗时、内存占用记录进报告。踩坑手册现象 / 原因 / 处理PDF 里中文变方块基础镜像已内置文泉驿等中文字体方块通常来自宿主机字体未生效。处理容器内执行fc-list :langzh核对缺字体就补装后重建 base 镜像。LibreOffice 起不来或秒退九成是镜像架构和宿主机对不上。处理用docker inspect核对 Architecture重新在对应架构机器上构建。x86 上 buildx 构建 arm64 报格式错误QEMU 用户模式没开。处理先跑tonistiigi/binfmt --install all再构建。CAD 转换超时aspose-cad 在 ARM64 上偏慢。处理小文件验证或调大KK_CAD_TIMEOUT再不行换 cadviewer 转换模块配置见 server/src/main/config/application.properties。视频预览卡死、内存飙高转码极耗资源。处理设KK_MEDIA_CONVERT_DISABLEtrue关闭转码先保主流程。可选调优非必须先跑基线再动缓存默认 JDK 单机缓存cache.typejdk。多实例部署时才改 Redis设KK_CACHE_TYPEredis。PDF 转图质量默认按页数自动分档 DPI150→72页数越多越省性能。超大 PDF 太慢时下调pdf2jpg.dpi默认 144。内存与 GCJVM 参数走启动环境变量即可如-Xms1024m -Xmx2048m -XX:UseG1GC。先跑第 5 步基线内存明显吃紧再动。交付与反馈测完该留下什么报告必含字段硬件与系统芯片型号、架构、OS 版本、内核版本镜像构建命令与架构核对输出各文件类型预览成功率docx/xlsx/pptx/pdf/cad/zip 分列性能数据响应时间、内存峰值、CPU 利用率附 x86 对照遗留问题与复现步骤入口文档建议提 PR 更新 docker/kkfileview-base/README.cn.md功能问题与适配数据提交上游 Issue测试脚本改进直接改 tests/e2e 目录。下一步建议ARM64 平台验证通过后再评估其他国产架构的支持情况把第 5 步的 x86/ARM 耗时对比放进 Issue方便上游确认是否需要平台专项优化有复现路径的问题优先提 Issue 附完整日志。【免费下载链接】kkFileViewUniversal File Online Preview Project based on Spring-Boot项目地址: https://gitcode.com/GitHub_Trending/kk/kkFileView创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考