> 本文整理自平台文档 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,宿主一旦从上一层目录启动,它就正好解析到这个空目录,落位照常报"成功",前端却取不到产物。下一节讲怎么确认。
二、工具链
| 项 | 要求 | 依据 |
|---|---|---|
| JDK | 17 或更高 | wujies-platform/pom.xml 的 <java.version>17</java.version>,被编译插件用作 <release>;各应用仓库继承 wujies-plugins-parent,同为 17 |
| Maven | 版本仓库未约束(未验证) | 仓库里没有 Maven Wrapper(.mvn/、mvnw 都不存在),只能用本机 mvn |
| Node.js | 22 或更高 | 取最严的那个:打 1Panel 包要求 22+(deploy/tools/build-1panel.ps1),宿主前端 engines.node 是 >=18.18.0,各应用 frontend/ 是独立 npm 工程 |
| npm | 8.9+ | 宿主前端走 package-lock.json,不是 pnpm |
插件对平台构件的依赖全是 provided,运行期由宿主提供,所以本机第一次编插件前要先把平台构件装进本地仓库。宿主 JVM 正在跑的时候不要做这件事:覆盖 target/classes 会让运行中的实例报 NoClassDefFoundError,先停再起。
三、中间件
| 中间件 | 要求 | 依据 |
|---|---|---|
| MySQL | 8.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.port | wujies-admin/src/main/resources/application.yml |
| 80 | 宿主前端 dev server | .env.development 的 VITE_APP_PORT,由 vite.config.ts 读取 |
| 9090 | 监控中心;dev profile 里 enabled: false | application-dev.yml |
| 17888 | SnailJob 服务端 | application-dev.yml 的 snail-job.server.port |
| 28086 | SnailJob 客户端,写作 2${server.port},随主端口漂移 | application-dev.yml 的 snail-job.port |
| 3306 / 6379 / 5672 | MySQL / 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
| 宿主 cwd | frontend-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)


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