kkFileView 集成 OnlyOffice 教程：三步跑通在线预览与实时协作

kkFileView 集成 OnlyOffice 教程：三步跑通在线预览与实时协作

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

把 kkFileView 和 OnlyOffice 接起来，你得到的是一套本地部署的在线预览＋实时协作服务：kkFileView 负责 30 多种格式的文件预览，OnlyOffice 负责文档编辑。部署完成后，多人可以在浏览器里同时打开同一个 Office 文件进行修改，改动实时同步，文件全部存放在你自己的服务器上。整个过程分三步走：拉起文档服务、打通两边、启动并验证，下面的命令可以直接照抄。

kkFileView 集成 OnlyOffice 后能得到哪些能力

• 预览和编辑在同一页面：文件在 kkFileView 里预览，直接切入 OnlyOffice 编辑模式，不用下载再上传
• 多人实时同步：数人同改一份文档，编辑延迟低于 300ms，右侧能看到在线成员
• 数据不出内网：预览、编辑、存储全在自己的服务器上完成，文件不经过任何第三方平台
• 零授权费用：两边都是开源项目，部署和使用都不产生额外费用

动手之前：先过一遍环境自检清单

📋 对着「最低」一列检查你的服务器，条件允许的话按「推荐」列配置。

确认没问题后，把源码克隆到本地：

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

上线全流程：从拉起文档服务到验证协作

最小命令拉起文档服务

目标：先把 OnlyOffice 文档服务器跑起来，它是所有编辑功能的后端引擎。

docker run -i -t -d -p 8081:80 --restart=always onlyoffice/documentserver

如何确认成功：浏览器打开 http://localhost:8081 ，看到 OnlyOffice 文档服务页面，就说明容器已经正常工作。

几行配置打通预览与编辑

目标：让 kkFileView 知道文档服务器在哪里、哪些文件类型允许进入编辑模式。

打开项目里的 application.properties，加上三行：

onlyoffice.server.url=http://localhost:8081/ onlyoffice.server.jwtSecret=your-secret-key-here onlyoffice.edit.fileTypes=doc,docx,xls,xlsx,ppt,pptx

两个注意：jwtSecret 必须和 OnlyOffice 服务端保持一致，服务端取值可在容器内的 /etc/onlyoffice/documentserver/local.json 里查；server.url 要写成 kkFileView 实际访问文档服务器的地址。

如何确认成功：逐项核对一遍，重点是 jwtSecret 两边是否逐字符相同，差一个字符都进不了编辑模式。

启动服务，一次验证实时协作

目标：构建并启动 kkFileView，验证多人协作链路是否真正打通。

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

如何确认成功：上传一份测试 docx 并点击「编辑」，再用另一个浏览器打开同一份文件进入编辑，双方改动实时可见，右侧出现在线成员列表，链路就算通了。

出问题先查这三处

🔍 别急着重装，按顺序过一遍：

• 端口：确认防火墙或安全组放开了 8081；直接访问 http://localhost:8081 打不开页面，多半是端口被拦
• URL：核对 onlyoffice.server.url 和实际访问地址是否完全一致，协议、结尾的斜杠都要对齐
• 容器日志：用docker logs <容器ID>查看 OnlyOffice 的报错，配置类问题基本都会直接暴露出来

最后

三步走完后，预览和编辑都落在自己的服务器上，文件不出内网，两边又是开源免费，这就是本地化方案的核心价值。下一篇会讲权限控制和成员管理怎么配，需要的时候直接来看。

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