中国 帮助

可视化配置

「系统管理 → 系统配置」把原先散落在 application.yml、参数管理、数据库脚本里的运行参数,收成一个带页签的可视化页面。多数配置保存后立即生效,不需要重启宿主。 src="/images/docs/settingstab

可视化配置
封面

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

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

「系统管理 → 系统配置」把原先散落在 application.yml、参数管理、数据库脚本里的运行参数,收成一个带页签的可视化页面。多数配置保存后立即生效,不需要重启宿主。

src="/images/docs/settings-tabs.png" caption="系统设置 · 分类页签" />

页签与数据来源

页签数据来源保存后生效方式
[网站](/docs/wujies/5.x/platform/settings/website)sys_config(config_category = website)刷新前台页面即可
[安全](/docs/wujies/5.x/platform/settings/security)sys_config(security)下一次校验 / 登录时
[登录](/docs/wujies/5.x/platform/settings/login)sys_config(login)下一次获取验证码时
[邮箱](/docs/wujies/5.x/platform/settings/email)sys_config(email)下一次发信时(每次实时读取)
[号码认证](/docs/wujies/5.x/platform/settings/phone-verify)sys_phone_verify_config下一次发码 / 校验时
短信页面占位功能尚未开放
[存储](/docs/wujies/5.x/platform/settings/storage)sys_oss_config下一次上传时
[客户端](/docs/wujies/5.x/platform/settings/client)sys_client下一次登录 / 鉴权时

> 系统配置页本身只维护运行参数;应用级别的站点配置(如 gallery.*、mall.*)由各应用通过 /open/<appCode>/config 暴露,见[能力开放](/docs/wujies/5.x/platform/open-api/endpoints)。

页面结构

每个页签都遵循同一套交互:

  • 查看态:字段只读,底部显示「编辑」。
  • 编辑态:可修改、可「取消」或「保存」。
  • 恢复默认:把当前页签的配置重置为后端登记的 default_value,不会删除配置项。
  • 说明文字:每个配置项下方展示 remark,解释取值范围和影响。

这套交互由 SettingForm 统一实现,新增页签时只需要提供字段与配置 key。

权限

权限标识作用
system:settings:list进入系统配置页
system:settings:website网站配置
system:settings:security安全配置
system:settings:login登录配置
system:settings:email邮箱配置
system:settings:sms短信配置
system:phoneVerifyConfig:list号码认证配置
system:settings:storage存储配置
system:settings:client客户端管理

配置页的保存接口复用参数管理的 system:config:edit;号码认证、存储、客户端各自使用独立权限。

配置优先级

同一个参数可能同时出现在 yml 与数据库:

1. 数据库配置优先(页面修改的值); 2. yml 作为首次启动的兜底; 3. 代码里的常量/默认值只在两者都缺失时使用。

邮件是典型例子:application.yml 里仍有 mail.*,但 MailConfig 每次发信都从 sys_config 读取,所以页面改完不需要重启。

安全提醒

  • mail.pass、accessKeySecret、secretKey、clientSecret 都是敏感字段,列表接口默认不返回明文;查看明文需要单独的「查看密钥」权限。
  • 演示环境截图、工单、文档里不要贴真实密钥。
  • 生产环境修改邮件、号码认证、存储配置后,建议立即发一条测试消息 / 上传一个文件验证。

本文导览

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

章节导览
THE END

喜欢就支持以下吧

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

回到内容