企业官网建设流程全解析

kkFileView 集成 OnlyOffice：快速搭建本地实时协作文档编辑平台

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

本文以 kkFileView 为基础集成 OnlyOffice 文档服务器，把文件预览站点扩展为支持实时协作编辑的在线办公入口，数据全程存放在自有服务器。适合具备基础 Linux 与 Docker 操作能力、需要在内网环境落地文档协作系统的团队使用。

搭建完成后你能得到什么

• 预览界面直接进入编辑：上传 Office 文档后，无需下载即可在线修改
• 多人同时编辑同一文件，修改实时同步，右侧可见当前在线成员
• 编辑范围覆盖doc,docx,xls,xlsx,ppt,pptx六类格式，其余 30 余种格式仍走 kkFileView 原有预览链路
• 文件与协作数据全部落在本地服务器，不经过第三方云端

简单说，kkFileView 是基于 Spring-Boot 的通用文件在线预览项目，负责文件解析与预览展示；OnlyOffice 是开源办公套件，提供文档、表格、演示文稿的在线编辑引擎。两者对接后，编辑动作交给 OnlyOffice 执行，kkFileView 继续承担入口与预览职责。

环境基线与组件联动方式

kkFileView 运行在 8012 端口，负责接收文件并发起预览/编辑请求；OnlyOffice Document Server 监听 8081 端口，负责实际的文档编辑。编辑期间产生的文件与数据均保存在部署服务的本机磁盘上。

阶段一：拉取源码并启动编辑服务

先用一条命令启动 OnlyOffice 社区版容器，再克隆项目源码：

git clone https://gitcode.com/GitHub_Trending/kk/kkFileView.git docker run -i -t -d -p 8081:80 --restart=always onlyoffice/documentserver

浏览器访问http://localhost:8081，能正常返回 OnlyOffice 服务页面即表示编辑服务就绪。

阶段二：在 kkFileView 中打通编辑入口

编辑配置集中在 server/src/main/config/application.properties，加入以下行：

# OnlyOffice 服务地址与鉴权密钥 onlyoffice.server.url=http://localhost:8081/ onlyoffice.server.jwtSecret=your-secret-key-here # 允许在线编辑的文件类型 onlyoffice.edit.fileTypes=doc,docx,xls,xlsx,ppt,pptx # 可选：限制同时编辑人数、启用文件缓存 onlyoffice.edit.maxUsers=5 cache.enabled=true

⚠️onlyoffice.server.jwtSecret必须与 OnlyOffice 服务端配置一致，可进入容器查看/etc/onlyoffice/documentserver/local.json核对。如需定期清理临时文件，追加tempFile.cleanSchedule=0 0 2 * * ?即可。

阶段三：打包构建并上线验证

在仓库根目录执行构建，然后启动服务：

mvn clean package -DskipTests java -jar server/target/kkFileView-*.jar

上传一个.docx或.xlsx文件，在预览界面点击"编辑"按钮，能进入 OnlyOffice 编辑器且多人可同屏修改、改动即时同步，即验证通过。

验证不通过时的常见现象与处理

收尾：这套组合的价值与后续方向

这套方案让 kkFileView 从"只能看"升级为"能协作"，且编辑引擎与数据全部留在本地，适合对文件安全有要求的内网场景。后续可以往两个方向延伸：一是权限控制，按用户区分可编辑与只读；二是将 OnlyOffice Document Server 扩展为多实例集群，以支撑更大的并发编辑量。

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