概述

服务许可证密钥用于验证和启用以 Docker 容器形式运行的 Tiny 本地服务。这些密钥与 TinyMCE 编辑器许可证密钥是分开的。

服务许可证密钥和 TinyMCE 编辑器许可证密钥有不同的用途:

  • TinyMCE 编辑器许可证密钥 配置 TinyMCE 编辑器的许可证模式(GPL 或商业版)。详情请参阅许可证密钥。

  • 服务许可证密钥 用于验证基于 Docker 的本地服务,如 TinyMCE AI、导出为 PDF 以及从 Word 导入/导出到 Word 转换器。它们单独配置,并通过 Tiny 客户门户进行管理。

需要服务许可证密钥的服务

以下本地服务需要服务许可证密钥:

其他容器化服务,如拼写检查器、增强媒体嵌入和图像代理,目前不需要服务许可证密钥。这些服务仅使用访问令牌进行 Docker 注册表身份验证。

服务许可证密钥的工作原理

部署 Tiny 本地服务可能涉及两种不同的凭证。这些是不同的值,不能相互替换:

  1. Docker 注册表访问令牌 — 与 docker login 一起使用,以验证 Tiny Docker 注册表并拉取服务镜像。所有 Tiny 本地服务都需要访问令牌来拉取镜像。访问令牌不是服务许可证密钥。

  2. 服务许可证密钥 — 作为 LICENSE_KEY 环境变量传递给运行中的 Docker 容器,以在运行时启用服务。只有在“需要服务许可证密钥的服务”中列出的服务需要服务许可证密钥。没有有效的服务许可证密钥,这些容器将无法启动。

运行 Tiny 本地服务时可能涉及三种不同的凭证。不要混淆它们:

  • TinyMCE 编辑器许可证密钥 — 配置 TinyMCE 编辑器的许可证模式(GPL 或商业版)。请参阅许可证密钥。

  • Docker 注册表访问令牌 — 用于验证 Tiny Docker 注册表以拉取服务镜像。所有本地服务都需要。

  • 服务许可证密钥 — 在运行时启用许可的本地服务。仅某些服务需要。

获取服务许可证密钥

服务许可证密钥通过 Tiny 客户门户进行配置。如需申请试用或讨论服务许可,请联系 Tiny。

使用特定于服务的环境变量

当运行多个本地服务并将其环境变量存储在共享位置时,请为每个服务许可证密钥使用特定于服务的环境变量名称。这可以防止在将服务整合到单个 .env 文件或 Docker Compose 项目中时发生冲突。

每个 Docker 容器内部都期望有 LICENSE_KEY 环境变量。特定于服务的变量名称(如 AI_LICENSE_KEY、PDF_LICENSE_KEY 和 DOCX_LICENSE_KEY)是主机端的约定,在启动容器时映射到 LICENSE_KEY。这些名称是每个服务文档中使用的约定,而不是固定要求。

服务环境变量名称Docker 容器映射

TinyMCE AI

AI_LICENSE_KEY

-e LICENSE_KEY="$AI_LICENSE_KEY"

导出为 PDF

PDF_LICENSE_KEY

-e LICENSE_KEY="$PDF_LICENSE_KEY"

从 Word 导入 / 导出到 Word

DOCX_LICENSE_KEY

-e LICENSE_KEY="$DOCX_LICENSE_KEY"

每个服务许可证密钥都是一个不同的值。例如,在 Docker Compose 中使用的 .env 文件中:

AI_LICENSE_KEY=[your AI license key]
PDF_LICENSE_KEY=[your PDF converter license key]
DOCX_LICENSE_KEY=[your DOCX converter license key]

部署指南

有关完整的设置说明,请参阅每个服务的部署指南:

有关容器化服务器端服务的概述,请参阅 容器化服务器端服务的介绍和初始设置。