中国 帮助

运维手册

本页面向已经跑起来的一套部署。当前的交付形态是 1Panel 应用包 + docker compose + 外部中间件,所以要运维的不是「一个 jar 进程」,而是「一个实例目录 + 两三个容器 + 一堆不在包里的服务」。本页只回答四件事:

运维手册
封面

> 本文整理自平台文档 docs/wujies/1.x/ops/index.mdx,用于站点内容演示。

(https://console.wujies.cn/remote-apps/cms-assets/doc-ba788b0961a8-cover.svg)

本页面向已经跑起来的一套部署。当前的交付形态是 1Panel 应用包 + docker compose + 外部中间件,所以要运维的不是「一个 jar 进程」,而是「一个实例目录 + 两三个容器 + 一堆不在包里的服务」。本页只回答四件事:东西在宿主机的哪里、日志怎么看、每天该盯哪几项、哪些行为是设计如此。

你要解决的问题去哪一页
还没装 / 要重装 / 安装表单怎么填[部署总览](/docs/wujies/1.x/deploy/)
装不上、起不来、按症状查原因[故障排查](/docs/wujies/1.x/ops/troubleshooting)
这次安装/升级/卸载做了什么、卡在哪一步[任务中心与日志](/docs/wujies/1.x/ops/task-center)
升级平台、升级应用、存量库补脚本[升级与补丁](/docs/wujies/1.x/deploy/upgrade)
备什么、密钥纪律、上线前脱敏[备份与安全](/docs/wujies/1.x/ops/backup-security)
运行期怎么盯、怎么重启、怎么清本页

1. 应用生命周期的问题先看任务中心(「我的应用 → 应用任务」):步骤与日志是边跑边落库的,比翻服务端日志快。 2. 不要 DROP DATABASE。 安装表单建的库只授了库级权限(SHOW GRANTS 只有一行 GRANT ALL PRIVILEGES ON ...),应用账号没有全局 CREATE,库删了就建不回来。要重来请清空表,做法见 [升级与补丁](/docs/wujies/1.x/deploy/upgrade)。 3. 应用装的菜单受保护:path / component / perms / menuType / parentId 的修改与删除都会被服务端拒绝(只放行名称 / 图标 / 排序 / 显隐)。想隐藏某个应用,用「停用」,不要删菜单。原理见 [菜单归属与保护](/docs/wujies/1.x/advanced/menu-ownership)。

---

一、这台部署由什么组成

主包只有两个容器,定义在 deploy/1panel/apps/wujies-platform-server/5.6.3/docker-compose.yml(用户版是 wujies-platform-client/5.6.3/docker-compose.yml):

compose 服务容器名端口做什么
frontend${CONTAINER_NAME}(= 1Panel 实例名,属主服务)${PANEL_APP_PORT_HTTP} → 80nginx: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。用户版的后端没有 ports: —— 它不对公暴露后端端口,浏览器请求一律经前端的 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留空 = 不注册,功能本身不受影响

地址解析规则写在 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 直跑那条路线(script/prune/start-host.ps1)。两套机制的差别见 [插件运行时](/docs/wujies/1.x/advanced/plugin-runtime)。

---

二、宿主机上的东西在哪

实例目录形如 /opt/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 记「每个应用当前生效哪个 jar」,格式是 appCode=jarFileName;
  • 迁移脚本 → ./data/plugins-dist/migrations/<appCode>/(落位前会先清空该目录,所以包里删掉或改名的旧脚本不会留在磁盘上被再次执行);
  • 前端产物 → ./data/remote-apps/<appCode>/,对外 URL = /remote-apps/<appCode>/ + 清单里 assets.frontend 的文件名,并带 ?v=<版本号> 破缓存(AppRuntimeController)。

./data/remote-apps 同时挂给后端(读写,落位用)和前端 nginx(只读,

本文导览

(https://console.wujies.cn/remote-apps/cms-assets/doc-ba788b0961a8-guide.svg)

章节导览
THE END

喜欢就支持以下吧

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

回到内容