中国 帮助

部署

本页是「部署」这一章的入口,只回答一件事:把 Wujies 无界平台装到一台服务器上,要装哪几个包、按什么顺序、装完必须做什么。 当前的交付方式是 1Panel 应用包 + docker compose + 外部中间件。平台自己只提供两个

部署
封面

> 本文整理自平台文档 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} → 80nginx:托管前端 dist、反代 /prod-api/ 到后端、按 /remote-apps/ 提供远程应用产物
backend${CONTAINER_NAME}-backend8080;官方版额外对公映射 ${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)

章节导览
THE END

喜欢就支持以下吧

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

回到内容