Skip to content

第三方依赖与插件说明

本文用于帮助 RuoYi Office 商业版用户了解系统中集成或预留的主要第三方依赖、插件与外部服务能力。版本信息以当前仓库依赖清单为准(统计日期:2026-05-29),后续升级请以交付版本中的 pom.xmlpnpm-workspace.yamlpackage.jsonpnpm-lock.yaml 为准。

一、重要说明

RuoYi Office 商业版交付的是基于本产品二次集成后的业务系统源码、配置、文档和部署资源。系统中使用的第三方开源组件、商业组件、在线服务、云服务 SDK 或地图服务,仍分别受其官方许可协议、服务条款、授权范围、调用额度和版权标识要求约束。

商业版客户在生产环境上线、对外分发、SaaS 化运营或为第三方客户实施前,建议重点核对:

  • 是否需要单独购买第三方商业授权;
  • 是否需要保留第三方版权、Logo、链接或产品标识;
  • 是否允许用于第三方客户项目、二次销售、SaaS、多租户或同类竞争产品;
  • 是否需要申请 API Key、域名白名单、服务额度、地图审图或备案;
  • 是否存在云服务、短信、支付、地图、AI 模型等按量计费项目。

二、重点第三方插件与商业授权提示

2.1 FormCreate 表单设计器

项目说明
当前依赖@form-create/ant-design-vue ^3.2.38@form-create/antd-designer ^3.4.0@form-create/designer ^3.4.0;仓库中也保留 Element UI / Naive UI 适配依赖
集成位置PC 管理端、流程表单、表单设计器、AI 表单生成 / 表单二开辅助能力
使用功能JSON 规则渲染表单、可视化拖拽设计表单、流程表单配置、动态表单预览与提交、AI 辅助生成表单规则等
官方链接FormCreate 价格与授权说明

RuoYi Office 团队已购买 FormCreate 商业版,并已将 FormCreate 的 Ant Design Vue 商业版能力集成到流程表单、表单设计器等模块中。商业版用户在使用 RuoYi Office 产品内置的流程表单和表单设计器能力时,可以直接使用已经集成好的设计器与运行时能力。

需要特别说明:由于 FormCreate 官方授权要求,RuoYi Office 不能向客户直接提供 FormCreate 商业版源码或独立商业版授权,也不能将 FormCreate 商业版作为可脱离 RuoYi Office 独立使用的第三方产品交付。RuoYi Office 可以提供的是已经集成到 RuoYi Office 产品中的 FormCreate 商业版编译文件,用于保障 RuoYi Office 内部表单设计器、流程表单等功能正常运行;如客户需要 FormCreate 商业版源代码、独立授权、第三方客户项目授权、企业授权或脱离 RuoYi Office 使用 FormCreate 商业版,请自行向 FormCreate 官方购买并确认授权范围。

如果客户不使用商业版设计器能力,RuoYi Office 也可根据场景提供 FormCreate 开源版源码或开源版集成方案。根据 FormCreate 官方价格页说明,开源版和商业版能力、是否可在第三方客户项目中使用、是否提供源码、企业授权等规则存在差异;请以官方最新条款为准。

2.2 积木报表 / JimuReport / JimuBI

项目说明
当前依赖jimureport-spring-boot3-starter 2.3.2jimubi-spring-boot3-starter 2.3.2
集成位置后端 yudao-module-report 报表模块、报表设计、报表预览、数据报表、大屏 / 仪表盘能力
使用功能在线 Web 报表设计器、类 Excel 报表设计、数据集、打印报表、图表报表、门户 / 大屏 / 仪表盘设计、API 数据源等
官方链接积木报表 VIP / 版本说明JimuReport 文档

RuoYi Office 集成的是积木报表 / JimuBI 相关能力,默认依赖为开源 / 免费版 starter。官方文档说明 JimuReport 是免费的数据可视化报表,支持报表、仪表盘和大屏设计。

商业使用时请注意遵循积木报表官方使用要求:项目可用于商业用途,但需要保留版权信息(例如“积木报表”等版权及链接);不得基于该软件基础包装成类似产品进行发布、销售,或与积木报表形成同类竞争。若需要去除版权、获得商业版高级功能、商业服务或更明确的授权范围,请向积木报表官方购买或咨询。

上线安全建议:积木报表官方文档提示敏感接口需要配置权限控制,并可通过 lowCodeMode: prod、租户隔离、API 数据源白名单、SQL 注入等级等参数降低生产风险。RuoYi Office 客户上线前应结合自身网络环境、账号权限和数据源范围完成安全加固。

2.3 地图服务:优先推荐天地图,按规范合规使用

项目说明
当前依赖 / 配置GoView 工程使用 @amap/amap-jsapi-loader ^1.0.1cesium 1.99xbsj-xe2 ^0.1.16;后端配置中预留 tencent-lbs-key;业务大屏可按项目接入天地图等底图服务
集成位置GoView 数据可视化大屏、地图组件、三维地球 / GIS 场景、地址定位或静态地图扩展
使用功能二维地图加载、地理位置展示、点线面覆盖物、三维地球、可视化大屏地图组件、行政区或业务点位展示
官方链接天地图天地图开发资源高德开放平台腾讯位置服务Cesium

国内项目中,如只是做常规地图底图、位置展示、点位上图、业务区域展示等,优先推荐使用天地图。天地图是国家地理信息公共服务平台,客户按官方规范注册账号、创建应用、申请浏览器端 / 服务端 tk,并遵守调用额度、服务条款、地图内容合规和公开地图展示要求即可;一般不属于 FormCreate、积木报表这类“商业组件源码授权”问题,也通常无需额外担心第三方组件版权交付问题。

如果客户选择高德地图、腾讯位置服务、Cesium ion 或其他商用 GIS / 地图数据服务,则需要根据实际使用的底图、数据服务、调用量、离线部署、私有化、商业大屏展示等场景,自行确认 Key、域名白名单、服务额度、费用和授权范围。

如系统对外展示地图、发布带地图图形产品或涉及测绘地理信息内容,应遵守《地图管理条例》及公开地图内容表示规范等要求;涉及客户自有地理数据、涉密数据或内网部署时,应单独评估合规与安全边界。

2.4 AI 模型 API Key:默认 Key 仅供体验

项目说明
当前配置后端 AI 配置中预留 OpenAI 兼容、DeepSeek、通义千问、文心一言、Gemini、豆包、腾讯混元、硅基流动等模型服务配置;默认可通过 CYAPI_API_KEYCYAPI_BASE_URL 等环境变量覆盖
集成位置AI 对话、AI 写作、AI 知识库、AI 绘图、AI 工作流、FormCreate 设计器 AI、企微智能回复等
使用功能大模型对话、流式输出、知识库问答、表单规则生成、文本生成、图片生成、业务助手等
使用建议默认 Key 只用于演示体验;生产环境请客户自行购买并配置模型服务商 Key

为了降低试用门槛,RuoYi Office 当前可提供一个默认 AI API Key,便于客户在本地部署或演示环境中快速体验 AI 对话、AI 写作、FormCreate 设计器 AI 等能力。但该默认 Key 每天有调用额度限制,不承诺长期可用性、稳定性、并发能力和生产 SLA,仅适合体验和演示。

正式上线、客户生产环境、SaaS 环境或涉及企业真实数据 / 敏感数据时,请客户自行向模型服务商购买或开通账号,并在部署环境中替换为自己的 API Key、Base URL、模型名称和计费配置。不同模型厂商(OpenAI、DeepSeek、通义千问、文心一言、豆包、腾讯混元、Gemini、硅基流动等)的资费、额度、数据合规、内容安全和可用区域不同,请以各厂商官方规则为准。

2.5 ONLYOFFICE Document Server(合同高保真在线编辑)

项目说明
当前依赖Docker 镜像 onlyoffice/documentserver(社区版,当前参考版本 8.2);不包含在 RuoYi Office 商业版交付物中
集成位置合同模块(yudao-module-contract)、PC 管理端 onlyoffice-editor 组件、合同模版 / 正文在线编辑
使用功能Word(docx)高保真在线预览与编辑、原样导出、自动保存回调;未部署时自动降级为 TinyMCE / vue-office 等预览方案
官方链接ONLYOFFICE 版本对比与授权License FAQGitHub DocumentServer

RuoYi Office 在合同管理等模块中预留了 ONLYOFFICE Document Server 对接能力(JWT 签名、文档下载、保存回调等),用于实现 docx 高保真在线编辑。该能力为可选功能,默认配置 yudao.onlyoffice.enabled: false;未部署文档服务器时不影响系统其他功能。

交付边界(重要)

  • RuoYi Office 商业版交付的是集成代码、配置项与部署参考文档不包含 ONLYOFFICE Document Server 服务端程序、Docker 镜像分发或商业授权。
  • RuoYi Office 官方演示环境可能自行部署 ONLYOFFICE 社区版供在线体验,不等同于向客户授予 ONLYOFFICE 生产使用授权
  • 客户若需启用高保真 Word 编辑,应自行在自有服务器上通过 Docker 等方式部署 Document Server,并自行承担第三方许可合规责任。
  • 仓库中的 ruoyi-office/script/docker/docker-compose.onlyoffice.yml 仅作为参考部署模板,供客户自行评估与实施。

社区版(AGPL v3)使用场景说明

ONLYOFFICE Document Server 社区版采用 GNU Affero General Public License v3(AGPL-3.0)。根据 ONLYOFFICE 官方 License FAQ:

使用场景一般建议
企业私有化部署,仅供本企业员工内部编辑合同 / 文档通常可按社区版自行部署使用
商业组织将社区版用于自身业务目的(内网或外网服务器)官方说明可在无额外限制下使用
将集成 ONLYOFFICE 的能力作为 SaaS / 多租户云服务 对外提供给第三方用户不适合仅使用社区版;应购买 Developer / Enterprise 商业授权,或按 AGPL 要求开放相应源代码
需要去除 ONLYOFFICE Logo、白标、集群、官方技术支持应联系 ONLYOFFICE 官方购买商业版或洽谈 co-branding

若客户将 ONLYOFFICE 源代码集成进自有应用或网站并对外提供网络访问,AGPL 第 13 条可能要求向远程用户提供对应源代码。RuoYi Office 集成层本身为 MIT 许可,不能替代客户对 ONLYOFFICE Document Server 的许可义务。

社区版 / 开源版使用注意事项

  1. 不要修改或去除 ONLYOFFICE 本体版权与品牌标识
    社区版适合按官方镜像 / 官方源码原样部署并通过公开 API 集成。不要自行修改 Document Server 前端、SDKJS、Logo、版权提示、授权限制或品牌标识;如需要白标、去 Logo、co-branding、官方技术支持、集群或企业级功能,应向 ONLYOFFICE 官方购买商业授权。

  2. 不要把 ONLYOFFICE 描述为 RuoYi Office 自研编辑器
    对外宣传建议使用“支持对接 ONLYOFFICE Docs / Document Server”“可自行部署 ONLYOFFICE 社区版或商业版”等表述;避免使用“内置自研 Office 编辑器”“永久免费无限并发在线 Office”“RuoYi Office 授权已包含 ONLYOFFICE 商业授权”等容易造成授权误解的描述。

  3. 不要将社区版服务端作为 RuoYi Office 商业交付物打包授权
    RuoYi Office 源码授权只覆盖 RuoYi Office 自身代码。ONLYOFFICE Document Server 是独立第三方软件,客户应自行下载、部署、升级和承担许可义务。若项目交付中需要随包提供镜像、安装包或修改版源码,应同时附带 ONLYOFFICE 对应许可证、版权声明、源码获取方式和版本信息,并由客户确认是否满足其使用场景。

  4. 不要修改 ONLYOFFICE 源码后闭源使用
    如果客户或实施方修改了 Document Server 源码、前端资源、插件、构建产物或镜像内部文件,并通过网络向用户提供服务,可能触发 AGPL 网络服务源码提供义务。简单 API 调用和外部服务对接通常风险较低;修改 ONLYOFFICE 本体则需要单独做开源合规评估。

  5. 并发连接与版本限制需按官方当前版本确认
    RuoYi Office 当前参考部署使用 onlyoffice/documentserver:8.2。该类 8.x / 早期 9.x 社区版通常按“同时打开的编辑器连接”计数,常见上限约为 20 个 simultaneous connections:例如 20 个用户各打开 1 个编辑标签页、或 1 个用户打开 20 个文档标签页,都可能计为 20 个连接。只读预览、实时查看、移动端编辑、协同编辑等是否计入或是否受限,以 ONLYOFFICE 对应版本官方说明和实际部署表现为准。若后续升级到更新社区版(例如官方已调整连接限制的版本),也应重新核对许可证、版本说明和生产性能。

  6. 社区版不等于无限生产能力
    即使授权允许使用,实际生产仍受服务器 CPU、内存、文档大小、并发编辑人数、网络链路、文件存储、回调稳定性影响。合同模板 / 正文编辑属于高内存、高 I/O 场景,建议生产环境预留独立服务器、开启 JWT、使用 HTTPS、配置日志与缓存清理,并对大文档、多人协作和高峰并发做压测。

  7. 客户自部署时应保留第三方合规材料
    建议客户在部署文档或验收材料中记录 ONLYOFFICE 版本、镜像来源、许可证链接、部署域名、JWT 配置、源码获取地址和运维责任人,便于后续审计、升级和安全响应。

生产环境建议

  1. 企业内网私有化项目:客户可自行部署社区版,并在 application.yaml 中配置 server-urljwt-secretcallback-base-url 与文档服务器保持一致。
  2. 对外 SaaS、多租户或白标交付:建议客户采购 ONLYOFFICE Docs Developer Edition 或 Enterprise Edition,勿默认依赖社区版。
  3. 保留品牌标识:使用社区版时不得擅自移除或替换 ONLYOFFICE 产品 Logo;白标需求请联系 ONLYOFFICE 销售。
  4. 性能与规模:若使用 8.2 等存在连接限制的社区版,建议按约 20 个同时编辑连接规划;更大规模生产场景应评估新版社区版、商业版或集群方案,并以 ONLYOFFICE 官方最新说明为准。
  5. 安全配置:生产环境不要沿用示例 jwt-secret,应通过环境变量配置强随机密钥,并确保 Document Server、后端、文件服务之间的下载与回调链路只暴露必要入口。

三、前端基础框架与页面组件

依赖 / 插件当前版本使用功能说明
Vue^3.5.32(PC)、^3.4.21(UniApp)前端基础框架PC 管理端、移动端、GoView 均基于 Vue 3 技术栈
Vite^8.0.8(PC)、5.2.8(UniApp)、4.3.6(GoView)前端构建工具版本以各子工程依赖为准
Vue Vben Admin5.7.0PC 管理端基础框架RuoYi Office PC 端基于 Vben Admin 5 与 Ant Design Vue 适配开发
Ant Design Vue^4.2.6PC 管理端 UI 组件库表单、弹窗、按钮、布局、选择器等基础 UI
VxeTable / Vxe UIvxe-table ^4.18.11vxe-pc-ui ^4.13.21企业级表格列表页、明细表、可编辑表格、复杂数据表格
Naive UI^2.44.1(PC 依赖池)、2.34.3(GoView)备用 UI / GoView UIPC 多 UI 适配依赖池及 GoView 大屏工程使用
Element Plus / TDesign^2.13.7 / ^1.19.0多 UI 适配依赖池主要来自 Vben 多 UI 模板能力,当前主应用以 Ant Design Vue 为主
ECharts^6.0.0(PC)、^5.3.2(GoView)图表可视化首页、统计分析、报表、大屏图表等
VChart^1.12.3可视化图表GoView 大屏工程的图表扩展能力
TinyMCEtinymce ^7.3.0@tinymce/tinymce-vue ^6.3.0富文本编辑器通知公告、内容管理、富文本字段等
Vue Office@vue-office/docx ^1.6.3@vue-office/excel ^1.7.14@vue-office/pdf ^2.0.10在线文档预览Word、Excel、PDF 等文件预览能力
ONLYOFFICE 前端 SDK动态加载 Document Server api.js合同 docx 高保真编辑依赖客户自部署的 Document Server;服务端 AGPL,详见本文 2.5
bpmn-js^17.11.1BPMN 流程设计器流程模型设计、节点属性配置、令牌模拟等
bpmn-js-properties-panel5.23.0流程属性面板BPMN 节点、表单、监听器、审批人等扩展配置
bpmn-js-token-simulation^0.36.3流程模拟流程设计阶段的路径和令牌模拟
Markmapmarkmap-lib ^0.16.1思维导图AI 思维导图或 Markdown 思维导图渲染
Tiptap@tiptap/* ^3.22.3富文本编辑扩展当前依赖的开源核心和扩展通常按 MIT 使用;如后续引入 Tiptap Pro / Cloud 等收费能力需另行确认
DHTMLX Ganttdhtmlx-gantt ^9.1.3甘特图 / 项目排期官方标准版为 GPL,非 GPL 商业项目或 Pro 能力通常需购买商业授权;如启用项目甘特图能力需重点核查
TinyFlow@tinyflow-ai/vue ~1.1.10流程 / 节点编排 UI用于可视化流程、AI 工作流或节点编排类界面,按其官方协议使用
二维码 / 条码 / 签名 / 水印qrcode ^1.5.4jsbarcode ^3.12.1vue3-signature ^0.2.4watermark-js-plus ^1.6.3业务辅助组件用于单据二维码、条码、签名、页面水印等场景
Monaco Editor^0.33.0(GoView)在线代码编辑GoView 低代码配置、脚本或 JSON 编辑场景

四、移动端与小程序相关依赖

依赖 / 插件当前版本使用功能说明
UniApp / DCloud3.0.0-4070620250821001多端移动应用框架H5、App、微信小程序、支付宝小程序等多端构建
unibest4.1.0UniApp 工程模板移动端工程基础脚手架
wot-design-uni^1.13.0移动端 UI 组件库表单、列表、弹窗、日期选择、图标等移动端组件
z-paging2.8.7分页列表移动端滚动分页、下拉刷新、上拉加载
Pinia2.0.36状态管理登录态、用户信息、移动端业务状态
微信 / 支付宝等小程序平台由 UniApp 平台包提供小程序发布与平台 API需要客户自行配置各平台 AppID、证书、域名白名单和审核资料

五、后端框架、中间件与业务基础能力

依赖 / 插件当前版本使用功能说明
Spring Boot3.5.14后端基础框架单体和微服务模块的基础运行框架
Spring Cloud2025.0.1微服务体系Gateway、OpenFeign、负载均衡等微服务能力
Spring Cloud Alibaba2025.0.0.0Nacos 等生态注册配置中心等云原生扩展能力
MyBatis-Plus3.5.16ORM / CRUD数据访问、分页、条件构造、代码生成等
MyBatis-Plus-Join1.5.7联表查询复杂列表和统计查询场景
Druid1.2.28数据库连接池SQL 监控、连接池管理
Dynamic Datasource4.5.0多数据源主从、多数据源、租户 / 报表等扩展场景
Flowable7.2.0工作流引擎流程定义、流程实例、任务审批、监听器、历史数据等
Redisson4.3.1Redis 客户端分布式锁、缓存、限流、延迟队列等
Lock4j2.2.7分布式锁封装业务幂等和并发控制
XXL-Job2.4.0分布式任务调度定时任务、调度中心、执行器
RocketMQ Spring2.3.5消息队列异步通知、事件驱动等可选能力
Knife4j4.5.0、SpringDoc 2.8.17API 文档Swagger / OpenAPI 接口文档展示
MapStruct1.6.3Java Bean 转换DO、VO、DTO 对象转换
Lombok1.18.46Java 代码简化Getter、Setter、Builder 等
Hutool5.8.44 / 6.0.0-M22Java 工具库日期、集合、加密、文件、HTTP 等工具能力
FastExcel1.3.0Excel 导入导出后台导入导出、模板处理
Apache Tika3.3.0文件类型识别上传文件类型识别、文档处理辅助
OpenHTMLToPDF1.1.37HTML 转 PDF打印、导出、文档转换等扩展场景
Ip2Region2.7.0IP 归属地登录日志、访问日志、风控辅助
AJ-Captcha1.4.0行为验证码登录验证码、安全校验

六、文件、云服务、支付、社交与消息能力

依赖 / 服务当前版本使用功能商业使用注意
ONLYOFFICE Document Server客户自部署(参考 onlyoffice/documentserver合同 docx 高保真在线编辑不包含在商业版交付物中;社区版为 AGPL-3.0,企业内网自用通常可行,SaaS / 多租户对外服务需客户自购商业授权;详见本文 2.5
AWS S3 SDK2.44.0S3 协议对象存储可对接 MinIO、阿里云 OSS、腾讯云 COS、七牛云等兼容或类似对象存储;云厂商费用和授权由客户自行承担
MinIO / S3 兼容存储由部署环境决定文件上传、附件、企业云盘自建 MinIO 需自行维护备份、安全策略和访问域名
JustAuth1.16.7、starter 1.4.0第三方登录微信、企业微信、钉钉、GitHub 等社交登录接入需在对应平台申请应用
Alipay SDK4.40.771.ALL支付宝支付 / 转账需要客户自行申请支付宝商户、应用、证书和生产权限
WxJava4.8.2-20260501.180637微信支付、公众号、小程序需要客户自行申请微信商户号、公众号、小程序、证书和域名配置
短信 / 邮件服务由系统配置决定验证码、通知、流程提醒短信签名、模板、费用和发送资质由客户自行办理
AI 模型服务默认体验 Key + 客户自配 KeyAI 对话、写作、知识库、绘图、表单 AI 等默认 Key 每日额度有限,仅供体验;生产环境请客户自行购买 OpenAI、DeepSeek、通义、文心、豆包、混元等模型服务并配置 Key、额度和合规策略
MQTT / IoTMQTT 1.2.5、Vert.x 4.5.26、Californium 3.14.0、j2mod 3.3.0IoT 设备接入、MQTT、CoAP、Modbus 等设备协议、网关、证书、数据安全和现场实施需按项目评估

七、GoView 大屏与三维可视化依赖

依赖 / 插件当前版本使用功能说明
GoView2.1.6数据可视化低代码大屏独立子工程 ruoyi-office-ui-go-view,用于拖拽式大屏配置
ECharts / 扩展插件^5.3.2、liquidfill、wordcloud、stat图表、大屏组件折线、柱状、饼图、水球、词云、统计图等
Three.js^0.145.03D 渲染三维组件和动画扩展
Cesium1.99三维地球 / GIS三维地球、地形、影像、矢量图层等;Cesium ion 或商用数据服务需另行确认
高德地图 JSAPI Loader^1.0.1高德地图加载需要高德开放平台 Key 和对应服务授权
Xbsj XE2^0.1.16三维 GIS 扩展与 Cesium / OpenLayers / UE 等三维场景扩展相关
html2canvas^1.4.1页面截图大屏截图、组件截图等
vue3-sketch-ruler^1.3.3设计辅助标尺大屏设计器画布辅助

八、商业版用户建议

  1. 以交付版本为准:本文列出的版本来自当前仓库,客户实际交付版本可能因补丁、升级或定制存在差异。
  2. 第三方商业授权单独确认:FormCreate 商业版源码、积木报表商业版、ONLYOFFICE Document Server(SaaS 场景)、DHTMLX Gantt 商业授权、地图商业服务、云服务、支付、短信、AI 模型等通常不等同于 RuoYi Office 商业授权。
  3. 生产上线前做合规核查:特别是报表设计器、ONLYOFFICE 文档服务、地图、支付、短信、AI、第三方登录、文档预览和大屏对外展示场景;AI 默认 Key 仅供体验,生产环境必须替换为客户自己的 Key;ONLYOFFICE 服务端由客户自行部署并确认 AGPL / 商业授权边界。
  4. 保留必要版权标识:凡第三方官方要求保留版权、Logo、链接或声明的,应按其要求保留。
  5. 避免同类竞争包装:不得将第三方组件单独拆出、包装成与其同类竞争的产品进行发布或销售。
  6. 关注安全配置:报表设计器、文件预览、富文本、在线脚本、大屏数据源、AI Key 等能力上线前应配置权限、白名单、脱敏和审计。

如客户需要确认某个第三方依赖是否可商用、是否需要额外付费、是否可以用于第三方客户项目,请以该第三方官方最新授权协议、价格页或书面授权为准。

联系我们

获取报价、演示和二开方案

微信咨询二维码

微信咨询

17156169080

添加时备注「RuoYi Office」

在线体验商业版