---
title: 系统设置元数据
description: 系统设置文件阅读入口，指向系统基础信息、安全、日志、路由、认证和全局能力配置的 DTS 说明
navTitle: 系统设置
---
# 系统设置元数据

系统设置位于系统项目 `sysdata/settings/settings.json`，定义整个 SuccApp 部署环境的全局运行边界。它包括系统名称、Logo、域名、CDN、登录认证、安全策略、日志、调度、文档服务、文件存储和其他全局能力，影响所有项目和应用。

当配置会影响所有项目、所有应用、登录入口、静态资源、系统路由、外部服务或运维能力时，应维护系统设置。普通项目自己的数据源范围和显示格式放在 [项目设置](./project-settings-json.md)（`项目/settings/settings.json`）；单个应用的首页和短路由放在 [应用设置](./app-settings-json.md)（`xxxx.app/settings.json`）。

此文件只描述 `sysdata` 下的系统设置，不描述普通项目的 `settings/settings.json`。

## 字段形态{#field-shape}

系统设置是一个扁平对象。大量配置项使用带点号的 key，例如 `sys.basic.name`、`security.password.minLength`、`log.sys.settings`。这些点号是属性名的一部分，不表示 JSON 嵌套对象。

涉及密钥、密码、令牌和第三方服务凭据时，不在文档示例或普通 Git 提交中暴露真实值。域名、登录、安全、文件存储和日志配置会影响全局，修改前应确认目标环境和影响范围。

## DTS 入口{#types}

- 根结构：[`types/meta/file-types/sys-settings.d.ts`](../../../../../dev-types/types/meta/file-types/sys-settings.d.ts)
- 文件类型入口：[`types/meta/file-types/index.d.ts`](../../../../../dev-types/types/meta/file-types/index.d.ts)
- 系统运行时类型：[`sys/sys.types.d.ts`](../../../../../dev-types/sys/sys.types.d.ts)