配置Dify環境變數以最佳化自訂部署 - Data Management

您可以通過本文瞭解如何在阿里雲 DMS 控制台中為 Dify 執行個體設定或更新自訂環境變數，從而按需最佳化其效能表現、存取原則及服務地址等配置。

注意事項

服務將會重啟：儲存任何環境變數的修改都會觸發 Dify 執行個體的自動重啟，期間服務將短暫中斷。請在業務低峰期進行此操作。
白名單限制：出於安全考慮，僅允許修改白名單中的環境變數。變數列表請參見支援的環境變數列表。
格式要求：所有參數都必須以標準的 JSON 索引值對（"Key": "Value"）格式提供，且所有 Value 都必須是字串類型。

操作步驟

登入DMS控制台，在頂部導覽列中，點擊Data + AI > Dify，進入Dify執行個體列表介面。
點擊對應Dify執行個體操作列的資源管理。
開啟資源管理介面後點擊環境參數。
在彈出的環境參數配置對話方塊中，您可以修改或添加環境變數。
- 修改已有參數：
  - 直接編輯輸入框中已存在的參數值即可。
  - 如果想恢複為預設值，可以直接刪除該行索引值對，儲存後系統會自動應用預設配置。
- 添加新參數：
  - 部分白名單中的參數預設不顯示，需要您手動添加。
  - 這裡以配置自訂網域名為例：在編輯器中，手動添加以下索引值對，可以將my_web.com 替換為您的實際網域名稱。
    說明
    CONSOLE_API_URL，CONSOLE_WEB_URL，APP_WEB_URL僅支援Dify帳號版/企業版修改。
```
{
  "HTTP_REQUEST_NODE_MAX_TEXT_SIZE": "1048576",
  ...
  "CONSOLE_API_URL": "http://my_web.com",
  "APP_API_URL": "http://my_web.com",
  "CONSOLE_WEB_URL": "http://my_web.com",
  "APP_WEB_URL": "http://my_web.com",
  "FILES_URL": "http://my_web.com"
}
```
完成修改後，點擊儲存，並在彈出的選項框中點擊確認。
儲存後，系統將開始重新部署執行個體。
- 成功狀態：
  在右下角看到環境參數校正成功，環境參數更新成功，重新部署已開始三個欄位則說明環境變數修改成功，Dify執行個體開始重啟。
- 失敗狀態：
  若出現Env key 'xxxx' is invalid，則說明對應的鍵xxxx有誤，請仔細檢查該鍵是否在白名單內以及鍵的拼字是否有誤。

支援的環境變數列表

參數名	預設值	描述
`CODE_MAX_STRING_LENGTH`	800000	代碼節點中輸出字串的最大長度限制
`TEMPLATE_TRANSFORM_MAX_LENGTH`	800000	模板轉換中字串的最大長度限制
`CODE_MAX_STRING_ARRAY_LENGTH`	1000	代碼節點中輸出字串數組的最大元素個數
`CODE_MAX_OBJECT_ARRAY_LENGTH`	1000	代碼節點中輸出對象數組的最大元素個數
`CODE_MAX_NUMBER_ARRAY_LENGTH`	1000	代碼節點中輸出數字數組的最大元素個數
`CODE_MAX_DEPTH`	5	代碼節點中輸出對象/數組的最大嵌套深度
`CODE_MAX_PRECISION`	20	代碼節點中數位最大精度（小數位元）
`SQLALCHEMY_POOL_SIZE`	60	資料庫連接池的大小（最大串連數）
`SQLALCHEMY_POOL_RECYCLE`	3600	資料庫連接回收時間（秒），超過此時間串連將被重建
`PLUGIN_MAX_PACKAGE_SIZE`	52428800	外掛程式安裝包的最大允許大小（位元組）
`GUNICORN_TIMEOUT`	360	等待響應的最長時間（秒）。如果一個請求超過這個時間還沒完成，就會被強制終止
`UPLOAD_FILE_SIZE_LIMIT`	50	單個上傳檔案的最大大小（MB）
`UPLOAD_FILE_BATCH_LIMIT`	10	單次批量上傳的最大檔案數量
`HTTP_REQUEST_NODE_MAX_TEXT_SIZE`	1048576	HTTP 要求節點文本響應的最大大小（位元組）
`HTTP_REQUEST_NODE_MAX_BINARY_SIZE`	10485760	HTTP 要求節點二進位響應的最大大小（位元組）
`CONSOLE_API_URL`	dms帳號登入： https://dify-{region，例如cn-beijing}-dms.aliyuncs.com dify帳號登入或企業版： http:// + 申請的 alb 公網ip	控制台後端 API 的訪問地址，僅支援Dify帳號版/企業版修改
`APP_API_URL`		應用程式 API 的訪問地址
`CONSOLE_WEB_URL`		控制台前端 Web 的訪問地址，僅支援Dify帳號版/企業版修改
`APP_WEB_URL`		應用程式前端 Web 的訪問地址，僅支援Dify帳號版/企業版修改
`FILES_URL`		檔案服務的訪問地址
`DIFY_BACKWARDS_INVOCATION_WRITE_TIMEOUT`	60000	外掛程式反向調用寫操作逾時時間
`DIFY_BACKWARDS_INVOCATION_READ_TIMEOUT`	60000	外掛程式反向調用讀操作逾時時間
`PYTHON_ENV_INIT_TIMEOUT`	320	外掛程式 Python 環境初始化逾時時間（秒）
`TOP_K_MAX_VALUE`	50	知識庫檢索 Top-K 的最大允許值
`TEXT_GENERATION_TIMEOUT_MS`	60000	文本產生請求的逾時時間（毫秒）
`LOOP_NODE_MAX_COUNT`	100	迴圈節點的最大迭代次數
`MAX_TOOLS_NUM`	10	Agent 可使用的最大工具數量
`MAX_PARALLEL_LIMIT`	10	並存執行節點的最大並發數
`MAX_ITERATIONS_NUM`	99	迭代節點的最大迭代次數
`MAX_TREE_DEPTH`	50	工作流程中從開始到結束的最長節點鏈路長度
`SERVICE_API_URL`	空	API 服務的訪問地址
`TRIGGER_URL`	空	工作流程觸發器的回調地址
`FILES_ACCESS_TIMEOUT`	300	檔案訪問操作的逾時時間（秒）
`HTTP_REQUEST_MAX_CONNECT_TIMEOUT`	300	HTTP 要求建立串連的最大逾時時間（秒）
`HTTP_REQUEST_MAX_READ_TIMEOUT`	600	HTTP 要求讀取響應的最大逾時時間（秒）
`HTTP_REQUEST_MAX_WRITE_TIMEOUT`	600	HTTP 要求寫入資料的最大逾時時間（秒）
`CODE_EXECUTION_CONNECT_TIMEOUT`	10	代碼執行服務串連的逾時時間（秒）
`CODE_EXECUTION_READ_TIMEOUT`	60	代碼執行結果讀取的逾時時間（秒）
`CODE_EXECUTION_WRITE_TIMEOUT`	10	代碼執行資料寫入的逾時時間（秒）
`ACCESS_TOKEN_EXPIRE_MINUTES`	60	存取權杖的到期時間長度（分鐘）
`APP_MAX_ACTIVE_REQUESTS`	0	應用同時處理的最大請求數（0 表示無限制）
`APP_MAX_EXECUTION_TIME`	1200	應用單次執行的最大時間長度（秒）
`ENABLE_SOCIAL_OAUTH_LOGIN`	false	是否啟用社交帳號 OAuth 登入
`ALLOW_REGISTER`	false	是否允許使用者註冊
`ALLOW_CREATE_WORKSPACE`	false	是否允許建立新工作空間
`GOOGLE_CLIENT_ID`	空	Google OAuth 應用的用戶端識別碼
`GOOGLE_CLIENT_SECRET`	空	Google OAuth 應用的用戶端密鑰
`GITHUB_CLIENT_ID`	空	GitHub OAuth 應用的用戶端識別碼
`GITHUB_CLIENT_SECRET`	空	GitHub OAuth 應用的用戶端密鑰
`ENABLE_EMAIL_PASSWORD_LOGIN`	true	是否允許郵箱密碼登入
`ALLOWED_OAUTH_DOMAINS`	空	允許通過 OAuth 登入的網域名稱列表（多個網域名稱以逗號分隔）
`ARMS_ENABLE`	false	是否接入 ARMS 應用即時監控
`ARMS_DIFY_API_APP_NAME`	空	`dify-api` 組件在 ARMS 監控平台的應用程式名稱
`ARMS_DIFY_PLUGIN_APP_NAME`	空	`dify-plugin-daemon` 組件在 ARMS 監控平台的應用程式名稱
`ARMS_DIFY_SANDBOX_APP_NAME`	空	`dify-sandbox` 組件在 ARMS 監控平台的應用程式名稱
`ARMS_REGION_ID`	空	接入 ARMS 監控的地區 ID（如 `cn-hangzhou`）
`ARMS_LICENSE_KEY`	空	接入 ARMS 監控所需的 License Key