C. 配置项速查
:::tip 说明
config/config.yaml 全部配置节速查。任意键可用环境变量覆盖（大写 + 点换下划线 + APP_ 前缀，仅覆盖已存在键）。完整注释见配置文件本身。
:::
server
| 键 |
默认 |
说明 |
| server.address |
:8000 |
监听地址 |
logger
| 键 |
默认 |
说明 |
| logger.level |
all |
debug/info/warn/error/all |
| logger.stdout |
true |
控制台输出 |
| logger.path |
log |
日志目录 |
database.default
| 键 |
默认 |
说明 |
| driver |
mysql |
mysql/postgres/sqlserver/sqlite/oracle |
| host / port |
127.0.0.1 / 3306 |
连接（sqlite 忽略） |
| username / password |
root / root |
账号 |
| dbname |
easygoadmin.gin.elevue |
库名（sqlite 为文件路径） |
| params |
charset=utf8mb4&... |
DSN 追加参数 |
| debug |
false |
SQL 日志 |
| maxOpenConns / maxIdleConns |
50 / 10 |
连接池 |
| connMaxLifetime |
3600 |
连接存活（秒） |
redis.default
| 键 |
默认 |
说明 |
| address |
127.0.0.1:6379 |
为空降级内存 |
| db |
0 |
库编号 |
| pass |
— |
密码 |
jwt / captcha / rateLimit
| 键 |
默认 |
说明 |
| jwt.secret |
样例值 |
签名密钥（生产必换） |
| jwt.issuer |
easygoadmin |
签发者 |
| jwt.accessTokenExpire |
7200 |
访问令牌（秒） |
| jwt.refreshTokenExpire |
604800 |
刷新令牌（秒） |
| captcha.expire / length / chars |
300 / 6 / 字符集 |
验证码参数 |
| captcha.bypassCode |
空 |
万能码（prod 拒绝非空） |
| captcha.fontPath / imageWidth / ... |
Vera.ttf / 160... |
渲染参数 |
| rateLimit.enable / limit / windowSeconds |
true / 120 / 60 |
普通限流 |
| rateLimit.authLimit |
10 |
认证接口限流 |
operationLog / job / tenant / app
| 键 |
默认 |
说明 |
| operationLog.enable / logQuery |
true / true |
操作日志开关 |
| job.logRetentionDays |
90 |
日志保留（LogClean） |
| job.lockTTLSeconds |
300 |
任务锁 TTL |
| tenant.defaultId |
1 |
超管新增默认归属 |
| app.timezone |
Asia/Shanghai |
时区 |
| app.demo |
false |
演示模式（拒写） |
| app.prod |
false |
生产模式（红线校验） |
api / cors / file
| 键 |
默认 |
说明 |
| api.proxyIps |
127.0.0.1,::1,... |
受信代理（CIDR） |
| api.maxBodyMB |
10 |
请求体上限 |
| api.docs / api.metrics |
true / true |
文档/指标端点 |
| cors.allowOrigin |
* |
允许来源 |
| file.uploadDir |
upload 绝对路径 |
上传根 |
| file.domainUrl |
http://file.gin.elevue（样例） |
文件访问域址（生产覆盖；为空则应用回退） |
| file.imageExt / fileExt / maxSize |
白名单 / 10 |
扩展名与大小 |
| file.tempExpireDays |
7 |
temp 保留天数 |
generator / ip2region
| 键 |
默认 |
说明 |
| generator.enable |
true |
总开关（生产 false） |
| generator.parentMenuId |
189 |
菜单挂载父级 |
| generator.overwrite |
true |
覆盖策略 |
| ip2region.path |
resource/data/ip2region.xdb |
归属地库 |
相关
