C. 配置项速查

后端 .env 配置

格式说明

.env 文件采用 INI 分组格式，[SECTION] 表示分组，分组下的 KEY = value 对应该分组的配置项。

全局变量

变量	默认值	说明
`APP_DEBUG`	`true`	调试模式（生产环境设为 false）

应用配置 `[APP]`

变量	默认值	说明
`DEFAULT_TIMEZONE`	`Asia/Shanghai`	默认时区
`DEMO`	`false`	演示模式（开启后拦截写操作）
`SHOW_ERROR_MSG`	`true`	显示错误详情（生产环境设为 false）

数据库配置 `[DATABASE]`

变量	默认值	说明
`TYPE`	`mysql`	数据库类型：mysql / pgsql / sqlsrv / oracle / sqlite
`HOSTNAME`	`127.0.0.1`	数据库主机
`DATABASE`	-	数据库名（SQLite 为文件路径）
`USERNAME`	`root`	数据库用户
`PASSWORD`	-	数据库密码
`HOSTPORT`	`3306`	数据库端口
`CHARSET`	`utf8mb4`	字符集
`DEBUG`	`true`	是否开启 SQL 调试
`PREFIX`	`think_`	表前缀

各数据库默认端口：

数据库	默认端口	默认用户
MySQL	3306	root
PostgreSQL	5432	postgres
SQL Server	1433	sa
Oracle	1521	-
SQLite	-	-

JWT 配置 `[JWT]`

变量	默认值	说明
`SECRET`	内置默认	签名密钥（生产环境务必修改）
`ACCESS_TTL`	`7200`	access_token 有效期（秒）
`REFRESH_TTL`	`604800`	refresh_token 有效期（秒）
`ISSUER`	`rxthinkcmf`	签发者标识

文件上传配置 `[FILE]`

变量	默认值	说明
`UPLOAD_DIR`	-	上传根目录（绝对路径）
`DOMAIN_URL`	-	文件访问域名
`IMAGE_EXT`	`gif,jpg,jpeg,png,bmp,webp,svg`	图片允许后缀
`FILE_EXT`	多种后缀	文件允许后缀
`MAX_SIZE`	`10`	最大文件大小（MB）

缓存配置 `[CACHE]`

变量	默认值	说明
`DRIVER`	`file`	缓存驱动：file / redis
`REDIS_HOST`	`127.0.0.1`	Redis 主机（driver=redis 时生效）
`REDIS_PORT`	`6379`	Redis 端口（driver=redis 时生效）
`REDIS_PASSWORD`	-	Redis 密码
`REDIS_DB`	`0`	Redis 数据库编号
`REDIS_PREFIX`	`rx:`	缓存键前缀

CORS 配置 `[CORS]`

变量	默认值	说明
`ALLOW_ORIGIN`	`*`	允许的跨域来源

API 配置 `[API]`

变量	默认值	说明
`CAMEL_SNAKE_CONVERT`	`true`	驼峰/下划线自动转换
`PROXY_IPS`	（空）	受信代理 IP 列表（逗号分隔，支持 CIDR）。部署在 CDN/负载均衡后面时配置，中间件会从 `X-Forwarded-For` / `X-Real-IP` 头提取真实客户端 IP。未配置时默认信任 `127.0.0.1` 和 `::1`。

验证码配置 `[CAPTCHA]`

变量	默认值	说明
`CAPTCHA_BYPASS_CODE`	（空）	万能验证码，仅开发调试用，生产环境务必留空
`CAPTCHA_LENGTH`	`6`	验证码字符长度（4-6位）
`CAPTCHA_EXPIRE`	`300`	过期时间（秒）
`CAPTCHA_RATE_WINDOW`	`60`	防刷窗口期（秒）
`CAPTCHA_RATE_LIMIT`	`20`	窗口期内最大获取次数
`CAPTCHA_CHARS`	`ABCDEFGHJKLMNPQRSTUVWXYZ2346789`	字符集
`CAPTCHA_FONT_PATH`	`static/fonts/Vera.ttf`	字体路径
`CAPTCHA_IMAGE_WIDTH`	`160`	图片宽度（像素）
`CAPTCHA_IMAGE_HEIGHT`	`50`	图片高度（像素）
`CAPTCHA_FONT_SIZE`	`28`	字体大小
`CAPTCHA_NOISE_LINES`	`8`	干扰线数量
`CAPTCHA_NOISE_DOTS`	`500`	噪点数量

代码生成器配置 `[GENERATOR]`

变量	默认值	说明
`PARENT_MENU_ID`	`189`	生成模块的父菜单ID
`APP_NAME`	`tool`	模块应用名（路由前缀）

国际化配置 `[LANG]`

变量	默认值	说明
`default_lang`	`zh-cn`	默认语言

前端环境变量

变量	说明
`VITE_GLOB_API_URL`	API 基础路径（如 `/api`）
`VITE_GLOB_API_URL_PREFIX`	API 前缀

配置文件对照

.env 分组	配置文件	主要配置键
`[DATABASE]`	`config/database.php`	`type` / `hostname` / `database` / `username` / `password`
`[JWT]`	`config/jwt.php`	`secret` / `access_ttl` / `refresh_ttl`
`[FILE]`	`config/file.php`	`upload_dir` / `domain_url` / `max_size`
`[CACHE]`	`config/cache.php`	`driver` / `redis_host` / `redis_port`
`[CORS]`	`config/cors.php`	`allow_origin`
`[API]`	`config/api.php`	`camel_snake_convert`
`[CAPTCHA]`	无配置文件，`CaptchaService` 直接读取 `env()`	`captcha_bypass_code` / `captcha_length` / `captcha_expire`
`[LANG]`	`config/lang.php`	`default_lang`
—	`config/tenant.php`	`default_tenant_id`

租户配置

配置文件	配置键	默认值	说明
`config/tenant.php`	`default_tenant_id`	`1`	默认租户ID，超管操作租户隔离表时自动代入