openoffice/kkfileview repository overview

kkFileView:文件文档在线预览解决方案
更多版本访问此处⁠

⁠特性

• 一键部署，快速接入
• 支持常见文件格式，兼容新版Office文档
• 支持多种预览模式灵活切换
• 独立部署，提供restful接口，适用于微服务场景

⁠快速启动

docker run -itd \
  --name=kkFileView \
  -p 8012:8012 \
  -e KK_TRUST_HOST=your_ip_or_domain \
  --restart=always \
openoffice/kkfileview:latest

⁠支持的文件类型

• 支持 doc, docx, xls, xlsx, xlsm, ppt, pptx, csv, tsv, dotm, xlt, xltm, dot, dotx, xlam, xla, pages 等 Office 办公文档
• 支持 wps, dps, et, ett, wpt 等国产 WPS Office 办公文档
• 支持 odt, ods, ots, odp, otp, six, ott, fodt, fods 等OpenOffice、LibreOffice 办公文档
• 支持 vsd, vsdx 等 Visio 流程图文件
• 支持 wmf, emf 等 Windows 系统图像文件
• 支持 psd, eps 等 Photoshop 软件模型文件
• 支持 pdf ,ofd, rtf 等文档
• 支持 xmind 软件模型文件
• 支持 bpmn 工作流文件
• 支持 eml 邮件文件
• 支持 epub 图书文档
• 支持 obj, 3ds, stl, ply, gltf, glb, off, 3dm, fbx, dae, wrl, 3mf, ifc, brep, step, iges, fcstd, bim 等 3D 模型文件
• 支持 dwg, dxf, dwf, iges , igs, dwt, dng, ifc, dwfx, stl, cf2, plt 等 CAD 模型文件
• 支持 txt, xml(渲染), md(渲染), java, php, py, js, css 等所有纯文本
• 支持 zip, rar, jar, tar, gzip, 7z 等压缩包
• 支持 jpg, jpeg, png, gif, bmp, ico, jfif, webp 等图片预览（翻转，缩放，镜像）
• 支持 tif, tiff 图信息模型文件
• 支持 tga 图像格式文件
• 支持 svg 矢量图像格式文件
• 支持 mp3,wav,mp4,flv 等音视频格式文件
• 支持 avi,mov,rm,webm,ts,rm,mkv,mpeg,ogg,mpg,rmvb,wmv,3gp,ts,swf 等视频格式转码预览
• 支持 dcm 等医疗数位影像预览
• 支持 drawio 绘图预览

⁠接入说明

• 【http/https 资源文件预览】如果你的项目需要接入文件预览项目，达到对docx、excel、ppt、jpg等文件的预览效果，那么通过在你的项目中加入下面的代码就可以成功实现：

var url = 'http://127.0.0.1:8080/file/test.txt'; //要预览文件的访问地址
window.open('http://127.0.0.1:8012/onlinePreview?url='+encodeURIComponent(base64Encode(url)));

Copy
• 【http/https 流资源文件预览】很多系统内不是直接暴露文件下载地址，而是请求通过id、code等参数到通过统一的接口，后端通过id或code等参数定位文件，再通过OutputStream输出下载，此时下载url是不带文件后缀名的，预览时需要拿到文件名，传一个参数fullfilename=xxx.xxx来指定文件名，示例如下

var originUrl = 'http://127.0.0.1:8080/filedownload?fileId=1'; //要预览文件的访问地址
var previewUrl = originUrl + '&fullfilename=test.txt'
window.open('http://127.0.0.1:8012/onlinePreview?url='+encodeURIComponent(Base64.encode(previewUrl)));

Copy
• 【ftp 资源文件预览】如果要预览的FTP url是可以匿名访问的（不需要用户名密码），则可以直接通过下载url预览，示例如下

var url = 'ftp://127.0.0.1/file/test.txt'; //要预览文件的访问地址
window.open('http://127.0.0.1:8012/onlinePreview?url='+encodeURIComponent(Base64.encode(url)));

Copy
• 【ftp 加密资源文件预览】如果 FTP 需要认证访问服，可以通过在 url 中加入用户名密码等参数预览，示例如下

var originUrl = 'ftp://127.0.0.1/file/test.txt'; //要预览文件的访问地址
var previewUrl = originUrl + '?ftp.username=xx&ftp.password=xx&ftp.control.encoding=xx';
window.open('http://127.0.0.1:8012/onlinePreview?url='+encodeURIComponent(Base64.encode(previewUrl)));

Copy