# C. 配置项速查

## 后端 .env 配置

:::tip 格式说明
`.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，超管操作租户隔离表时自动代入 |