基本介绍

LinaPro 采用分层配置体系，将配置分为三个层次：主框架静态配置、主框架动态配置和插件业务配置。这种设计既保证了核心框架的稳定性，又为运行时调整和插件扩展提供了灵活性。

配置层次

层次	来源	说明
主框架静态配置	config.yaml	启动时加载，进程生命周期内不变，涵盖服务、日志、数据库、认证等核心组件
主框架动态配置	sys_config数据表	可在运行时热更新，覆盖静态默认值；进程内以1小时TTL缓存，集群模式通过Redis同步修订号保持一致
插件业务配置	插件独立配置文件	插件拥有独立的配置作用域，通过优先级机制读取配置，与主框架配置隔离

配置文件位置

主框架默认配置文件位于：

apps/lina-core/manifest/config/config.yaml

仓库同时提供了一份完整双语注释的配置模板，适合作为逐字段参考：

apps/lina-core/manifest/config/config.template.yaml

插件配置文件位于各自插件目录下，优先级和读取方式详见插件业务配置。

相关文档

📄️框架静态配置

主框架 config.yaml 静态配置详解，涵盖 server、logger、database、jwt、session、health、scheduler、workspace、i18n、cluster、upload 和 plugin 等分组的配置项、默认值与使用说明，帮助开发者快速理解并定制主框架运行时行为。

📄️框架动态配置

主框架运行时可热更新参数详解，涵盖 sys_config 数据表驱动的系统内置参数与业务插件自定义参数的分类管理、后端运行时参数、公开前端展示参数和 TZ 环境变量，说明参数缓存机制、集群同步策略和典型使用场景，帮助运维人员在不重启进程的情况下动态调整系统行为。

📄️插件业务配置

插件业务配置与主框架配置的隔离机制、配置读取优先级的独占式覆盖策略、宿主 config.yaml 中 plugin.<plugin-id> 段的管理方式、sys_config 运行时参数存储的通用机制（含插件自定义条目）、源码插件和动态插件的配置读取方式差异，以及宿主公开配置的白名单校验流程，帮助插件开发者理解配置管理的最佳实践和安全约束。

📄️最佳实践与生产建议

生产环境部署配置检查清单、安全建议和最佳实践，涵盖静态配置、运行时参数的关键配置项、配置边界和安全要求，帮助运维团队确保系统在生产环境中的稳定性、安全性和可观测性。