中国 帮助

环境要求

动手之前机器上该有什么、版本下限在哪、端口与工作目录的硬约束,逐条给可核对的位置。

环境要求
封面

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

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

这页只列可以核对的既有事实,每条给出源码或配置的位置;本机没实际验证过的都明写「未验证」。过完这页,[快速开始](/docs/wujies/5.x/introduction/quickstart) 里的命令才有一次跑通的可能。

名词与结构不在这解释,见 [核心概念](/docs/wujies/5.x/introduction/concepts) 与 [这个项目是什么](/docs/wujies/5.x/introduction/what-is-wujies)。

一、三个目录,和 wujies-admin 这个词的三种含义

目录是什么构建
wujies-platform/后端宿主、平台 SQL、部署物料Maven
wujies-admin/宿主前端(旧名 plus-ui)npm
plugins/wujies-<code>-plugin/应用本体,一个应用一个仓库(后端 + frontend/ + 打包脚本)Maven + npm

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

wujies-admin 这个名字有三处含义,判据是看里面有什么:

写法实际指判据
wujies-platform/wujies-admin/后端启动模块,产物 wujies-admin.jar有 pom.xml、src/main
wujies/wujies-admin/宿主前端仓库有 vite.config.ts、app-market-dist/;package.json 里的 name 恰好也叫 wujies-admin
工作区根的 wujies-admin/搬迁留下的空化石目录,不是 git 仓库只有空的 app-market-dist/remote-apps/

那第三个不只是碍眼:app-market.deploy.frontend-dir 是相对路径 ../wujies-admin/app-market-dist/remote-apps,宿主一旦从上一层目录启动,它就正好解析到这个空目录,落位照常报"成功",前端却取不到产物。下一节讲怎么确认。

二、工具链

项要求依据
JDK17 或更高wujies-platform/pom.xml 的 <java.version>17</java.version>,被编译插件用作 <release>;各应用仓库继承 wujies-plugins-parent,同为 17
Maven版本仓库未约束(未验证)仓库里没有 Maven Wrapper(.mvn/、mvnw 都不存在),只能用本机 mvn
Node.js22 或更高取最严的那个:打 1Panel 包要求 22+(deploy/tools/build-1panel.ps1),宿主前端 engines.node 是 >=18.18.0,各应用 frontend/ 是独立 npm 工程
npm8.9+宿主前端走 package-lock.json,不是 pnpm

插件对平台构件的依赖全是 provided,运行期由宿主提供,所以本机第一次编插件前要先把平台构件装进本地仓库。宿主 JVM 正在跑的时候不要做这件事:覆盖 target/classes 会让运行中的实例报 NoClassDefFoundError,先停再起。

三、中间件

中间件要求依据
MySQL8.0 以上,不支持 MariaDB导出库里的表用了 utf8mb4_0900_ai_ci,MariaDB 没有这个排序规则;驱动只有 com.mysql.cj.jdbc.Driver,其它数据库的驱动在 wujies-admin/pom.xml 里是注释掉的
Redis版本下限未约束(未验证)客户端是 Redisson,见 application-dev.yml 的 spring.data.redis
RabbitMQ消息与延时队列用到application-dev.yml 的 spring.rabbitmq。哪些功能强依赖它没有逐个验证(未验证)
SnailJob 调度中心可选,独立服务 + 自己的库表与账号在 script/sql/job.sql;宿主侧开关是 snail-job.enabled

application-dev.yml 里这三样的默认值全指 127.0.0.1(库名 wujies、用户 root、空口令),本机开发不用配环境变量。prod 那份用的是 ${WUJIES_DB_HOST} 一类没有默认值的占位,缺一个就直接 Could not resolve placeholder 起不来,这是刻意的,见 [部署与配置](/docs/wujies/5.x/deploy/configuration)。

四、端口

端口用途出处
8086后端宿主 server.portwujies-admin/src/main/resources/application.yml
80宿主前端 dev server.env.development 的 VITE_APP_PORT,由 vite.config.ts 读取
9090监控中心;dev profile 里 enabled: falseapplication-dev.yml
17888SnailJob 服务端application-dev.yml 的 snail-job.server.port
28086SnailJob 客户端,写作 2${server.port},随主端口漂移application-dev.yml 的 snail-job.port
3306 / 6379 / 5672MySQL / Redis / RabbitMQ 默认端口application-dev.yml 各段

dev 代理把 /dev-api 转到 http://127.0.0.1:8086 并去掉前缀;/site 也转过去,但 changeOrigin 必须是 false,改写 Host 会让后台直出的前台页把登录地址算到另一个 origin 上,而登录态按 origin 隔离。

容器里的后端端口是 8080,不是 8086:wujies-admin/Dockerfile 与 1Panel 的 compose 都写 ENV SERVER_PORT=8080,那个 8086 只来自本机 application.yml。

五、工作目录是唯一前提

产物落位的两个路径按进程工作目录解析,不是相对配置文件:

plugin-dir: plugins-dist
frontend-dir: ../wujies-admin/app-market-dist/remote-apps
宿主 cwdfrontend-dir 解析到dev server 读它吗
wujies/wujies-platform/wujies/wujies-admin/app-market-dist/remote-apps读
wujies/工作区根那个空化石目录不读

两条硬约束:plugin-dir 必须与 -Dloader.path 指向同一个目录,而加载器只认这个目录根下的 jar,不递归子目录(迁移脚本放在 migrations/ 子目录里正是靠这一点);frontend-dir 指向的物理目录必须就是宿主对外提供 /remote-apps/<appCode>/ 的那个目录。

启动日志会打两行 [deploy] plugin-dir / frontend-dir = <绝对路径>,目录不存在还多一条 WARN,这是最省事的确认方式;对不上时的现象是菜单点开「远程视图不可用」,控制台报 Failed to fetch dynamically imported module: /remote-apps/<code>/index.js。

开发态这个错位会被掩盖:dev server 优先读插件仓库自己的 frontend/dist,落位目录只是回落,所以"页面能打开"不代表落位是对的。想直接落进宿主目录,构建前端时给 WUJIES_FRONTEND_DIST;出包时想从别处取产物用 package.ps1 -FrontendDist <绝对路径>。两者别混在一次运行里:只设环境变量不传参数,打包器仍按 frontend/dist 取,zip 里是上一版的旧产物。

六、数据库初始化

script/sql/ 现在四样东西:

文件内容谁需要
`platform_i

本文导览

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

章节导览
THE END

喜欢就支持以下吧

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

回到内容