> 本文整理自平台文档 docs/wujies/5.x/deploy/ops/index.mdx,用于站点内容演示。
(https://console.wujies.cn/remote-apps/cms-assets/doc-32ee74a8f8eb-cover.svg)
本页面向已经跑起来的一套部署。当前的交付形态是 1Panel 应用包 + docker compose + 外部中间件,所以要运维的不是「一个 jar 进程」,而是「一个实例目录 + 两三个容器 + 一堆不在包里的服务」。本页只回答四件事:东西在宿主机的哪里、日志怎么看、每天该盯哪几项、哪些行为是设计如此。
| 你要解决的问题 | 去哪一页 |
|---|---|
| 还没装 / 要重装 / 安装表单怎么填 | [部署总览](/docs/wujies/5.x/deploy/) |
| 装不上、起不来、按症状查原因 | [故障排查](/docs/wujies/5.x/deploy/ops/troubleshooting) |
| 这次安装/升级/卸载做了什么、卡在哪一步 | [任务中心与日志](/docs/wujies/5.x/deploy/ops/task-center) |
| 升级平台、升级应用、存量库补脚本 | [升级与补丁](/docs/wujies/5.x/deploy/upgrade) |
| 备什么、密钥纪律、上线前脱敏 | [备份与安全](/docs/wujies/5.x/deploy/ops/backup-security) |
| 运行期怎么盯、怎么重启、怎么清 | 本页 |
1. 应用生命周期的问题先看任务中心(「我的应用 → 应用任务」):步骤与日志是边跑边落库的,比翻服务端日志快。 2. 不要 DROP DATABASE。 安装表单建的库只授了库级权限(SHOW GRANTS 只有一行 GRANT ALL PRIVILEGES ON ...),应用账号没有全局 CREATE,库删了就建不回来。要重来请清空表,做法见 [升级与补丁](/docs/wujies/5.x/deploy/upgrade)。 3. 应用装的菜单受保护:path / component / perms / menuType / parentId 的修改与删除都会被服务端拒绝(只放行名称 / 图标 / 排序 / 显隐)。想隐藏某个应用,用「停用」,不要删菜单。原理见 [菜单归属与保护](/docs/wujies/5.x/platform/app-market/menu-ownership)。
---
一、这台部署由什么组成
主包只有两个容器,定义在 deploy/1panel/apps/wujies-platform-server/5.6.2/docker-compose.yml:
| compose 服务 | 容器名 | 端口 | 做什么 |
|---|---|---|---|
frontend | ${CONTAINER_NAME}(= 1Panel 实例名,属主服务) | ${PANEL_APP_PORT_HTTP} → 80 | nginx:1.27-alpine:托管前端 dist、反代 /prod-api/ 到后端、按 /remote-apps/ 提供远程应用产物、/minio/ 反代对象存储、/upload/ 提供本地存储 |
backend | ${CONTAINER_NAME}-backend | 容器内 8080;另映射 ${PANEL_APP_PORT_API}(默认 18080) | 后端 jar(镜像内 /app/app.jar)。启动前先解析中间件地址,首次启动自己建库建表 |
两个服务都是 restart: always。后端端口只留给内网 / 反代 / Actuator,浏览器请求一律经前端的 nginx。
中间件一个都不在包里,每个都在安装表单里「选面板已装的服务」或「填外部地址」:
| 依赖 | 必填? | 怎么给 | 不给会怎样 |
|---|---|---|---|
| MySQL 8.x | 必填 | 「数据库服务」下拉选面板里的 MySQL(面板自动建库 + 授权),或填 5 个「外部」字段 | 容器启动失败:[entry] !! 没有数据库地址 |
| Redis | 必填 | 「Redis 服务」,或外部字段 | 容器启动失败:[entry] !! 没有 Redis 地址 |
| RabbitMQ | 选填 | 服务 / 外部字段 | 应用照常启动,只有「消息中心 / 站内信」不可用(入口脚本会明确写出来) |
| 对象存储 | 不用填 | 装完在「系统工具 → 系统配置 → 文件存储配置」里启用一种 | 默认所有配置都是停用状态 → 上传应用包、图片会失败 |
调度中心(独立包 wujies-snailjob-server) | 选填 | 「调度中心地址」填 snailjob-server(该包的固定网络别名) | 留空 = 不启用:订单自动取消 / 自动收货、优惠券状态与过期、促销启停、统计刷新、会员积分过期等任务都不跑 |
监控中心(独立包 wujies-monitor-admin) | 选填 | 「监控中心地址」填 http://monitor-admin:9090/admin | 留空 = 不注册,功能本身不受影响 |
目录中心(独立部署的上架服务 wujies-market) | 选填 | 「目录中心地址」APP_MARKET_CATALOG_BASE_URL + 「目录中心令牌」APP_MARKET_CATALOG_TOKEN(要与中心配同一个值) | 留空 = 目录读本机库(本机只剩内置模块,app_info 为 0 行 → 应用市场是空的)。令牌没配对齐时带令牌的接口会 401 |
地址解析规则写在 deploy/docker/backend/entrypoint.sh 的 pick() 里:外部字段非空 → 用外部;否则用面板选的服务;都空 → fail() 并打印该填哪一栏。这条逻辑必须在 shell 里做,compose 与 Spring 都表达不了这种条件。后端镜像里额外装了 default-mysql-client(deploy/docker/backend/Dockerfile),首次初始化就是用它连库。
entrypoint.sh 最后一行只传了 -Dapp-market.deploy.plugin-dir,没有 -Dloader.path —— 插件由运行期加载器 PluginRuntimeManager 在启动期 + 运行期加载,所以「装应用 / 升应用不需要重启 JVM」在这条路线上成立。-Dloader.path 只存在于 jar 直跑那条路线(手敲 java "-Dloader.path=plugins-dist" ...,见 [/deploy/backend](/docs/wujies/5.x/deploy/backend) 的「路线一」;原来的 script/prune/start-host.ps1 已删除)。两套机制的差别见 [插件运行时](/docs/wujies/5.x/platform/architecture/plugin-runtime)。
---
二、宿主机上的东西在哪
实例目录在面板的「应用商店 → 已安装 → 该实例」里能看到实际路径(1Panel 把它放在自己的应用目录下,形如 <面板目录>/apps/local/wujies-platform-server/<实例名>,<实例名> 就是面板显示的名字;下文一律记作 <实例目录>)。安装表单的值写在实例目录的 .env 里,docker-compose.yml、data/、sql/ 也都在这一层 —— 下文所有 docker compose 命令都要先 cd 到这里。
| 宿主(相对实例目录) | 容器内 | 内容 |
|---|---|---|
./data/plugins-dist | /app/plugins-dist | 插件 jar 落位目录(= app-market.deploy.plugin-dir)+ active-plugins.txt |
./data/plugins-dist/migrations/<appCode>/ | /app/plugins-dist/migrations/<appCode>/ | 应用包里的迁移脚本(由后端读取执行);落位前会先清空该目录 |
./data/remote-apps | /app/remote-apps(后端读写)、/var/www/remote-apps:ro(nginx 只读) | 远程应用前端产物(= app-market.deploy.frontend-dir) |
./data/logs | /app/logs | 四个日志文件,见下一节 |
./data/upload | /app/upload | 本地文件存储(sys_oss_config 选 local 时用) |
./data/temp | /app/temp | 上传临时目录(compose 里 SPRING_SERVLET_MULTIPART_LOCATION=/app/temp) |
./sql | /app/sql:ro | 初始化 SQL 的 files/*.sql(后端首次启动时导入) |
落位产物分三处放(AppPackageDeployService):
- 后端插件 jar →
./data/plugins-dist/根下,同目录的active-plugins.txt记
本文导览
(https://console.wujies.cn/remote-apps/cms-assets/doc-32ee74a8f8eb-guide.svg)


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