> 本文整理自平台文档 docs/wujies/5.x/platform/package/publish.mdx,用于站点内容演示。
(https://console.wujies.cn/remote-apps/cms-assets/doc-3ff0f9a8b19f-cover.svg)
这一页只讲中心上架服务(wujies-market,控制台在 wujies-market/web/)从「手上有一个 zip 包」到「租户能在应用市场里装到它」之间的每一步: 接口、版本行字段、状态流转,以及每一步会因为什么被拒绝。
> ⚠️ 上架端已经不在平台侧了。2026-11-01 起,平台自带的上架端(AppConsoleController / AppVersionController / > AppPackageController / AppCategoryController 与 wujies-admin 的「应用上架」页面、/appconsole/ 路由)全部删除, > wujies-app-market 只剩 5 个控制器(/app/install、/app/market、/app/runtime、/app/workbench、/app/dev)。 > 传包、建版本、发布、上下架现在都在独立部署的中心上架服务 wujies-market 里做(它把路径 app/console、app/version、 > app/package、app/category 原样复用,但鉴权改成口令换令牌,不再是 Sa-Token 权限点);「部署 / 落位 / 安装」仍只在各部署自己的平台侧。 > 中心服务是私有的,没有公开仓库**,不要把它的地址当公开链接发出去。
前置的、已经在别处写清的三件事不在这里重复:
| 主题 | 去哪看 |
|---|---|
| 包怎么打、包内目录规范 | [打包应用](/docs/wujies/5.x/platform/package/build)、[打包与上架](/docs/wujies/5.x/platform/package/) |
签名、密钥、安全模式(off / warn / enforce) | [密钥与签名](/docs/wujies/5.x/platform/package/signing)、[包安全模式](/docs/wujies/5.x/platform/package/security-modes) |
| 平台安装侧端点(落位 / 安装 / 升级 / 就绪度自检) | [HTTP 接口索引](/docs/wujies/5.x/platform/reference/api) |
下文用 market/… 指代中心服务源码前缀 wujies-market/src/main/java/cn/wujies/market/; 用 market-core/… 指代两端共用的内核 wujies-platform/wujies-modules/wujies-market-core/src/main/java/cn/wujies/appmarket/。
中心服务没有用户表、没有权限点,唯一那道闸是控制台口令:POST /market/login(body {"password":"<控制台口令>"}) 换回一个令牌,后续每个管理请求都放进 X-Market-Token 头。口令由环境变量 MARKET_CONSOLE_PASSWORD 提供, 没配时中心拒绝登录、所有管理接口关闭。要做的四件事(传包、建/改版本、发布、上下架)全靠这一个令牌, 不再区分 app:console:list/add/edit/remove。
---
链路总览:中心服务四个动作都不动磁盘,落位在平台
| # | 动作 | 在哪 | 接口 | 鉴权 | 改了什么 |
|---|---|---|---|---|---|
| ① | 上传包 | 中心服务 | POST /app/package/parse | X-Market-Token | 包落到中心磁盘(内容寻址 <sha256>.zip);返回清单、地址与 MD5/SHA256。不落位到任何部署 |
| ② | 保存版本 | 中心服务 | POST /app/version | X-Market-Token | 插一行 app_version,status 默认 0 |
| ③ | 发布版本 | 中心服务 | POST /app/version/{versionId}/publish | X-Market-Token | 该行 status=1 + release_time;回写 app_info.latest_version |
| ④ | 上架应用 | 中心服务 | POST /app/console/{appId}/status?status=1 | X-Market-Token | app_info.status=1;要求 latest_version 非空 |
| ⑤ | 落位 / 安装 | 平台(各部署) | POST /app/install/version/{versionId}/deploy、POST /app/install | app:install:edit / app:install:add | 按中心目录里的 package_url 下载 → 校验和 → 安全检查 → 解包落位 → 热加载。只有这一步写宿主磁盘 |
> ①–④ 全在中心服务、走 X-Market-Token;⑤ 是各部署自己的平台动作、走登录态 + Sa-Token 权限。 > 中心服务没有 /app/version/{id}/deploy —— 部署是「把产物落到这台机器的运行目录」, > 而安装实例表(app_install)在各部署本地、不在中心库。
①②③④ 都只是登记与状态变更,磁盘上什么都没有。产物要等 ⑤(平台「落位」/POST /app/install/version/{versionId}/deploy), 或者等租户在自己那台点「安装」(安装/升级走服务内部的 AppPackageDeployService.deploy(versionId, false),只落位,加载推迟到迁移之后)。
少了 ⑤ 的表现:市场里看得见、点得开,但接口报「应用未安装或未启用」,菜单点开是「远程视图不可用」。
控制台里的顺序与之对应:新增应用(登记 appCode、名称等)→ 版本管理(上传包、保存版本、发布)→ 回应用列表上架。
POST /app/console 新增应用时有四个默认值(都在 market/controller/AppAdminController.java 的 add 方法里):不传 status 落 0 草稿、不传 appType 落 module、不传 installMode 落 optional、 不传 audience 落 tenant。另有两条由服务端强制:latestVersion 置 null(只由发布流程写)、 installCount 置 0;PUT /app/console 同样忽略请求体里的 latestVersion。
appType 在两个接口里都会先过 normalizeAppType:转小写后只接受 module / app / plugin, 其余一律 参数不正确。校验放在服务端是因为写错的值不会立刻报错 —— 它要等到某个租户点安装才炸成 「没有可处理该应用的安装器」,而那时包与迁移可能已经跑过了。deploy 不在白名单里:没有执行器认领它。 新增时留空按 module 登记(与 DDL 默认值一致),编辑时留空表示不改这一列。
---
① 上传包:POST /app/package/parse
| 项 | 值 |
|---|---|
| 请求 | multipart/form-data(consumes 已声明,别的类型不匹配) |
| 表单字段 | file(zip,必填)、appId(可选,Long) |
| 鉴权 | X-Market-Token 头(中心服务) |
| 实现 | market/controller/PackageAdminController.java 的 parse |
appId 传了会先按 ID 查 app_info(不存在报「应用不存在: N」),再用该应用的 app_code 校验包内清单的 code,不一致报「清单中的 code(X) 与所属应用(Y) 不一致」。
限制全部是类里的常量,越界文案如下:
| 限制 | 值 | 越界时 |
|---|---|---|
MAX_PACKAGE_BYTES(PackageAdminController) | 200MB | 应用包不能超过 200MB |
MAX_MANIFEST_BYTES(market-core 的 AppPackageManifestReader) | 1MB | 应用清单超过 1024KB,疑似异常文件 |
| 文件名后缀 | .zip(忽略大小写) | 应用包必须是 zip 格式,当前文件: <文件名> |
| 清单位置 | 包根 app.json;退一步接受一层嵌套的 */app.json | 应用包内未找到 app.json,请确认包结构(清单需位于压缩包根目录) |
AppPackageManifestReader 会跳过 __MACOSX/ 与目录项;根目录那份优先,一层嵌套那份只作兜底。 不要依赖这个兜底:产物白名单是按 zip 根目录判定的,多套一层会被判成非法顶层目录 (见 [打包应用](/docs
本文导览
(https://console.wujies.cn/remote-apps/cms-assets/doc-3ff0f9a8b19f-guide.svg)


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