> ## 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`