> 本文整理自平台文档 docs/wujies/1.x/deploy/index.mdx,用于站点内容演示。
(https://console.wujies.cn/remote-apps/cms-assets/doc-d42da37ad9dd-cover.svg)
本页是「部署」这一章的入口,只回答一件事:把 Wujies 无界平台装到一台服务器上,要装哪几个包、按什么顺序、装完必须做什么。
当前的交付方式是 1Panel 应用包 + docker compose + 外部中间件。平台自己只提供两个容器(前端 nginx + 后端),MySQL / Redis / RabbitMQ 不在包内、也不打进镜像 —— 它们在安装表单里「从 1Panel 应用商店选一个已装的服务」或「填你自己的外部实例地址」。jar 直跑只用于开发验证与排障(入口是 script/prune/start-host.ps1),交付与生产走 1Panel 包。
| 平台包(本页) | 业务应用包 | |
|---|---|---|
| 是什么 | 把平台装成 1Panel 本地应用(前端 nginx + 后端 jar) | 应用市场里的应用:mall / gallery / im / member / pay … |
| 谁产出 | wujies-platform/deploy/tools/build-1panel.ps1 | 发布方 wujies/wujies-plugins/package.ps1 |
| 产物 | deploy/dist/1panel/wujies-platform-1panel-5.6.3.tar.gz | <code>-<version>.zip(含 signature.txt) |
| 装在哪 | 1Panel → 应用商店 → 本地应用 | 平台内「应用上架」上传,再在「应用市场」安装 |
两者通过应用目录衔接:业务应用包上架并发布后,目录里才有它的版本,市场里才有东西可装。 这条链路的起点是 [打包与上架](/docs/wujies/1.x/package/)。
交付产物:四个 1Panel 应用包
| 包 | 是什么 | 什么时候装 |
|---|---|---|
wujies-platform-server | 官方版:目录在自己的库里(catalog.mode=local)、含上架端、对外提供 /app/catalog/** | 单机自用;或多部署里那台「目录服务」 |
wujies-platform-client | 用户版:没有上架端,目录从官方版读(catalog.mode=remote,写死) | 交付给客户,且已经有一台官方版在跑 |
wujies-snailjob-server | 定时任务调度中心(SnailJob 服务端 + 控制台 /snail-job) | 要跑定时任务:订单自动取消 / 自动收货、优惠券状态与过期、促销启停、统计刷新、积分过期 |
wujies-monitor-admin | 服务监控中心(Spring Boot Admin,/admin) | 想在线看健康、JVM、日志级别、配置 |
后两个是独立的应用包,各有自己的容器与(调度中心还有)自己的数据库。主包安装表单里填上它们的地址即启用,留空就不启用。当前端在同一个 1panel-network 上时,地址固定填 snailjob-server 与 http://monitor-admin:9090/admin(两个包各带一个固定网络别名,不用去查面板随机生成的容器名)。
官方版与用户版是同一个 jar 靠配置扮演两个角色,不是两个 fork —— 差别只在目录从哪读、上架端开不开。选型与目录集中见 [多部署与目录服务](/docs/wujies/1.x/deploy/multi-deployment)。
主包里有什么
主包只有两个容器:
| 服务 | 容器名 | 端口 | 说明 |
|---|---|---|---|
frontend(主服务) | ${CONTAINER_NAME} | ${PANEL_APP_PORT_HTTP} → 80 | nginx:托管前端 dist、反代 /prod-api/ 到后端、按 /remote-apps/ 提供远程应用产物 |
backend | ${CONTAINER_NAME}-backend | 8080;官方版额外对公映射 ${PANEL_APP_PORT_API} | 后端 jar,启动前先解析中间件地址、首次启动初始化数据库 |
中间件一个都不在包里。每个中间件在安装表单里都是两条路,解析规则是「外部字段非空 → 用外部;否则用面板选的服务;都空 → 容器启动失败并打印原因」,这段逻辑写在 deploy/docker/backend/entrypoint.sh 里(compose 与 Spring 都表达不了这种条件)。
后端容器里有两个卷必须记住,它们把「后端写产物」和「nginx 读产物」连起来:
| 宿主(相对应用目录) | 容器内 | 谁在用 |
|---|---|---|
./data/plugins-dist | /app/plugins-dist | 插件 jar 落位目录 = app-market.deploy.plugin-dir,运行期由插件运行时加载 |
./data/remote-apps | /app/remote-apps(后端读写)、/var/www/remote-apps:ro(nginx 只读) | 远程应用前端产物 = app-market.deploy.frontend-dir |
这两行挂的不是同一个宿主目录,表现就是「安装成功、菜单也在,点进去 404」。完整卷表与配置项见 [后端部署](/docs/wujies/1.x/deploy/backend) 与 [前端部署与 Nginx](/docs/wujies/1.x/deploy/frontend)。
部署要走完的六步
### ① 打包(开发机 / CI)
# 全量:前端 vite build --mode docker + 后端 mvn install + 组装 + 打 tar.gz
powershell -ExecutionPolicy Bypass -File wujies-platform\deploy\tools\build-1panel.ps1
# 只改了后端 Java
powershell -ExecutionPolicy Bypass -File wujies-platform\deploy\tools\build-1panel.ps1 -SkipFrontend
# 只改了 SQL / data.yml / compose(最常用,几十秒,不用重建镜像)
powershell -ExecutionPolicy Bypass -File wujies-platform\deploy\tools\build-1panel.ps1 -SkipFrontend -SkipBackend
前提是 Node 22+、JDK 17($env:JAVA_HOME)、Maven。产出在 deploy/dist/1panel/:apps/(四个包)、docker/(四个镜像构建上下文)、wujies-platform-1panel-5.6.3.tar.gz(上传到服务器的那一个文件)。
- ⚠️
build-1panel.ps1必须保持 UTF-8 with BOM:Windows PowerShell 5.1 对无 BOM 的脚本按 ANSI 解码,中文注释会连带吃掉下一行。 - 改版本号要同时动四处:脚本的
$Version、包内5.6.x/目录名、compose 里的镜像 tag、deploy/tools/gen-appstore-data.mjs的VERSION。 - 包里的初始化 SQL 是文件(
sql/files/,只读挂进容器),不是打进镜像的;只有 jar 与前端dist/需要重建镜像。
### ② 构建镜像(有 Docker 的那台机器)
1Panel 本地应用只负责拉镜像,镜像要你自己构建:
cd /root/pkg/docker/backend && docker build -t wujies-platform/backend:5.6.3 .
cd ../frontend && docker build -t wujies-platform/frontend:5.6.3 .
# 只有装了可加装的两个包才需要下面两个
cd ../snailjob && docker build -t wujies-platform/snailjob-server:5.6.3 .
cd ../monitor && docker build -t wujies-platform/monitor-admin:5.6.3 .
- 面板安装时总会先
docker pull一遍。日志出现拉取镜像 失败 … denied紧跟着「镜像已存在,使用存量镜像」不是错误(wujies-platform/*会被解析成 Docker Hub 上的同名命名空间);想省掉那一分钟左右,在安装抽屉的「高级」里取消勾选「拉取镜像」。 - 多机部署 / 上架官方商店必须让拉取能成功:把镜像 tag 到你自己的仓库并推到可公开拉取的地方,同时把包内 compose 的
image:一起换掉。私有仓库还要先在面板「容器 → 仓库」里加凭据。
### ③ 传进面板
`
本文导览
(https://console.wujies.cn/remote-apps/cms-assets/doc-d42da37ad9dd-guide.svg)


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