kkFileView如何预览DWG图纸CAD双模式配置与转换调优完整指南【免费下载链接】kkFileViewUniversal File Online Preview Project based on Spring-Boot项目地址: https://gitcode.com/GitHub_Trending/kk/kkFileView交付资料里常出现一批DWG图纸电脑没装AutoCAD就打不开。用kkFileView的CAD预览能力可以直接在浏览器里把DWG渲染成SVG矢量图或PDF还能切换外部转换引擎。本文按最小部署→双模式调用→超时与并发调优的顺序带你把图纸预览服务真正跑起来。它解决了什么问题kkFileView是基于Spring Boot的开源文件在线预览项目后端用LibreOffice处理Office文档用aspose-cad处理CAD图纸打包后是单个jar文件。对没有图形软件权限的浏览器端尤其WebOffice、OA、网盘场景它省去了下载-安装-打开-截图这条链路。核心特性支持200文件格式单jar启动DWG/DXF转SVG、PDF、TIF三种输出双转换引擎内置aspose-cad / 外部cadviewer信任主机白名单防SSRF滥用转换状态轮询大文件不阻塞请求安全边界细节可参考仓库内 SECURITY_CONFIG.md整体功能清单见 README.cn.md。三步把服务跑起来git clone https://gitcode.com/GitHub_Trending/kk/kkFileView cd kkFileView mvn clean package -DskipTests java -jar server/target/kkFileView-5.0.0.jar启动后访问http://localhost:8012即为预览控制台。端口由server.port控制默认8012。与CAD直接相关的参数集中在 server/src/main/config/application.properties 的三、CAD文件处理配置区段建议先记住这5个参数默认值作用cad.preview.typesvg输出格式可选svg/pdf/tifcad.conversionmodule11内置aspose-cad2外部cadviewercad.cadconverterpathfalse外部转换包路径用cadviewer时必填cad.timeout90单次转换超时秒超时任务被强制终止cad.thread5并发转换信号量上限cad.preview.type pdf cad.conversionmodule 2 cad.cadconverterpath /opt/cadviewer/ cad.thread 8 cad.timeout 180双模式预览的原理与调用DWG是怎么变成矢量页的转换流程在 server/src/main/java/cn/keking/service/impl/CadFilePreviewImpl.java 中发起实际渲染由 server/src/main/java/cn/keking/service/CadToPdfService.java 完成请求/onlinePreview进入预览工厂按扩展名路由到CAD处理器文件先下载到本地file.dir目录已转换则直接命中缓存aspose-cad以简化中文编码加载图纸按高保真栅格化选项渲染按cad.preview.type输出SVG默认、PDF或TIF完成后写入缓存用API打开一张图纸预览接口只有一个必传参数文件URL的Base64编码。把图纸URL做Base64编码再经URL编码更稳妥拼进url参数浏览器打开拼接后的地址转换期间页面会轮询进度直至渲染完成# 将图纸地址编码后调用 B64$(echo -n https://files.example.com/drawings/floor_a.dwg | base64) curl -s http://localhost:8012/onlinePreview?url${B64} -o preview.html优势SVG模式无损缩放适合审图PDF模式保留页面对象方便打印和批注。适用场景SVG用于大屏审图与外网访问PDF用于归档、打印与在线标注。验证预览是否生效转换完成后打开预览页即可看到完整图纸。SVG模式下放大10倍线条仍然锐利说明矢量渲染成功PDF模式下检查标注文字是否可读、图层颜色是否保留。从单张图纸到批量预转换大图纸切换外部cadviewer引擎aspose-cad在进程内渲染吃CPU和内存服务器核数少时并发会被信号量卡住。图纸普遍较大单张几十MB时建议把cad.conversionmodule改为2部署独立的cadviewer转换包并用cad.cadconverterpath指向其目录。两种引擎的输出都走同一套缓存与预览页前端无感知。批量预热转换队列服务暴露了/addTask入队接口可以在图纸分发前把整批URL预先排队转换用户点开时直接命中缓存import base64, urllib.parse, requests def enc(url): return urllib.parse.quote(base64.b64encode(url.encode()).decode()) for name in [floor_a.dwg, floor_b.dwg, site_plan.dwg]: raw fhttps://files.example.com/drawings/{name} requests.get(fhttp://localhost:8012/addTask?url{enc(raw)}) print(已入队预览页:, fhttp://localhost:8012/onlinePreview?url{enc(raw)})入队后无需关心转换时机cache.enabled默认开启转换结果会驻留缓存由cache.clean.cron默认每天凌晨3点清理过期项。转换超时与信任域名三个高频坑转换超时→ 大图纸在默认90秒内没转完任务被强制取消页面停留等待页。解法把cad.timeout提到180~300同时检查服务器内存大型图纸建议4G以上仍超时就切到cadviewer引擎分摊进程压力。预览外部URL被拒→trust.host未配置时默认拒绝所有外部文件这是防SSRF的设计而非故障。解法在application.properties中按域名白名单填写如trust.host files.example.com,cdn.example.com配合not.trust.host封禁192.168.*、10.*等内网段。切勿直接设为*。cadviewer模式下中文标注乱码→ 外部引擎依赖字体包Linux服务器默认不带。解法按配置注释把cadviewer字体包解压到cad.file.path目录下的fonts/子目录后重启字体缺失时先切回aspose-cad模式兜底它已默认按简化中文编码加载图纸。适用边界与下一步一次构建即可覆盖DWG/DXF审图、PDF归档、TIF存档三种输出转换并发默认5路可调信任主机白名单禁止类型默认exe/dll/dat提供了可直接上生产的访问控制500MB上传上限与分级缓存清理让大图纸场景不必额外加存储策略后续版本可关注三维模型类格式的转换能力扩展配合/addTask队列能进一步压缩首次预览等待。把本文的快速上手命令和配置表存进你的部署文档下次交付图纸时直接复用这套服务即可。【免费下载链接】kkFileViewUniversal File Online Preview Project based on Spring-Boot项目地址: https://gitcode.com/GitHub_Trending/kk/kkFileView创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考