> 本文整理自平台文档 docs/wujies/5.x/platform/app-market/market.mdx,用于站点内容演示。
(https://console.wujies.cn/remote-apps/cms-assets/doc-0fbbd5a3c51c-cover.svg)
应用市场是宿主前端里的一个页面:路由 /appmarket/market,源码 wujies-admin/src/views/appstore/market/index.vue。它只负责浏览与安装; 装完之后的版本、启停、卸载在 [安装、升级、卸载与启停](/docs/wujies/5.x/platform/app-market/install)。
浏览市场需要权限 app:market:list;卡片上的「安装」按钮需要 app:install:add。 没有权限时页面照常打开,只是按钮不出现。接口清单见 [HTTP 接口索引](/docs/wujies/5.x/platform/reference/api)。
从哪进
| 入口 | 位置 |
|---|---|
| 侧边栏 | 应用市场(菜单 appmarket) |
| 工作台 | 「我的应用」卡片右上角的「前往应用市场」;本租户一个应用都没有时,空态里还有一个「去应用市场看看」 |
页面上有什么
工具栏从左到右:
| 控件 | 行为 |
|---|---|
| 关键词搜索框 | 回车触发。走后端,搜索在目录里做,中文正常 |
| 「已安装」复选框 | 前端过滤,只留本租户装过的 |
| 排序 | 「最近更新」(默认)与「最新创建」,前端排序 |
| 网格 / 列表切换 | 本地记住(localStorage 的 app-store-list-view) |
| 刷新 | 重新拉一次市场列表与本租户的安装列表 |
左侧筛选:
- 类型:全部 / 应用(
app)/ 插件(plugin)/ 内置模块(module)—— 前端过滤。
分类(app_category)现在只在中心上架服务里维护,本部署的市场页不再提供分类筛选控件。
卡片上能看到:封面(没有封面时用图标 + 渐变兜底)、「官方」角标(清单里 officialFlag 为 1 时)、 类型角标、应用名、最新版本号、相对时间(「x 天前更新」)、一行简介、 作者(没填时显示「未知作者」),以及右下角那个按钮 —— 已安装时只显示状态且不可点,未安装时是「安装」。
卡片中间还会多出一行:本租户装过、且装着的版本低于市场最新版时,出现 「有新版本(x.y.z),查看详情 或 立即更新」。升级不必先去「我的应用」,在市场卡片上就能做。
详情与版本
点封面或应用名打开详情抽屉(市场页与已安装页共用同一个组件),分三块:
1. 头部:图标、名称、「官方」标签、安装状态标签(只有已安装页会传这个)、「N 次安装」、 应用编码、「最新 vX」、简介; 2. 左侧元信息:作者(填了主页时是可点链接)、版本、平台版本(engineRange,「需要平台 …」)、 协议(license)、类型、标签,以及「更多」里的收录时间 / 最后发布 / 当前已装; 3. 右侧两个标签页: - 「简介」:应用自己的说明; - 「版本 N」:左边是版本列表(新版本在前,标出「最新」与「已装」,带发布时间), 右边是选中版本的平台版本约束、制品大小、发布日期与更新日志。
它是上架中心填的多行文本、没有经过 HTML 消毒,所以只做文本插值。 写 <b> 这样的标签只会看到标签本身,不会被当富文本执行。
详情接口或版本列表接口失败(权限不足、应用已下架)时,抽屉仍会用列表页已经拿到的字段展示 (名称、图标、编码、类型、当前已装版本),不会开出一片空白。
想上架应用
上架这件事不在本部署里做。平台侧的上架端(原 /appconsole:应用、版本、分类、安装包上传)已在 2026-11-01 整体下线,本部署只剩「浏览与安装」这一侧(/app/market、/app/install)。 应用、版本、分类、安装包的上传与发布,都归中心上架服务 wujies-market 维护(它是私有服务, 没有公开仓库,也没有对外文档链接)。本部署通过 IAppCatalogService 读取它发布出来的目录, 读本机还是读中心怎么切换见 [应用目录](/docs/wujies/5.x/platform/app-market/catalog) 与 [多套部署](/docs/wujies/5.x/deploy/multi-deployment)。
安装包存在哪
中心把包存在本机磁盘或者对象存储里,两种模式共用 market_storage_config 那两列:endpoint 存访问站点, bucket_name 在对象存储模式下存桶名、在本机模式下存落盘目录。这张表恒为一行,页面改完即刻生效, 下一次上传就走新配置;库里没有这一行时按本机磁盘处理。
三个后果要在改之前看清楚。目录里的 package_url 是长期有效的公开直链,平台安装时直接下载、不带签名, 所以桶必须开公开读;换落盘目录或换桶会让已经发出去的 package_url 集体 404,老版本安装不上。 访问密钥(secretKey)在库里是 Base64 编码后存的,这只防肉眼可读,库权限还在的人一样解得开, 备份库文件时把它当成含密文件处理。
标记为私有的应用与对象存储互斥,两头各有一道闸:已经是对象存储时设私有会被拒(AppAdminController#normalizeVisibility), 已经是私有时切对象存储也会被拒(StorageConfigService#assertNoPrivateApps,报错里直接告诉你有几个私有条目)。 只挡一头等于没挡,换个顺序就绕过去了。
冲突的根子在 app_version.package_url 存的是一个长期有效的地址,而桶必须开公开读(私有桶的临时签名链接等到安装现场早过期了)。 私有包一旦进了桶,「私有」就只剩「列表里看不见」,任何拿到链接的人都能下载。本地磁盘这一路才有真鉴权: 下载走中心的 /packages/<sha256>.zip,它会按授权凭证判一次。
把配置放进库而不是环境变量,为的是在线更新与多实例共用一份:环境变量要重启才换, 而中心升级之后不该丢掉运维在页面上填过的那次改动。跟这台机器的磁盘和网关绑在一起的两项仍留在 yml 里, 运行中改它们没有意义:market.packages.dir(本机落盘目录,默认 ./data/packages)与 market.packages.base-url(本站访问前缀;留空时目录里写出的下载地址是相对路径 /packages/<sha256>.zip)。
相关阅读
- [安装、升级、卸载与启停](/docs/wujies/5.x/platform/app-market/install) —— 装完之后在哪儿操作
- [应用目录](/docs/wujies/5.x/platform/app-market/catalog) —— 本部署的目录数据与安装侧的唯一读入口
- [应用生态](/docs/wujies/5.x/platform/ecosystem/) —— 应用目录里现有哪些应用
界面截图
本文导览
(https://console.wujies.cn/remote-apps/cms-assets/doc-0fbbd5a3c51c-guide.svg)


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