许可证

一份许可证同时用于 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.