Tiny Cloud 是集成 TinyMCE 并升级至高级插件的最简单方式。
Tiny Cloud 无需 API 密钥即可使用。注册一个 API 密钥并更新脚本标签以使用高级插件,或避免编辑器中的开发者警告。
所有 Tiny Cloud 账户均包含免费且预配置的 Tiny Cloud 图像代理服务。此设置使用 图像编辑 插件。
首次集成 TinyMCE
步骤 1:将 Tiny Cloud 脚本标签插入网页
将 TinyMCE 编辑器代码插入应用程序以首次加载 TinyMCE。插入代码的操作是通过在您的应用中添加以下脚本标签完成,对于网页而言,则添加到页面的 <head> 中:
以下示例向应用中添加了一个脚本标签以插入代码。在网页上请使用页面的 <head>。务必将 'no-api-key' 替换为您的 API 密钥。
<script src="https://cdn.tiny.cloud/1/no-api-key/tinymce/8/tinymce.min.js" referrerpolicy="origin" crossorigin="anonymous"></script>
| 值 | 描述 | |
|---|---|---|
1 | no-api-key | 替换为您的 API 密钥 |
2 | origin |
|
3 | anonymous |
|

Tiny Cloud 通过网络请求中的 Referer 头来验证 TinyMCE 加载的域名。有时 Referer 头中的域名与浏览器地址栏中的 URL 不匹配。
要检查 Referer 头,请打开浏览器的 开发者工具 并进入 网络 选项卡。在那里,找到使用您的 API 密钥加载 TinyMCE 的请求,然后点击 标头 选项卡。在名为 请求标头 的部分中,应该有一个 Referer 字段。如果该处的值与您注册的 URL 之一不同,您可能需要调整已注册的 URL 或应用的 Refer 头设置。
步骤 2:加载、自定义并与 TinyMCE 交互
除了 Tiny Cloud 上的高级内容创建解决方案外,还有 29 个开源插件可增强编辑体验。您可以参考一系列 简单示例。有关更多信息,请参阅 快速入门 部分。
步骤 3:指定购买的 TinyMCE 插件和工具栏/菜单项
购买的插件可能需要最多 30 分钟才能在 TinyMCE 中可用。请清除浏览器缓存。
扩展 TinyMCE 配置 以包含任何额外的购买插件及相关工具栏和菜单项。有关每个插件的启用指南,请参阅 高级插件。
使用 Tiny Cloud 时,以下选项的配置会自动进行:
editimage_cors_hosts
editimage_proxy_service_url
export_image_cors_hosts
export_image_proxy_service_url
linkchecker_service_url
mediaembed_service_url
spellchecker_rpc_url
autocorrect_service_url
步骤 4:转发代理和防火墙配置
如果网络具有控制互联网访问的防火墙或转发代理,请确保可以访问以下 URL:
部署编辑器的所有 URL。
部署插件的所有 URL。
*.tiny.cloud— 涵盖所有 Tiny Cloud 服务,包括图像代理、链接检查器、拼写检查器、AI API 和文档转换器。
在请求上述 URL 时,请确保保留 tiny-api-key 和 tinymce-api-key 标头。
有关完整的 Tiny Cloud 服务域名和所需标头列表,请参阅 防火墙和代理白名单。
步骤 5:指定翻译
要使用语言包更改用户界面语言,请使用 语言配置选项。
或者,使用 language_url 配置选项 指定其位置。
从自托管环境迁移到 Tiny Cloud
步骤 1:替换对 tinymce.min.js 的现有引用
从自托管环境迁移到 Tiny Cloud 很简单。删除加载 TinyMCE JavaScript 的现有脚本标签。
脚本标签通常引用托管在应用内或可通过旧版 CDN 获取的 tinymce.min.js。用以下内容替换脚本标签,并确保包含两个必需属性(referrerpolicy 和 crossorigin):
<script src="https://cdn.tiny.cloud/1/no-api-key/tinymce/8/tinymce.min.js" referrerpolicy="origin" crossorigin="anonymous"></script>
迁移到 Tiny Cloud 时,为了实现最佳性能和跨浏览器功能,必须同时使用referrerpolicy="origin"和crossorigin="anonymous"属性。
步骤 2:更新自定义插件路径
引用 external_plugins 以确保自定义插件或修改后的插件继续在 Tiny Cloud 部署中运行。
请勿使用常规的 plugins 配置元素。
步骤 3:指定购买的 TinyMCE 插件和工具栏按钮
扩展 TinyMCE 配置 以包含任何额外的购买插件及相关工具栏和菜单项。有关每个插件的启用指南,请参阅 高级插件。
使用 Tiny Cloud 时,以下选项的配置会自动进行:
editimage_cors_hosts
editimage_proxy_service_url
export_image_cors_hosts
export_image_proxy_service_url
linkchecker_service_url
mediaembed_service_url
spellchecker_rpc_url
autocorrect_service_url