JeecgBoot低代码平台从 WPS 切换到 OnlyOffice 的开发配置指南

JeecgBoot AI专题研究 | JeecgBoot低代码在线文档编辑器切换与配置实践


切换背景

JeecgBoot低代码平台同时支持 WPS 和 OnlyOffice 两种在线文档编辑方案。在实际项目中,你可能因为授权成本、部署方式或功能需求等原因,需要从 WPS 切换到 OnlyOffice。

整个切换过程只需要修改前端环境变量和后端配置文件,无需改动任何业务代码。

前端配置修改

切换操作集中在环境变量文件中(.env.development 或 .env.production),涉及两项关键配置:

1. 修改文档编辑器版本标识

properties 复制代码
VITE_GLOB_ONLINE_DOCUMENT_VERSION=onlyoffice

将值从 wps 改为 onlyoffice,JeecgBoot低代码前端会自动加载对应的编辑器组件和交互逻辑。

2. 更新代理与域名地址

properties 复制代码
VITE_PROXY=[["/api","http://192.168.1.100:8080/jeecg-boot"]]
VITE_GLOB_DOMAIN_URL=http://192.168.1.100:8080/jeecg-boot

重要提示 :这里不能使用 localhost 或 127.0.0.1。OnlyOffice 运行在 Docker 容器中,回调请求发起方是容器内部的服务,localhost 指向的是容器自身而非你的开发机。必须使用开发机的实际 IP 地址。

后端配置修改

在 JeecgBoot低代码后端的 YAML 配置文件中,需要填写 OnlyOffice 服务的访问地址:

yaml 复制代码
onlyoffice:
  doc-service-url: http://192.168.1.100:9000

确保该地址指向已经部署好的 OnlyOffice DocumentServer 实例。如果尚未部署,请先参考 Docker 安装指南完成 OnlyOffice 的部署。

配置核对清单

完成切换后,对照以下清单确认配置正确:

配置项 检查要点
VITE_GLOB_ONLINE_DOCUMENT_VERSION 值为 onlyoffice
VITE_PROXY IP 地址为实际地址,非 localhost
VITE_GLOB_DOMAIN_URL 同上
后端 OnlyOffice 地址 指向正确的 DocumentServer
OnlyOffice 容器 已开启私有 IP 访问权限

常见问题

编辑器加载失败 :检查 OnlyOffice 服务是否正常运行,浏览器访问 http://IP:9000 确认。

文档保存失败:大概率是 IP 地址配置问题,确保前后端和 OnlyOffice 三者之间能互相通过 IP 访问。

跨域报错:检查 JeecgBoot低代码前端的代理配置是否正确,以及后端的 CORS 设置。


总结

JeecgBoot低代码平台的文档编辑器切换设计得非常优雅------通过一个环境变量即可完成前端的编辑器切换,配合后端地址配置,整个过程对业务代码零侵入。唯一需要注意的是 IP 地址的配置,务必避免使用 localhost。


本文为 JeecgBoot AI 专题研究系列文章。

相关推荐
张紫娃7 分钟前
Chrome插件-Stylus(屏蔽博客广告)
前端·chrome·stylus
Yannik32 分钟前
在 Apple Silicon Mac 上用 Jenkins + Fastlane 搭建 iOS CI:从自动打包到 MR 检查流水线的完整实践
前端
Nayana32 分钟前
《Web 到 HarmonyOS》-- 打包:Vite 产物 → HAP / HAR / HSP
前端
inksci39 分钟前
用飞帆做了个小网页
前端·javascript·css·html
去伪存真42 分钟前
被 pnpm 打包坑惨后,我彻底盘明白了硬链接与软链接
前端·electron
zhensherlock2 小时前
Protocol Launcher 系列:CodeHub 移动端 GitHub 协作利器
前端·javascript·typescript·node.js·自动化·github·js
tryCbest6 小时前
Vue3——第 22 篇:Pinia——新一代状态管理(上)
前端·javascript·vue.js
bai2737 小时前
"👨‍👩‍👧‍👦" 的 length 是 11:我把自己写的字数统计脚本拖出来审了一遍
前端·javascript
zhanlang02178 小时前
HTML 零基础入门到企业实战【第八章 8.5】画布 canvas、SVG 矢量图形基础入门
前端·html
星云_byto9 小时前
CSS面试题
前端·css