应用市场
校对日期:2026-11-09。适用于社区版及全部商业版;试装到沙箱需要商业版标准版。 面向站点运维人员。
UJCMS 内置官方应用市场(market.):在控制台内浏览、购买、安装并更新官方 主题。
入口:控制台 设计 → 主题 → “应用市场”选项卡。选项卡上方的站点选择器决定主题装到哪个 站点。主题按站点分别安装,同一部署中的所有站点共用一个市场账号连接。
所需权限(按角色分配):
| 操作 | 权限 |
|---|---|
| 浏览市场、查看更新角标 | marketplace: |
| 安装 / 更新主题 | marketplace: |
| 连接 / 断开市场账号 | marketplace: |
| 在控制台内购买付费主题 | marketplace: |
一、浏览与安装免费主题
“应用市场”选项卡内可搜索、按类型筛选(完整主题 / 纯数据包);卡片显示价格(免费 / ¥…)、已安装状态与版本兼容性。要求高于当前 UJCMS 版本的主题仍会出现在列表中,卡片带红色 “需要 UJCMS x.y.z+”标记且不提供安装;直接调用安装接口时,系统同样会提示“主题要求 UJCMS x.y.z 及以上版本”并拒绝安装。升级 UJCMS 后即可安装。
点击“安装”:
- 确认将要安装的版本和主题目录名。版本默认为最新版本,目录名默认与市场标识一致。 如需安装旧版本,可在卡片“详情”的“版本历史”中找到对应版本,点击“安装”;
- 选择演示数据导入范围:不导入 / 仅布局(页面组件与区域)/ 完整站点演示(内容 + 布局),与上传安装提供的三种选项一致;
- 可选“安装后激活”,开启后再选择激活范围(桌面端 / 手机端 / 桌面端 + 手机端)。安装完成后弹出 报告(含 SHA-256 完整性摘要与演示数据导入结果)。
安装的下载包会先经 SHA-256 完整性校验(与市场下载授权比对),不一致即拒绝安装—— “安装包完整性校验失败”意味着下载途中被破坏或篡改,请重试或检查代理等网络环节。
主题包大小上限为 50 MB(ujcms.,与上传安装共用),超限的市场主题同样无法安装。
二、试装到沙箱(商业版标准版)
如需先查看主题效果,可点击卡片上的“试装到沙箱”。系统会新建一个独立的沙箱子站点,从应用市场下载并安装该主题, 再激活主题并导入完整演示数据,供您预览和测试。需要同时具备 theme:sandbox 与 marketplace: 权限。沙箱站点可在“设计 → 主题”的沙箱抽屉中打开、重新创建或完整清理。
三、连接市场账号(购买付费主题的前提)
付费主题需要先将当前部署连接到您的市场账号:
- 点击连接栏的“连接账号”,对话框显示一个二维码,下方是一个短授权码和“打开批准页”按钮;
- 用手机微信“扫一扫”(或手机相机扫码)打开授权页面,在手机上登录或注册市场账号(手机号 验证码首次登录即完成注册),核对授权码后确认授权;也可以在电脑浏览器点击“打开批准页”, 登录市场账号,输入对话框中的授权码并确认授权;
- 对话框自动变为“已连接账号 …”,连接栏显示该账号的显示名和脱敏后的联系方式,如“张三(138*0000)” 或“张三(122@qq.com)”;完整的手机号、邮箱只在应用市场的账号安全页可见。连接是部署级的:一个 UJCMS 部署同时只保持一个市场账号连接,令牌只存 服务器端(数据库加密存储),控制台浏览器不会直接获取市场令牌。
集群部署注意:连接账号时,授权流程的临时数据保存在单个节点内存中,请确保负载均衡启用会话保持 (连接建立后的凭据经数据库共享,无此要求)。
四、购买与安装付费主题
未购买的付费主题显示“购买”按钮。购买有两条路径,控制台和 UJCMS 后台在两条路径上都不处理支付信息。
控制台内购买
需要 marketplace: 权限,且当前部署已连接市场账号。点击“购买”弹出购买对话框,显示主题、金额、订单号和支付方式 (默认选中第一种;市场提供多种支付方式时可在对话框内更换,更换后仍是同一张订单):
- 微信支付:对话框内显示付款二维码,用手机微信“扫一扫”完成支付。二维码约 2 小时有效,过期后对话框提示“支付二维码已过期”, 点击“重新发起”即获得新的二维码(仍是同一张订单)。
- 前往支付:有些支付方式会在新标签页打开支付页面,在该页面完成支付后回到控制台即可。
支付完成后对话框自动变为“支付成功,已购买 …”,卡片同时变为“已购买”,“安装”按钮随即可用——无需再点“刷新授权”, 可直接在对话框中点击“安装”。订单与发票请在市场网站“我的订单”中查看(对话框提供链接)。
未付款前可点“取消订单”;若支付渠道暂时无法确认付款是否发生,会提示“支付渠道暂时无法确认,订单保留”,稍后可继续支付或再次取消。 同一主题同时只会有一张未付订单:重复点击“购买”或在市场网站再次下单,都会回到同一张订单。
重新连接提示:在控制台内购买上线之前建立的账号连接,不包含“在控制台发起购买”的授权。点击“购买”时对话框会提示 “重新连接以启用控制台内购买”,点击“重新连接”重新完成一次账号连接即可(批准页会列出这项授权)。重新连接会在市场账号下登记一个新的 已连接实例并吊销旧实例的访问授权,已安装主题不受影响。在此之前,“购买”按钮仍会打开市场网站。
在网站购买
没有 marketplace: 权限或尚未连接账号时,点击“购买”会在新窗口打开市场网站的商品详情页;需要支付宝付款(上线前)、 对公转账或开具发票时,也请点击购买对话框中的“在网站购买”。在网站完成注册、登录和支付后回到控制台,点击“刷新授权”, 卡片变为“已购买”,“安装”按钮随即可用。订单历史同样在市场网站“我的订单”查看。
购买后获得的授权归属于市场账号,永久有效,涵盖全部版本:连接同一账号的任何部署都可下载安装;退款会同时 收回安装授权(再次安装会提示“尚未购买该主题”)。
五、更新主题
“应用市场”选项卡载入时会对已装主题做一次更新检查(也可手动刷新);有兼容新版本的卡片 显示“可更新 vX.Y.Z”角标,“更新”替代“安装”。更新流程与上传主题包更新相同:先暂存并校验新包,再整体替换主题文件, 最后生成演示数据差异报告,分别列出新增、随包变更和运维人员已修改的内容。演示数据默认“不导入”。
隐私说明:更新检查只发送已装主题的目录名与版本号,不含站点内容、域名或任何其他 数据;控制台内购买只发送所购主题的标识与账号授权令牌,同样不含站点信息;除此之外 CMS 不向市场上报其他运行统计数据。
六、断开连接
连接栏“断开连接”会远程吊销本实例的访问授权并清除本地凭据(已安装主题不受影响)。 也可在市场网站的“账号 → 已连接实例”里远程吊销任何实例——被吊销的部署会在其访问令牌 到期后(至多约 15 分钟)显示“应用市场连接已失效,请重新连接账号”,重新连接账号 即可恢复;期间免费主题的安装不受影响。
七、离线 / 内网部署
- 暂时无法连接市场时,选项卡显示“无法连接应用市场”并提供重试;已安装主题的使用、上传 安装等一切本地功能不受影响。市场连接恢复前,尝试从市场安装主题会提示错误。
- 完全隔离的内网部署可在
application.设yaml ujcms.: “应用市场”选项卡隐藏,市场相关接口全部停用,其余功能可正常使用。主题仍可通过“上传 安装”离线安装。marketplace. enabled: false - 相关配置(均在
ujcms.):marketplace.* base-url(市场 API 地址)、storefront-url(市场网站地址,购买时跳转使用,默认与 base-url 相同)、cache-ttl-seconds(目录缓存,默认 60 秒)。