> 本文整理自平台文档 docs/wujies/1.x/deploy/backend.mdx,用于站点内容演示。
(https://console.wujies.cn/remote-apps/cms-assets/doc-2909ab3d9dd9-cover.svg)
本页只讲后端:wujies-admin.jar 怎么打出来、三种起法(主机直跑 / 手工 Docker / 1Panel 本地应用)各敲什么命令、首次启动的初始化 SQL 由谁跑、中间件地址从哪来。
运行期的机制不在这里重复:平台形态(官方版 / 用户版)与目录集中见 [/advanced/catalog-and-edition](/docs/wujies/1.x/advanced/catalog-and-edition),插件的加载与回收见 [/advanced/plugin-runtime](/docs/wujies/1.x/advanced/plugin-runtime),app-market: 配置项逐条说明见 [/deploy/configuration](/docs/wujies/1.x/deploy/configuration)。
先认清三个目录
三个仓库没有共同 git 根,各自分支、各自提交。本页所有命令都按这个布局写(平台的上游出处是 RuoYi-Vue-Plus,更名后的模块与路径一律以 wujies-* 为准):
| 仓库 | 目录 | 内容 |
|---|---|---|
| 后端 | wujies-platform/ | Java / Spring Boot + script/sql/ + deploy/ |
| 插件 | wujies/wujies-plugins/ | 插件本体 + 插件前端工程 + package.ps1 |
| 宿主前端 | plus-ui/ | Vue 3 / Vite —— ⚠️ 它的 package.json 里 name 写的是 wujies-admin,别被这个名字带偏 |
平台里没有 *-api 契约模块(2026-09-30 起为 0 个),也没有 wujies-job / wujies-demo / wujies-generator。每个业务应用都是自包含的:实体 / BO / VO / Mapper 接口与 Mapper XML / Service / controller / app.json / migrations/ 全在插件仓库的 wujies-<app>/ 下,平台对 cn.wujies.<app>.* 的 Java 引用为 0。所以在这里找不到 mall / gallery 之类的业务代码,这是设计如此 —— 不变量见 [/plugin-dev/basics/invariants](/docs/wujies/1.x/plugin-dev/basics/invariants)。
后端产物:一个可运行 jar
启动模块是 wujies-platform/wujies-admin/,产物固定为:
wujies-platform/wujies-admin/target/wujies-admin.jar
它的依赖链不含任何业务应用:插件 jar 与远程应用前端产物都是运行期由应用市场落位到磁盘的(见 [/advanced/lifecycle](/docs/wujies/1.x/advanced/lifecycle))。所以"部署后端"始终是"部署一个 jar + 给它两个可写目录"。
这两个目录必须记住 —— 在 application.yml 里是相对路径,相对启动时的工作目录:
| 配置项 | 默认值 | 容器内 |
|---|---|---|
app-market.deploy.plugin-dir | plugins-dist | /app/plugins-dist |
app-market.deploy.frontend-dir | ../wujies-admin/app-market-dist/remote-apps | /app/remote-apps |
⚠️ 这里的 wujies-admin 是工作区顶层那个只放 app-market-dist/ 的目录(前端产物的落位处),既不是后端模块 wujies-platform/wujies-admin/,也不是宿主前端仓库 plus-ui/——三处同名,按路径判断。
编译与打包
# 环境(本机没有把 JDK / Maven 加进 PATH 时)
$env:JAVA_HOME = "C:\Users\<you>\.jdks\corretto-23.0.2"
$mvn = "C:\Program Files\JetBrains\IntelliJ IDEA 2025.3.3\plugins\maven\lib\maven3\bin\mvn.cmd"
# 全量编译(根 pom 默认 skipTests=true,编译不会跑测试)
& $mvn -B -q compile -DskipTests
# 打可运行 jar —— 改了后端代码必须做这一步才能验证
& $mvn -pl wujies-admin -am -B install -DskipTests
install会把依赖装进本地仓库,运行中的 JVM 会锁住旧 jar:服务还跑着的时候执行它会中途失败(Windows 上尤其明显)。先停服务,或先只做compile。- 跑单模块测试要显式打开跳过开关并指定 profile:
& $mvn -pl wujies-modules/wujies-app-market -B test "-DskipTests=false" "-Dprofiles.active=dev"。
### profile 是构建期写进 jar 的,默认是 dev
application.yml 里的 spring.profiles.active: @profiles.active@ 是 Maven 过滤占位符(根 pom 对 application* 开了 filtering),构建时被替换。根 pom 有 local / dev / prod 三个 profile,其中 dev 是 activeByDefault:
| 构建命令 | jar 内写死的 profile |
|---|---|
mvn -pl wujies-admin -am install | dev |
mvn -pl wujies-admin -am install -Pprod | prod |
deploy/tools/build-1panel.ps1 走的是第一条(没有 -Pprod),容器里靠 compose 的 SPRING_PROFILES_ACTIVE: prod 覆盖(环境变量优先级高于 jar 内 yml)。直跑时没有这层覆盖,必须自己传 -Dspring.profiles.active=prod,否则起的是 dev 配置。
⚠️ application-prod.yml 里带着一整套开发验证阶段的连接信息(数据库、Redis、RabbitMQ 的地址与密码都写在文件里)。正式环境必须先按 [/deploy/index](/docs/wujies/1.x/deploy/) 的脱敏清单替换,或用环境变量覆盖。
路线一:主机直跑
工作目录必须是 wujies-platform/(上面两个目录是相对路径):
cd wujies-platform
java "-Dloader.path=plugins-dist" "-Dspring.profiles.active=prod" -jar wujies-admin\target\wujies-admin.jar
四个必须知道的点:
| 点 | 说明 |
|---|---|
-Dloader.path 的引号不能省 | PowerShell 会把 -Dloader.path=x 拆成 /path=x,报 ClassNotFoundException: /path=plugins-dist |
工作目录必须是 wujies-platform | plugin-dir 与 frontend-dir 都是相对路径;工作目录错了会把产物写到别处 |
| profile 必须显式传 | 见上一节:jar 内默认是 dev |
插件运行时开关只能走 -D | -Dapp-market.plugin-runtime.enabled=false 才能退回旧的共享类加载器行为;写进 yml 无效——启动器在 Spring 之前执行,读的是系统属性 |
-Dloader.path 只加载该目录根下的 jar,不递归子目录(所以迁移脚本的 migrations/ 子目录是安全的)。同一个 appCode 名下留着两个版本 jar 也不会再直接把服务打挂:2026-10-02 起启动器与插件运行时都按 active-plugins.txt 选版本,不在清单里的 jar 刻意不挂载;读不到或为空时不过滤,退回改造前的宽容行为。细节见 [/advanced/plugin-runtime](/docs/wujies/1.x/advanced/plugin-runtime)。
### 启动脚本:script/prune/start-host.ps1
推荐用它代替手敲 java:它先清理上一版插件 jar,再按正确的工作目录 / profile / loader.path 启动,jar 不存在时还会自动打包。


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