授權

一份授權同時用於 Web SDK、Collaboration SDK 和 Exchange，依使用位置分別設定。

目前方案、價格與使用額度請見定價頁面。購買問題可使用該頁的聯絡銷售入口；本頁說明取得授權後的設定方式。

前往 Univer 網站了解授權範圍並取得授權。一份授權包含兩個檔案：license.txt 是授權內容，licenseKey.txt 是伺服器端驗證用的金鑰。

使用位置所需檔案未設定時
Web SDKlicense.txt使用免費功能
Collaboration SDKlicense.txt、licenseKey.txt免費版：1 個協同節點、3 個協同編輯連線
Exchangelicense.txt、licenseKey.txt免費版：每月 10 次匯出

設定時填寫檔案內容。授權決定可以使用哪些功能；使用者能否檢視或編輯某份文件，由應用程式的身分與權限決定。

Web SDK

外掛模式

TypeScript
import { UniverLicensePlugin } from '@univerjs-pro/license'univer.registerPlugin(UniverLicensePlugin, {  license: 'YOUR_LICENSE', // license.txt 的內容})

在既有的 Univer 執行個體上註冊 UniverLicensePlugin，並放在其他外掛之前。

預設集模式

TypeScript
UniverSheetsAdvancedPreset({  // 保留其他既有設定  license: 'YOUR_LICENSE', // license.txt 的內容})

在既有的預設集設定中加入 license，以上以 UniverSheetsAdvancedPreset 為例。協同應用程式同樣在瀏覽器中設定授權，協同快速開始的前端範例展示了授權外掛與協同外掛的註冊位置。

Collaboration SDK

TypeScript
import { UniverCollabService } from '@univerjs-pro/collaboration-service'const collabService = new UniverCollabService({  dbAdapter,  license: 'YOUR_LICENSE', // license.txt 的內容  licenseKey: 'YOUR_LICENSE_KEY', // licenseKey.txt 的內容})

省略 license 與 licenseKey 時，UniverCollabService 讀取環境變數 UNIVER_LICENSE 與 UNIVER_LICENSE_KEY；兩處都沒有時以免費版執行。授權決定協同編輯連線數、授權網域、協同節點數和可協同的文件類型，見 Collaboration SDK 授權。

Exchange

TypeScript
import { configureExchange } from '@univerjs-pro/exchange-node'await configureExchange({  license: 'YOUR_LICENSE', // license.txt 的內容  licenseKey: 'YOUR_LICENSE_KEY', // licenseKey.txt 的內容})

這一步可以省略：Exchange 會在首次匯出或額度查詢時讀取環境變數 UNIVER_LICENSE 與 UNIVER_LICENSE_KEY，環境變數也未設定時以免費版執行。Exchange 依授權為匯出計次，匯入不消耗額度，額度查詢與錯誤處理見 Exchange 授權。

Collaboration SDK 與 Exchange 執行在同一程序時，設定一次環境變數即可：

Bash
export UNIVER_LICENSE="$(cat license.txt)"export UNIVER_LICENSE_KEY="$(cat licenseKey.txt)"

設定後檢查

重新開啟應用程式，驗證需要的功能。仍有浮水印或授權限制時，確認授權內容完整、在有效期內，並涵蓋目前功能和版本；外掛模式還需確認 UniverLicensePlugin 註冊在其他外掛之前。仍無法解決時，聯絡授權提供者。

你覺得這篇文檔如何？

© 2026 DreamNum Co., Ltd.