自托管试用

概述

自托管试用版可在自托管环境中提供 TinyMCE 高级插件的访问权限。集成人员可选择在试用期间连接至 Tiny Cloud 服务，以评估拼写检查器专业版 (Spell Checker Pro)、导出为 PDF 和 TinyMCE AI 等服务器端功能，而无需单独部署服务器端环境或添加额外脚本。连接云服务是可选的。将 online_license_services_opt_in 选项设置为 true 即可启用连接。若未设置此选项，编辑器已获得许可并可正常运行，但依赖云服务的 premium 插件不会自动配置。

仅新客户可启动自托管试用。有关试用时长和权益详情，请参阅 Tiny Cloud Account 门户。

前置条件

• 拥有有效试用的 TinyMCE 账户。请前往 Get TinyMCE 注册。

• 来自客户门户“自托管 (Self-hosted)"标签页的试用许可证密钥。

• 已安装 Node.js（及 npm）。

• 包含 package.json 文件的项目目录。如需初始化，请运行 npm init。

• 安全上下文：页面必须通过 HTTPS 提供，或从 localhost 提供。试用许可证密钥需要安全上下文才能完成密钥验证。

设置

步骤 1：安装 TinyMCE 和高级插件

同时安装核心编辑器和高级插件包：

npm install tinymce@^8 tinymce-premium@^8

步骤 2：使用试用许可证密钥配置编辑器

使用 license_key 选项将试用许可证密钥添加到 TinyMCE 配置中。将 online_license_services_opt_in 设置为 true 可使编辑器连接至 Tiny Cloud 服务，从而在试用期间自动配置依赖云服务的 premium 插件：

tinymce.init({
  selector: 'textarea',  // change this value according to the HTML
  license_key: 'your-trial-license-key',  // trial license key from the Self-hosted tab
  plugins: [
    'advlist', 'autolink', 'lists', 'link', 'image', 'charmap', 'preview',
    'anchor', 'searchreplace', 'visualblocks', 'code', 'fullscreen',
    'insertdatetime', 'media', 'table', 'help', 'wordcount',
    'tinymcespellchecker', 'exportpdf', 'exportword', 'importword',
    'linkchecker', 'mediaembed', 'editimage', 'autocorrect', 'tinymceai'
  ],
  toolbar: 'undo redo | blocks | bold italic | alignleft aligncenter alignright | bullist numlist outdent indent | help',
  online_license_services_opt_in: true,
  tinymceai_token_provider: async () => {  // 'no-api-key' is replaced with the Cloud API key once the account is created
    await fetch(`https://demo.api.tiny.cloud/1/no-api-key/auth/random`, { method: 'POST', credentials: 'include' });
    return await fetch(`https://demo.api.tiny.cloud/1/no-api-key/jwt/tinymceai`, { credentials: 'include' })
      .then(resp => resp.text())
      .then(token => ({ token }));
  }
});

将 'your-trial-license-key' 占位符替换为从客户门户的自托管 (Self-hosted) 标签页颁发的试用许可证密钥。令牌提供者 URL 使用 no-api-key，这是客户门户Cloud 标签页上可见的 Cloud API 密钥。访问客户门户后，该占位符会自动替换为 Cloud API 密钥。

若未设置 online_license_services_opt_in，试用许可证密钥仍会验证，编辑器也保持完全可用，但依赖云服务的插件（如拼写检查器专业版、链接检查器和导出为 PDF）不会自动配置，并报告其服务 URL 未设置。

将 online_license_services_opt_in 设置为 true 可启用编辑器到 Tiny Cloud 的网络连接。可随时移除该选项或将其设置为 false 以禁用云服务连接。

大多数云赋能插件在将 online_license_services_opt_in 设置为 true 后即可自动工作。部分插件需要额外配置。例如，TinyMCE AI 需要一个 tinymceai_token_provider 函数，如上所示使用试用演示身份服务。令牌提供者 URL 使用 no-api-key，一旦账户创建完成，该占位符会自动替换为客户门户Cloud 标签页中的试用 API 密钥。这与试用许可证密钥是分开的密钥。详情请参阅 TinyMCE AI 试用演示身份服务。请查阅所用每个插件的文档，了解其所需的任何额外设置。

步骤 3：确保许可证密钥管理器可用

tinymce-premium NPM 包包含许可证密钥管理器。若对 TinyMCE 进行打包，请确保导入许可证密钥管理器：

import 'tinymce-premium/plugins/licensekeymanager';

对于托管设置，请确保 licensekeymanager 文件夹存在于 plugins 目录中，与其他所有插件并列。更多详情，请参阅 设置商业许可证密钥管理器。

云赋能功能

以下高级功能需要连接至 Tiny Cloud 服务，仅在将 online_license_services_opt_in 设置为 true 时才能正常运行：

包含在 tinymce-premium 包中的所有其他高级插件在试用期间无需云连接即可正常运行。

有关试用中包含的全部功能列表，请参阅 Tiny Cloud Account 门户。

网络要求

启用 online_license_services_opt_in 时，编辑器将连接至 *.api.tiny.cloud 上的 Tiny Cloud 服务。如果网络使用正向代理或防火墙，请确保允许该域名模式用于出站 HTTPS 访问。

有关详细的内容安全策略 (CSP) 配置，请参阅 TinyMCE 和内容安全策略。

试用限制

试用结束后

要在试用期满后继续使用 TinyMCE：

• 购买商业许可证： 访问 TinyMCE 定价 选择计划。商业许可证密钥将提供给持续的自托管使用。

• 自托管高级服务： 对于拼写检查、导出为 PDF 和从 Word 导入等功能的生产环境使用，请自托管所需的服务器端服务或使用 Tiny Cloud 计划。有关自托管选项，请参阅 高级服务器端服务。

常见问题解答