# 参数设置

<!-- BookStack import page: id=sys-config chapter=系统管理 -->

## 功能定位

参数设置维护系统运行参数和业务配置，例如初始密码策略、注册开关、OSS 预览开关和企业基本信息。参数变更可能影响全局行为，必须谨慎。

![参数设置](https://help.bigdata365.net/uploads/images/gallery/2026-11/embedded-image-nkd3rzby.png)

*图 8-6　系统内置参数与自定义配置*

## 适用角色

超级管理员、系统管理员和运维人员。

## 页面入口

系统管理 → 参数设置（`/system/config`）。

## 参数分类

| 分类 | 示例 | 影响 |
|---|---|---|
| 系统内置 | 用户初始密码、注册开关、OSS 预览开关 | 认证、账号和文件访问行为 |
| 自定义配置 | 企业编码、企业全称、简称、英文名、法人、注册资本、成立日期 | 页面展示、报表抬头和品牌信息 |

## 操作步骤

1. 按参数名称或键名搜索目标参数。
2. 打开编辑，确认参数键、当前值、备注和影响范围。
3. 修改后保存，并点击“刷新缓存”使多节点立即生效。
4. 涉及认证、注册、文件访问或外部地址的参数，先在测试环境验证。
5. 对关键参数保留变更记录：修改人、时间、原值、新值和回滚方式。
6. 导出参数清单用于备份，但导出文件不得包含真实密钥或口令。

## 输入与输出

输入是参数键和值；输出是运行时配置、缓存刷新结果和操作审计。

## 宏澜家电示例

将企业全称设置为“宏澜家电智造集团股份有限公司”，简称“宏澜集团”，英文名用于登录页和报表抬头。初始密码参数只设置复杂度策略，不在文档中记录真实密码。

## 客户应用演示：调整报表默认查询时间范围

**业务情境：** 业务反馈报表默认打开最近 30 天，希望改为最近 90 天。

### 第一步：进入“系统管理 → 参数设置”

![第1步重点操作：进入“系统管理 → 参数设置”](https://help.bigdata365.net/uploads/images/gallery/2026-11/embedded-image-ysblj5ve.jpeg)

*步骤图 49-01　第1步：进入“系统管理 → 参数设置”。红框标出进入系统管理 → 参数设置。*

进入“系统管理 → 参数设置”，搜索报表相关参数。

### 第二步：记录原值、参数键名和影响范围

![第2步重点操作：记录原值、参数键名和影响范围](https://help.bigdata365.net/uploads/images/gallery/2026-11/embedded-image-pvvvhv19.jpeg)

*步骤图 49-02　第2步：记录原值、参数键名和影响范围。红框标出记录原值、参数键名和影响范围。*

记录原值、参数键名和影响范围，确认不是敏感配置。

### 第三步：修改参数值并填写变更原因

![第3步重点操作：修改参数值并填写变更原因](https://help.bigdata365.net/uploads/images/gallery/2026-11/embedded-image-nrnfuxhm.jpeg)

*步骤图 49-03　第3步：修改参数值并填写变更原因。红框标出修改参数值并填写变更原因。*

修改参数值并填写变更原因，保存。

### 第四步：点击刷新缓存

![第4步重点操作：点击刷新缓存](https://help.bigdata365.net/uploads/images/gallery/2026-11/embedded-image-e0fcmvui.jpeg)

*步骤图 49-04　第4步：点击刷新缓存。红框标出点击刷新缓存。*

点击刷新缓存，重新打开业务报表验证默认范围。

### 第五步：若结果不符合预期

![第5步重点操作：若结果不符合预期](https://help.bigdata365.net/uploads/images/gallery/2026-11/embedded-image-kifpknzr.jpeg)

*步骤图 49-05　第5步：若结果不符合预期。红框标出若结果不符合预期。*

若结果不符合预期，按记录恢复原值。

## 最终结果与效果

报表默认查询范围更新为 90 天，页面行为和变更记录一致。

> **操作提示：** 不要修改数据库口令、密钥和第三方地址等基础设施参数；变更前先备份原值。

## 常见问题

**修改参数后没有生效。** 点击“刷新缓存”，必要时重启相关服务。

**参数值显示被脱敏。** 截图和页面会对敏感值脱敏；实际值只对授权管理员可见。

**误改关键参数。** 立即回滚到原值并刷新缓存，再检查登录、注册和文件访问。

## 开发人员参考

- 接口：`/system/config`、`/system/config/{configId}`、`/system/config/refreshCache`
- 权限：`system:config:list`、`system:config:add`、`system:config:edit`、`system:config:remove`、`system:config:export`
- 参数缓存于 Redis；系统内置参数不应随意删除。
- 密钥类配置应使用环境变量或密钥管理，不应存入普通参数表。