> 本文整理自平台文档 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)


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