配置介绍 Configurations

了解如何管理和自定义 Strapi 应用程序的配置。

Strapi 项目的配置位于 /config 文件夹中：

. # root of the project
├──── config
│     ├ api.js|ts
│     ├ admin.js|ts
│     ├ cron-tasks.js|ts
│     ├ database.js|ts
│     ├ features.js|ts
│     ├ middlewares.js|ts
│     ├ plugins.js|ts
│     └ server.js|ts

上面的代码块是项目结构的摘录。您可以点击任意文件名来阅读相应的文档。请访问项目结构页面获取完整版本。

基本配置

从 /config 文件夹中，您可以找到并定义以下基本配置：

配置主题文件路径必需或可选
数据库config/database必需
服务器config/server必需
管理面板config/admin必需
中间件config/middlewares必需
API 调用config/api可选，用于定义响应和其他 REST 相关参数的一些常规设置。

特定功能的额外配置

某些特定功能需要额外配置：

功能位置必需或可选
插件在 config/plugins 文件中
  • 如果仅使用具有默认预设的内置插件，则可选。
  • 启用、配置或禁用插件时必需。
也可用于配置上传插件（处理媒体库功能）和 GraphQL。
TypeScript高效使用 TypeScript 所需
API 令牌在 config/admin 文件中如果使用 API 令牌而不是 用户和权限插件 进行身份验证，则所需
生命周期函数在 /src/index 文件中可选用于执行服务器生命周期中发生的各种操作。包括 register、bootstrap 和 destroy 函数。
Cron 作业
  • 在 /config/server 文件中启用该功能
  • 在专用的、可选的 cron-tasks 文件中，可用于声明作业
需要为服务器设置 CRON 作业。
环境变量在环境的专用文件和文件夹中（例如，config/env/production/server）可选地用于定义不同的环境及其变量。
单点登录 (SSO) 企业版 在 config/admin 文件中如果在项目中启用了仅限企业的 SSO 功能，则需要使用此功能。
功能标志在 config/features 文件中对于典型、稳定的 Strapi 应用程序而言是可选的。
仅需启用 未来标志。

指南

以下指南将帮助您解决与 Strapi 配置相关的特定用例：

相关阅读：如何为基于角色的访问控制 (RBAC) 创建自定义条件
相关阅读：如何使用公共资产
相关阅读：如何从代码访问配置值
相关阅读：如何访问和转换环境变量