kkFileView 免费 CAD 在线预览：从上传 DWG 到浏览器看图，只需 5 步-育师

kkFileView 免费 CAD 在线预览：从上传 DWG 到浏览器看图，只需 5 步

【免费下载链接】kkFileViewUniversal File Online Preview Project based on Spring-Boot项目地址: https://gitcode.com/GitHub_Trending/kk/kkFileView

kkFileView 是一个基于 Spring Boot 的通用文件在线预览项目，在 CAD 图纸在线预览这件事上做得很省事。它能把 DWG 图纸转成图片或 PDF，让你不用安装 CAD 软件，打开浏览器就能看图。工程师、学生、做技术选型的人都适合直接用。

🚀 快速跑起来

先确认环境：JDK 1.8+、Maven 3.5+，机器内存建议 4GB 起步。部署本身分 4 步。

第 1 步：拉取源码

git clone https://gitcode.com/GitHub_Trending/kk/kkFileView cd kkFileView

这条命令把项目下载到本地，并进入项目根目录。

第 2 步：改参数

打开配置文件 server/src/main/config/application.properties，默认端口是 8012，端口冲突时改这里就行。这个文件控制服务端口和预览行为，大多数情况保持默认即可。

第 3 步：构建打包

mvn clean package -DskipTests

把整个项目编译打包成一个可执行的 jar，跳过测试省时间。

第 4 步：启动验证

java -jar server/target/kkFileView-4.4.0.jar

启动成功后，浏览器打开 http://localhost:8012 就能看到上传页。拖入一份 DWG，它会自动转换并生成预览，到这里你就拿到了第一次正反馈。

两种预览模式，按需求选

同一个 DWG 文件，kkFileView 提供两种渲染方式，选型前先看区别：

图片模式把图纸按图层转成 PNG/JPG 序列，加载快，支持缩放、平移、旋转，适合大文件或低带宽场景；代价是精度略有损失。

每张图纸独立渲染成图片，客户端配置低也能顺畅打开大图。

PDF 模式把整份文件转成一个 PDF，保留矢量图形，支持精确测量和文本搜索，适合核对尺寸标注；首次加载时间稍长。DWG 在线转 PDF 一步到位，走的就是这条路。

PDF 模式里尺寸标注和文字都能选中、能搜索，核对起来方便。

一句话总结：文件大、带宽差选图片模式；要测量、要搜文字选 PDF 模式。

不止 CAD

CAD 只是它的强项之一。做 CAD 图纸在线预览的团队，通常还会顺手用它覆盖主流办公格式，一套服务全部搞定，无需额外授权：

格式	常见扩展名	预览特点
Word	doc/docx	渲染为页面图片，接近编辑器观感
Excel	xls/xlsx	表格按图片序列或 Web 表格渲染
PPT	ppt/pptx	每页独立渲染，翻页流畅
PDF	pdf	原生打开，画质保真

Word 文档逐页渲染，版式和分页保持原样。

PPT 每页一张图，翻页查看不会排版错乱。

PDF 走原生预览，文字和图片无损。

表格之外，图片、音视频、纯文本、压缩包（zip/rar，可钻到内层文件）、3D 模型（3ds）、思维导图（xmind）、BPMN 流程图等也都有支持，对应的截图可以在 doc/img/preview/ 目录里看到。

这些团队在用

车间工人→ 以前工位上没装 CAD，想看图得找工程师导图片 → 现在浏览器直接打开工艺图纸，零安装。

设计院专业组→ 建筑、结构、给排水各有图纸，以前互相发文件确认版本 → 现在同一个地址看最新版，专业间对图不用来回拉扯。

监理、施工、设计三方→ 以前图纸靠邮件传，容易拿错版本 → 现在各用统一平台查看，信息不对称带来的施工问题明显变少。

内存、大文件与性能：实测对照

转换是吃内存的活。机器配置先看这三档：

🧠2GB：基础配置，小图纸、本地测试够用
🧠4GB：推荐配置，覆盖大部分工程需求
🧠8GB：高性能配置，复杂三维模型场景

再是标准 DWG 文件的转换耗时（实测口径）：

⚡ 10MB 以内：30 秒以内
⚡ 10-50MB：30-120 秒
⚡ 50MB 以上：建议走分布式部署，别硬扛单台机器

我的建议是先按 4GB 起步，用自己项目里的真实图纸试一遍，耗时不达标再往上加。

接入你自己的系统

想把预览嵌进自家系统，用onlinePreview接口就行：把文件 URL 做 Base64 编码，拼到地址后面，预览页就出来了。

String fileUrl = "http://your-server/drawings/mechanical.dwg"; String encodedUrl = Base64.getUrlEncoder().encodeToString(fileUrl.getBytes()); String previewUrl = "http://localhost:8012/onlinePreview?url=" + encodedUrl;

三步：拿到文件地址，Base64 编码，拼出预览地址，浏览器直接打开。

背后是支持水平扩展和负载均衡的架构，配置集群部署后，可以同时接住数百个 CAD 文件的在线预览请求。如果你们团队的图纸存放在文件服务里，让后端把 HTTP 地址吐出来就行。