跳到主要内容
版本：0.1.x

基本介绍​

配置管理是lina-core的运行时入口之一。主框架启动时读取config.yaml，再把其中的配置分发给HTTP服务、日志、数据库、认证、会话、调度、国际化、集群协调、文件上传和插件治理等组件。

默认配置文件位于主仓库：

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

这个文件既是开发环境的默认模板，也是理解主框架运行方式的索引。业务项目可以在交付时按环境覆盖敏感配置，例如数据库连接、JWT密钥、日志输出和集群协调地址。

配置分组​

分组作用
server配置HTTP监听地址、路由表输出和接口文档访问路径
logger配置日志目录、文件名、级别、标准输出、结构化日志和TraceID输出
database配置默认数据库连接和SQL调试日志
jwt配置认证Token签名密钥和有效期
session配置在线会话超时和过期会话清理间隔
monitor配置服务指标采集间隔，供监控插件使用
health配置健康探针访问数据库时的超时时间
shutdown配置进程优雅关停的最长等待时间
scheduler配置定时调度默认时区
i18n配置默认语言、多语言开关和语言列表
cluster配置单机或集群模式、Redis协调器和选主租约
upload配置上传文件保存目录和单文件大小上限
plugin配置强制卸载策略、动态插件产物目录和启动自动启用插件

服务与接口文档​

server.address决定主框架监听地址，默认值为:8080。server.dumpRouterMap用于启动时输出路由表，适合开发排查，不建议在生产环境长期打开。

server.extensions.apiDocPath是LinaPro在GoFrame服务配置上的扩展字段，默认值为/api.json：

server:
  address: ":8080"
  dumpRouterMap: false
  extensions:
    apiDocPath: "/api.json"

主框架启动后会在这个路径输出聚合后的OpenAPI文档。更多接口文档设计见接口文档。

日志配置​

日志配置复用GoFrame日志能力，并增加LinaPro自己的扩展项：

logger:
  path: ""
  file: "{Y-m-d}.log"
  level: "all"
  stdout: true
  extensions:
    structured: false
    traceIDEnabled: false
配置项说明
path日志文件目录；为空时仅输出到终端
file日志文件名模式
level日志级别，例如all、debug、info、error、off
stdout是否同时输出到标准输出
structured是否启用JSON结构化日志
traceIDEnabled是否在日志中输出TraceID

生产环境通常建议开启结构化日志，并设置稳定的日志目录，方便接入ELK、Loki或云日志服务。

数据库配置​

默认数据库配置指向PostgreSQL：

database:
  default:
    link: "pgsql:postgres:postgres@tcp(127.0.0.1:5432)/linapro?sslmode=disable"
    debug: false

PostgreSQL 14+是生产推荐数据库。SQLite可以用于单节点本地演示或冒烟验证：

database:
  default:
    link: "sqlite::@file(./temp/sqlite/linapro.db)"

SQLite不适合生产环境，也不支持集群部署。启用集群时，所有lina-core节点必须连接同一套共享PostgreSQL数据库。

认证与会话​

认证配置包含JWT签名密钥和Token有效期：

jwt:
  secret: "lina-jwt-secret-key-change-in-production"
  expire: 24h

生产环境必须替换jwt.secret，建议使用随机强密钥，且不要把真实密钥提交到源码仓库。

在线会话由session分组控制：

session:
  timeout: 24h
  cleanupInterval: 5m

session.timeout决定无活动会话的过期时间，session.cleanupInterval决定内置会话清理任务的运行间隔。该清理任务会投影到主框架持久化任务系统中，更多说明见定时任务。

监控、健康与关停​

monitor.interval为服务监控插件提供采集间隔。health.timeout控制/health探针访问数据库时的超时，超过该时间会返回异常状态。shutdown.timeout控制进程优雅关停的最长等待时间。

monitor:
  interval: 1m

health:
  timeout: 5s

shutdown:
  timeout: 30s

这些配置直接影响部署运行时的可观测性和编排系统判断。容器化部署时，健康探针超时不宜设置过长，否则故障节点会更晚被摘除。

定时调度​

scheduler.defaultTimezone定义持久化任务的默认时区：

scheduler:
  defaultTimezone: "UTC"

如果业务主要面向中国大陆用户，可以按部署策略改为Asia/Shanghai。已有任务若显式保存了自己的时区，则以任务配置为准。

国际化​

国际化配置决定运行时默认语言、是否启用多语言能力，以及前端语言切换列表：

i18n:
  default: zh-CN
  enabled: true
  locales:
    - locale: en-US
      nativeName: English
    - locale: zh-CN
      nativeName: 简体中文

当前主仓库默认提供zh-CN和en-US两套运行时语言资源。新增语言时，需要补齐主框架和插件语言包，并把该语言加入i18n.locales。更多资源组织方式见I18N国际化。

集群协调​

默认单机模式如下：

cluster:
  enabled: false

单机模式不连接Redis。启用集群后，当前版本的协调后端只支持Redis：

cluster:
  enabled: true
  coordination: redis
  election:
    lease: 30s
    renewInterval: 10s
  redis:
    address: "127.0.0.1:6379"
    db: 0
    password: ""
    connectTimeout: 3s
    readTimeout: 2s
    writeTimeout: 2s

Redis负责选主、分布式锁、缓存修订和跨节点事件；PostgreSQL仍负责业务数据、治理数据和插件状态持久化。更多拓扑说明见原生分布式架构。

文件上传​

上传配置控制主框架保存文件的路径和单文件大小上限：

upload:
  path: "temp/upload"
  maxSize: 20

插件如需存储文件，应使用插件自己的命名空间，例如temp/upload/content-notice/，避免和主框架或其他插件资源混用。

插件配置​

插件配置连接主框架治理能力和插件运行时：

plugin:
  allowForceUninstall: true
  dynamic:
    storagePath: "temp/output"
  autoEnable:
    # - id: "demo-control"
    #   withMockData: false
配置项说明
allowForceUninstall是否允许平台管理员在生命周期防护否决后执行带审计的强制卸载
dynamic.storagePathWASM动态插件构建产物和上传产物的存储目录
autoEnable主框架启动时自动安装并启用的插件清单

autoEnable中的每个条目使用{id, withMockData}结构。withMockData: true表示自动安装时同时加载插件manifest/sql/mock-data下的演示数据，不建议生产环境启用。

生产建议​

上线前至少检查这些配置：

项目建议
jwt.secret替换默认值，使用随机强密钥
database.default.link指向生产PostgreSQL，不要使用演示连接串
database.default.debug保持false，避免泄露SQL细节
logger.extensions.structured生产环境建议启用结构化日志
scheduler.defaultTimezone按业务所在时区设置
cluster.redis集群模式使用独立、可靠、带认证的Redis实例
plugin.allowForceUninstall按组织治理要求决定是否允许强制卸载
plugin.autoEnable生产环境谨慎启用演示数据