> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alforse.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 配置

> 按模块说明 Alforse API 的环境变量。

## 概览

此页说明 API 环境变量。Alforse Cloud 使用 SaaS 值；企业自部署使用同名变量，但必须指向客户管理的基础设施。所有标为 Secret 的值都应进入密钥管理系统。

| 类别            | 说明                                                                                                |
| ------------- | ------------------------------------------------------------------------------------------------- |
| 版本与运行时        | EDITION、NODE\_ENV、PORT。self\_hosted 需要企业许可，production 会启用严格校验。                                    |
| 核心基础设施        | PLATFORM\_DATABASE\_URL、TENANT\_DATABASE\_URL、REDIS\_URL。系统元数据和租户数据必须分库。                          |
| 认证与请求完整性      | JWT\_ACCESS\_SECRET、JWT\_REFRESH\_SECRET、API\_HMAC\_SECRET、MFA\_SECRET\_KEY。                      |
| 公开 URL 与 CORS | API\_PUBLIC\_URL、WEB\_PUBLIC\_URL、DEALS\_PUBLIC\_URL、CONSOLE\_PUBLIC\_URL、CORS\_ALLOWED\_ORIGINS。 |
| 对象存储与文件扫描     | OSS\_\*、FILE\_SCAN\_MODE、FILE\_SCAN\_ENDPOINT、FILE\_DOWNLOAD\_REQUIRES\_CLEAN\_SCAN。              |
| OCR、AI、SSO、邮件 | 按需配置 OCR、AI 网关、SSO provider 和邮件发送服务。                                                              |

## 必要密钥处理

* `JWT_ACCESS_SECRET`
* `JWT_REFRESH_SECRET`
* `API_HMAC_SECRET`
* `MFA_SECRET_KEY`
* `OSS_SECRET_KEY`
* `FILE_SCAN_API_KEY`
* `OCR_API_KEY`