🧾 配置索引

本页按文件维度速查所有配置位置：.env、config/*.php、Admin 与 uni-app 的环境文件、后台配置分组。

想了解 .env 与 config/*.php 的具体含义，去环境配置。
想读写 configs 表中的业务配置，去系统配置。
想维护字典选项，去数据字典。

🔬 后端配置

文件	说明
`.env`	Laravel 运行环境
`config/app.php`	应用基础配置
`config/auth.php`	认证 guard/provider
`config/cache.php`	缓存
`config/database.php`	数据库
`config/filesystems.php`	文件系统
`config/logging.php`	日志
`config/queue.php`	队列
`config/route-attributes.php`	注解路由扫描
`config/sanctum.php`	Sanctum
`config/services.php`	第三方服务
`config/sunadmin.php`	SunAdmin 业务配置

🧿 `config/sunadmin.php`

Key	说明
`admin_captcha.type`	后台验证码类型
`site_status.group`	站点开关配置分组
`site_status.key`	站点开关配置键
`site_status.cache_key`	站点状态缓存 key
`site_status.cache_ttl`	站点状态缓存时间
`config_cache.*`	配置缓存开关、TTL、前缀
`dict_cache.*`	字典缓存开关、TTL、前缀
`hot_cache.*`	公共配置、装修页、语言包热点缓存
`cache_versions.*`	缓存版本号 key
`rate_limits.*`	限流配置
`locks.*`	业务锁配置
`async.ai_usage.*`	AI 用量异步记录
`list.page_size`	默认分页大小
`list.page_size_max`	最大分页大小
`upload.*`	上传扩展名和大小
`pay.handlers`	系统层支付回调处理器
`pay.biz_handlers`	业务层支付处理器
`install.lock_path`	安装锁路径

🔧 Admin 环境变量

文件	说明
`frontend/admin/.env.development`	Admin 开发环境
`frontend/admin/.env.production`	Admin 生产环境

变量	说明
`VITE_APP_BASE_URL`	接口域名或根路径，不包含 `adminapi`

🧾 日志环境变量

变量	说明
`LOG_CHANNEL`	Laravel 默认日志通道，SunAdmin 推荐 `daily`
`LOG_STACK`	`stack` 通道包含的日志通道，推荐 `daily`
`LOG_DAILY_DAYS`	按日日志保留天数

日志文件位于 storage/logs，后台“系统维护 / 日志”会按 .log 文件展示系统日志。详细用法见日志与审计。

🧪 uni-app 环境变量

文件	说明
`frontend/uniapp/.env.development`	uni-app 开发环境
`frontend/uniapp/.env.production`	uni-app 生产环境

变量	说明
`VITE_APP_BASE_URL`	H5 可用 `/`，小程序/App 必须完整域名

📌 后台配置分组建议

分组	用途
`basics`	站点基础配置
`storage`	存储驱动配置
`ai`	AI 模型与能力配置
`wechat`	微信公众号配置
`wxapp`	微信小程序配置
`pay`	支付接入默认驱动
`wallet`	钱包模块配置，安装钱包模块后写入
`sms`	短信配置