中国 帮助

环境要求

这一页回答一个问题:在动手之前,机器上该有什么、路径该是什么。 它只列可以核对的既有事实,每条都给出源码或配置文件的位置;凡是我没有实际跑过验证的, 都会写明「未验证」。把它过一遍,[15 分钟跑起来](/docs/wujies/1.x/

环境要求
封面

> 本文整理自平台文档 docs/wujies/1.x/guide/prerequisites.mdx,用于站点内容演示。

(https://console.wujies.cn/remote-apps/cms-assets/doc-2e3cdc3ebadb-cover.svg)

这一页回答一个问题:在动手之前,机器上该有什么、路径该是什么。

它只列可以核对的既有事实,每条都给出源码或配置文件的位置;凡是我没有实际跑过验证的, 都会写明「未验证」。把它过一遍,[15 分钟跑起来](/docs/wujies/1.x/guide/quickstart) 里的命令才有可能一次跑通。

名词定义见 [核心概念](/docs/wujies/1.x/guide/concepts);这套结构为什么长这样见 [这个项目是什么](/docs/wujies/1.x/guide/introduction)。

一、先认清三个目录

后面所有路径都建立在这三行上:

目录是什么构建方式
wujies-platform/后端宿主、平台初始化 SQL、部署物料Maven(Java 17)
plus-ui/宿主前端npm
wujies/wujies-plugins/插件本体 + 插件前端工程Maven + pnpm workspace

三者没有共同的 git 根,各自分支、各自提交。改一个功能经常要两边都动。

这个名字在三处含义不同,历史上已经误导过两次排查。判据很简单:看有没有 pom.xml。

写法实际指判据
wujies-platform/wujies-admin/后端启动模块有 pom.xml、src/main;产物是 wujies-admin.jar
工作区顶层的 wujies-admin/前端产物的落位目录里面只有 app-market-dist/,没有 package.json、没有 src/
plus-ui/宿主前端仓库有 vite.config.ts、src/;它的 package.json 里 name 恰好就是 wujies-admin

所以:凡是指向 src/views/、src/plugins/、app-market-dist/ 的,都是前端 = plus-ui/; 凡是指向 src/main/resources/、wujies-admin.jar、-pl wujies-admin 的,都是后端。

二、工具链

项要求依据
JDK17 或更高根 wujies-platform/pom.xml 的 <java.version>17</java.version> 被 maven-compiler-plugin 用作 <release>;插件仓 wujies-plugins/pom.xml 同为 17;部署镜像也是 JDK 17
Maven本机安装(版本下限仓库未约束,未验证)仓库里没有 Maven Wrapper(.mvn/、mvnw、mvnw.cmd 都不存在,已核对)。wujies-platform/AGENTS.md §0 给的是"本机没加 PATH 时"的两行写法
Node.js20 或更高wujies/wujies-plugins/package.json 的 engines.node = >=20;plus-ui/package.json 是 >=18.18.0 —— 取更严的那个
pnpm与 wujies-plugins/package.json 的 packageManager 一致(当前 pnpm@10.32.1)插件仓是 pnpm workspace(pnpm-workspace.yaml 只收 frontend/*-app)
npm用于 plus-ui/(该仓库走 package-lock.json,不是 pnpm)plus-ui/package.json 的 engines.npm = >=8.9.0

插件对平台构件(cn.wujies:*:${platform.version})的依赖全是 provided —— 运行期由宿主提供, 但编译期仍要能解析到。所以第一次上手必须先在平台仓装一遍:

mvn -B install -DskipTests     # 工作目录:wujies-platform/

wujies-plugins/pom.xml 的 <platform.version> 当前是 5.6.2,与平台根 pom 的 <revision> 一致; 平台升版时改的就是这一行。

### 关键依赖版本(来自 wujies-platform/pom.xml)

依赖版本
Spring Boot3.5.15
MyBatis-Plus3.5.16
Sa-Token1.45.0
Redisson3.52.0
dynamic-datasource4.3.1
SnailJob1.10.0
warm-flow(工作流)1.8.5
springdoc2.8.17
FastExcel1.3.0
Hutool5.8.43

Web 容器是 Undertow:wujies-common-web/pom.xml 排除了 spring-boot-starter-tomcat, 改引 spring-boot-starter-undertow。

### 宿主前端(plus-ui/)关键版本

依赖版本
Vue3.5.13
Vite6.3.2
Vue Router4.5.0
Pinia3.0.2
Element Plus^2.11.8
TypeScript~5.8.3
UnoCSS66.5.2
Vitest3.1.2

目标浏览器见 plus-ui/package.json 的 browserslist:Chrome ≥ 87 / Edge ≥ 88 / Safari ≥ 14 / Firefox ≥ 78。

三、中间件

中间件要求依据
MySQL8.0 以上;不支持 MariaDB平台初始化 SQL 通篇 utf8mb4_0900_ai_ci,MariaDB 没有这个排序规则(见 wujies-platform/docs/1panel/1Panel部署与上架.md)。驱动是 com.mysql.cj.jdbc.Driver;只装了 mysql-connector-j,其它数据库的驱动在 wujies-admin/pom.xml 里是注释掉的
Redis客户端是 Redisson 3.52.0;最低版本仓库未约束(未验证)application-dev.yml 的 spring.data.redis 段
RabbitMQ平台消息 / 延时队列用到application-dev.yml 的 spring.rabbitmq 段。哪些功能强依赖它,我没有逐个验证(未验证)
SnailJob 调度中心可选。它是一个独立服务 + 自己的库表与账号在 wujies-platform/script/sql/ry_job.sql;宿主侧开关是 snail-job.enabled

插件仓里有一个 sandbox 模块(wujies-plugins/pom.xml 的 <module>sandbox</module>, 注释写明"开发工具,不进任何应用包"):它用 H2 内存库替代 MySQL,不装配 Redis / RabbitMQ, 端口 18080(sandbox/src/main/resources/application.yml)。 用法见 [本地联调](/docs/wujies/1.x/plugin-dev/backend/local-dev);沙箱的具体行为我没有实测(未验证)。

四、端口

端口用途出处
8086后端宿主(server.port,context-path 为 /)wujies-admin/src/main/resources/application.yml
80宿主前端 dev server(VITE_APP_PORT)plus-ui/.env.development,由 plus-ui/vite.config.ts 读取
9090监控中心(spring.boot.admin.client.url);dev profile 里 enabled: falseapplication-dev.yml
17888SnailJob 调度中心服务端端口application-dev.yml 的 `snail-jo

本文导览

(https://console.wujies.cn/remote-apps/cms-assets/doc-2e3cdc3ebadb-guide.svg)

章节导览
THE END

喜欢就支持以下吧

评论区需要浏览器启用 JavaScript 才能加载。

回到内容