开源项目

项目概述

kkFileView 是一个基于 Spring Boot 的开源文档在线预览解决方案，支持主流文件格式的跨平台预览。其核心目标是简化文件预览服务的搭建与集成，提供灵活、高效的预览体验。

核心特性

1. 多平台支持

• 通过 REST API 提供服务，支持 Java、PHP、Python、Go 等语言集成。

• 兼容 HTTP/HTTPS 文件下载 URL、流 URL、FTP 等多种预览源。

2. 部署便捷

• 提供 ZIP、Tar.gz 发行包，含一键启动脚本和丰富配置项。

• 支持 Docker 镜像部署，适配容器化环境。

3. 扩展性强

• 抽象预览服务接口，方便二次开发与功能扩展。

• 持续丰富支持的文件类型。

支持的文件类型

涵盖办公文档、图像、音视频、压缩包、3D 模型、CAD 等 200+ 种格式：

• 办公文档：DOC/DOCX、XLS/XLSX、PPT/PPTX、WPS 系列、ODT/ODS 等。

• 图像：JPG/PNG/GIF/BMP/ICO/WEBP 等，支持翻转、缩放、镜像。

• PDF/OFM/RTF：支持图片和 PDF 两种预览模式。

• 音视频：MP3/WAV/MP4/FLV/AVI/MKV 等，支持转码预览。

• 压缩包：ZIP/RAR/TAR/7Z 等，可直接预览包内文件。

• 3D 模型：OBJ/STL/FBX/GLB/IFC 等。

• CAD 文件：DWG/DXF。

• 其他：TXT/XML/MD/ 代码文件、BPMN 流程图、DCM 医疗影像等。

预览模式

1. 文本预览

• 支持代码高亮（Java/PHP/JS 等）、Markdown 渲染。

• 默认支持 TXT/HTML/XML/LOG 等 20+ 格式。

2. 图片预览

• 支持缩放、旋转、镜像操作。

• 示例：localhost:8012/onlinePreview?url=http://example.com/image.jpg。

3. Office 文件预览

• 图片模式：将每页转为图片（适合大文件）。

• PDF 模式：转为 PDF 预览（适合内网快速加载）。

4. Excel 增强模式

• 支持 Web 预览（4.3.0+ 版本默认启用），优化表格展示。

5. 压缩包预览

• 直接预览压缩包内文件，无需解压。

6. 多媒体预览

• 支持视频播放、音频波形图展示。

典型应用场景

• 企业内部系统：集成预览功能到 OA/CRM 中，方便文档查阅。

• 云存储服务：提供在线预览能力，提升用户体验。

• 开发工具：嵌入 IDE 或代码仓库，支持代码文件预览。

部署与集成

1. 快速启动

• 下载发行包，执行 startup.sh（Linux）或 startup.bat（Windows）。

• 配置文件（application.properties）可自定义端口、存储路径等。

2. Docker 部署

• 拉取镜像：docker pull kekingcn/kkfileview。

• 运行容器：docker run -d -p 8012:8012 kekingcn/kkfileview。

3. API 调用示例

GET /onlinePreview?url=http://example.com/file.docx

社区与支持

• 开源地址：

  Gitee （https://gitee.com/kekingcn/file-online-preview）

  GitHub（https://github.com/kekingcn/kkFileView）

• 文档：提供部署指南、配置说明、常见问题解答。

• 扩展：通过实现接口可添加新文件类型的预览支持。

如需进一步了解部署细节或高级功能，可参考官方文档或社区资源