将本地WordPress连接到云服务
云网关将您的 WordPress 安装与 LemonX 服务连接起来，以实现许可、权利、AI 路由和高级产品功能。
LemonX 开发者·云网关
适用于 WordPress AI 增长工作流程的安全云层。
LemonX 云网关将 WordPress 网站与运行高级 AI、许可、产品权利、使用跟踪、安全更新和高级 LemonX 工作流程所需的云驱动服务连接起来。
它为开发人员提供了自托管 WordPress 站点和 LemonX 云服务之间的受控桥梁，而无需强制每个敏感操作直接位于 WordPress 数据库内。
站点绑定 · 许可证感知 · 使用情况跟踪 · 专为安全 WordPress AI 工作流程而构建
什么是LemonX云网关？
LemonX 云网关是安全服务层，可帮助 LemonX 驱动的 WordPress 站点与 LemonX 云基础设施进行通信。它可以支持许可证验证、计划权利、AI 网关路由、使用配额、安全更新检查、高级功能访问、机构站点管理和企业级控制。
对于开发人员来说，云网关提供了一种可预测的方式，将本地 WordPress 功能与基于云的功能连接起来，同时保留权限检查、站点身份、产品访问和使用可见性。
保持功能访问控制
可以根据许可证状态、计划级别、站点身份和启用的模块检查产品访问权限。
跟踪跨产品的使用情况
可以测量和控制 AI 调用、翻译量、索引请求、MCP 操作、报告生成和云任务。
支持可扩展的产品工作流程
机构、开发人员和企业团队可以跨一个站点或多个站点管理高级工作流程。
为什么这很重要
高级 AI 工作流程需要的不仅仅是本地插件设置。
普通的 WordPress 插件可以存储选项、渲染管理页面并运行本地 PHP 代码。但 AI 支持的增长套件需要更多：许可证验证、使用控制、AI 提供商路由、基于计划的权利、安全更新交付、基于云的处理、多站点帐户感知和可靠的服务编排。
云网关提供了这个缺失的层。
不带云网关
- 许可证状态可能难以验证。
- 高级功能很难跨计划控制。
- 使用情况跟踪变得支离破碎。
- AI 提供者路由必须在本地处理。
- 机构无法轻松管理多个站点。
- 安全更新和高级访问变得更难执行。
- 企业工作流程需要太多的自定义基础设施。
使用LemonX云网关
- 可以安全地验证许可证。
- 可以在功能运行之前检查产品权利。
- 可以跨模块测量使用情况。
- AI 和翻译请求可以通过受控服务进行路由。
- 机构可以管理多站点工作流程。
- 开发人员可以构建可预测的云连接集成。
- 企业团队可以应用更强大的治理和访问控制。
建筑
云网关如何融入 LemonX 生态系统。
LemonX 云网关位于本地 WordPress 站点和 LemonX 云服务之间。它不会取代 WordPress。它通过安全、计划感知、云连接功能扩展了 WordPress。
架构流程
- WordPress 网站
- LemonX 插件
- 本地身份验证和权限
- 云网关请求
- 站点身份验证
- 许可证和权利检查
- 使用情况和配额检查
- 云服务执行
- 回复 WordPress
- 本地结果、日志或任务更新
核心组件
本地 WordPress 插件层
在 WordPress 内部运行并处理本地管理 UI、设置、内容工作流程、权限、REST API、MCP 工具和模块逻辑。
认证层
在发出请求之前验证本地用户、站点令牌、API 密钥、MCP 会话或网关凭据。
站点身份层
确认哪个 WordPress 站点正在与网关通信以及是否获得授权。
许可和权利层
检查网站是否有权访问请求的产品和高级功能。
使用层
记录和限制 AI 调用、翻译使用、索引操作、云操作和其他测量事件。
云服务层
提供先进的 LemonX 服务，例如 AI 路由、安全更新验证、高级处理和企业工作流程。
响应和日志层
返回对 WordPress 的结构化响应并记录重要操作以实现可见性、调试和可审核性。
职责
责任1
责任2
责任3
责任4
责任5
责任6
责任7
云网关可以处理什么。
许可证验证
确认网站是否可以使用 LemonX 高级功能。
云网关可以验证 WordPress 站点是否具有有效的 LemonX 许可证、许可证是否处于活动状态、站点是否绑定到许可证以及当前计划是否允许请求的功能。
检查示例
- 许可证密钥有效性
- 许可证激活状态
- 站点绑定状态
- 计划级别
- 产品接入
- 有效期
- 续订状态
- 代理席位分配
- 企业账户状态
使用案例
- 激活 LemonX Pro。
- 检查 AEO Pro 功能是否可用。
- 验证机构站点分配。
- 许可证过期时禁用高级功能。
- 显示 WordPress admin 内的许可证状态。
- 防止未经授权使用付费功能。
产品权利
确定每个站点可以使用哪些功能。
权利定义了站点、许可证、计划或帐户允许使用的内容。云网关可以帮助 LemonX 模块确定是否应启用特定功能。
检查示例
- AEO Pro 已启用
- Code Pro 已启用
- Verto Pro 已启用
- MCP Pro 已启用
- 启用高级报告
- AI 网关访问已启用
- 启用翻译队列访问
- 启用代理多站点功能
- 启用企业策略控制
- 已启用优先支持
使用案例
- 显示或隐藏产品功能。
- 启用高级 AEO 报告。
- 按计划控制翻译量。
- 限制 MCP 将工具应用于 Pro 计划。
- 解锁机构仪表板。
- 启用企业安全控制。
使用情况和配额跟踪
衡量 AI、翻译和自动化工作流程中的产品使用情况。
云网关可以记录并返回使用数据，以便用户和开发人员了解产品限制的消耗情况。
检查示例
- AI 生成请求
- AI 代币或积分
- 翻译字符
- 翻译任务
- 索引提交内容
- MCP 工具调用
- MCP 应用操作
- OCR 处理
- 报告生成
- 云 API 调用
- Webhook 交付
- 后台任务
使用案例
- 在 WordPress 仪表板中显示剩余使用情况。
- 在达到配额之前警告用户。
- 防止自动化失控。
- 帮助机构监控客户的使用情况。
- 支持基于使用情况的计费或计划限制。
- 调试异常高的 AI 消耗。
AI 网关路由
通过受控的提供者逻辑路由 AI 请求。
云网关可以根据产品上下文、计划级别、使用限制、后备规则和可用性，帮助将 AI 请求路由到支持的模型和提供商。
检查示例
- 使用快速模型进行草稿。
- 对最终内容使用更强大的模型。
- 使用成本较低的提供商来执行批量任务。
- 当失败时使用后备提供程序。
- 按计划阻止不受支持的提供商。
- 通过批准的提供商传递企业请求。
- 在响应之前应用安全或格式化策略。
使用案例
- 集中模型管理。
- 降低本地 API 密钥复杂性。
- 应用提供商后备链。
- 控制 AI 成本。
- 提供基于计划的模型访问。
- 提供企业认可的AI路线。
安全更新
支持受信任的插件和主题更新工作流程。
云网关可以帮助验证更新资格、提供高级更新元数据并确保许可用户收到适当的插件和主题更新。
检查示例
- 产品许可状态
- 安装版本
- 最新可用版本
- 计划权利
- 更新频道
- 安全版本可用性
- 测试版访问
- Theme 更新资格
使用案例
- 提供 LemonX Pro 更新。
- 提供高级功能补丁。
- 支持选定用户的测试版频道。
- 控制机构更新访问。
- 验证安全更新元数据。
- 降低未经授权的分销风险。
机构多站点管理
帮助机构管理许多客户网站。
机构通常管理多个 WordPress 站点。云网关可以提供共享帐户层，用于跟踪跨客户端属性的站点激活、许可证、使用情况、权利和产品访问。
检查示例
- 帐户站点
- 执照席位
- 产品激活状态
- 站点健康状态
- 按网站使用情况
- 客户级报告
- 按网站划分的权利
- 网关连接状态
- 计划限制
使用案例
- 在许多客户端站点上激活 LemonX。
- 监控跨帐户的使用情况。
- 准备客户报告。
- 管理机构席位。
- 检测断开连接的站点。
- 控制哪些站点可以使用高级模块。
企业治理
支持更严格的安全、策略和控制要求。
企业团队可能需要对 AI 提供商、使用、权限、云连接和可审核性进行更强有力的控制。云网关可以支持超出正常插件设置的企业治理功能。
检查示例
- 批准的 AI 提供商
- 团队级别的权利
- 使用上限
- 政策执行
- 审核导出
- SLA 感知路由
- 私有云选项
- 自定义账户规则
- 高级支持访问
使用案例
- 将 AI 提供商的使用限制为经批准的服务。
- 应用组织级别的内容规则。
- 管理多个业务部门。
- 导出审核数据。
- 支持合规工作流程。
- 创建企业级WordPress AI治理。
请求生命周期
1 2 3 4 5 6 7 8 9
当WordPress调用云网关时会发生什么？
本地工作流程启动
LemonX 模块启动云连接操作，例如许可证验证、AI 路由、使用同步或权利检查。
本地权限检查运行
WordPress 验证本地用户、能力、随机数、API 密钥、MCP 上下文或后台任务权限。
网关请求已签名
该插件准备一个包含站点身份、产品上下文、功能请求和身份验证数据的请求。
网关验证站点身份
云网关确认请求来自认可且授权的站点。
运行许可证和权利检查
网关验证是否允许站点、计划和产品使用所请求的功能。
运行使用情况和配额检查
网关检查请求的操作是否在允许的使用限制内。
云操作执行
执行请求的云连接操作。
结构化响应返回
网关返回成功、数据、任务ID、使用更新或错误信息。
WordPress 存储结果或日志
本地插件更新管理 UI、任务状态、报告、使用面板或活动日志。
网关API
面向网关的资源示例。
以下端点是面向开发人员的示例，描述了云网关可能公开或支持的资源类型。最终端点名称应与活动的 LemonX 实现匹配。
许可端点
POST /gateway/v1/license/activate POST /gateway/v1/license/deactivate GET /gateway/v1/license/status POST /gateway/v1/license/refresh
权利端点
GET /gateway/v1/entitlements POST /gateway/v1/entitlements/check GET /gateway/v1/products GET /gateway/v1/features
使用端点
POST /gateway/v1/usage/record GET /gateway/v1/usage/summary GET /gateway/v1/usage/limits GET /gateway/v1/usage/history
AI 网关端点
POST /gateway/v1/ai/generate POST /gateway/v1/ai/route GET /gateway/v1/ai/providers GET /gateway/v1/ai/models
站点端点
POST /gateway/v1/sites/register GET /gateway/v1/sites/status POST /gateway/v1/sites/sync POST /gateway/v1/sites/disconnect
更新端点
GET /gateway/v1/updates/check GET /gateway/v1/updates/package POST /gateway/v1/updates/verify
代理端点
GET /gateway/v1/agency/sites GET /gateway/v1/agency/usage GET /gateway/v1/agency/entitlements GET /gateway/v1/agency/reports
本地 API
WordPress 如何在本地公开云网关状态。
开发人员还可以通过 WordPress 内的 LemonX 本地 REST API 端点访问与网关相关的状态。这些端点可以帮助管理仪表板、代理工具和集成检查网关状态，而无需直接调用云。
本地端点示例
GET /wp-json/lemonx/v1/pro/cloud/status GET /wp-json/lemonx/v1/pro/license GET /wp-json/lemonx/v1/pro/entitlements GET /wp-json/lemonx/v1/pro/usage POST /wp-json/lemonx/v1/pro/license/activate POST /wp-json/lemonx/v1/pro/license/deactivate POST /wp-json/lemonx/v1/pro/cloud/sync
使用案例
- 在 WordPress admin 中显示许可证状态。
- 显示剩余的 AI 或翻译用法。
- 检查 Pro 功能是否可用。
- 调试云网关连接。
- 计划更改后刷新权利。
- 根据本地站点数据构建机构仪表板。
认证
云网关请求必须验证站点和帐户。
云网关身份验证应确认本地站点身份、帐户/许可证状态和请求完整性。网关不应仅依赖于用户提供的数据。
推荐的认证信号
推荐控制
- 对每个网关请求使用 HTTPS。
- 签署敏感请求。
- 包含时间戳以降低重放风险。
- 尽可能将令牌绑定到站点身份。
- 需要时轮换令牌。
- 不要向前端 JavaScript 公开网关令牌。
- 记录失败的身份验证尝试。
- 在执行高级操作之前验证权利。
权利模式
在运行高级工作流程之前检查访问权限。
流程示例
- 用户启动高级 LemonX 操作。
- WordPress 检查本地权限。
- LemonX 检查产品模块是否处于活动状态。
- WordPress 从云网关请求权利状态。
- 网关验证许可证、计划和站点身份。
- 网关返回允许或拒绝。
- WordPress 运行操作或显示升级/访问消息。
- 在适当的地方记录结果。
响应示例：允许
{
"success": true,
"entitlement": {
"feature": "aeo.ai_citation_tracking",
"allowed": true,
"plan": "agency",
"expires_at": "2027-07-04T00:00:00Z"
}
}响应示例：拒绝
{
"success": false,
"error": {
"code": "entitlement_required",
"message": "This feature requires LemonX AEO Pro.",
"required_plan": "pro"
}
}
使用情况追踪
跟踪使用情况而不减慢工作流程。
使用情况跟踪应该是可靠的，但它不应该使用户体验变慢或脆弱。一些使用事件可以同步记录，而另一些则可以排队并批量同步。
使用事件示例
{
"event": "ai.generation.completed",
"site_id": "site_123",
"product": "code",
"feature": "page_generation",
"model": "premium-model",
"units": 1,
"tokens_input": 2400,
"tokens_output": 1800,
"timestamp": "2026-07-04T10:00:00Z"
}推荐使用类别
最佳实践
- 批量低风险使用记录。
- 立即记录高成本行为。
- 向管理员显示使用情况。
- 在达到限制之前发出警告。
- 避免重复的使用记录。
- 存储请求 ID 以供调试。
- 允许非关键同步事件正常失败。
AI 路由
通过产品感知逻辑路由 AI 请求。
不同的 LemonX 工作流程可能需要不同的 AI 模型。批量翻译任务、AEO 分析、页面生成请求和 MCP 内容编辑可能不需要相同的提供商、速度、成本或质量水平。
云网关可以支持产品感知的 AI 路由。
路由规则示例
- AEO 分析使用推理优化模型。
- 批量草稿生成使用经济高效的模型。
- 最终着陆页生成使用更高质量的模型。
- 翻译使用语言优化的提供商。
- 企业帐户仅使用经过批准的提供商。
- 如果一个提供程序失败，请使用配置的后备。
- 如果配额较低，则阻止或降级选定的工作流程。
开发人员用例
- 集中 AI 模型选择。
- 避免在本地公开提供者密钥。
- 应用成本控制规则。
- 支持后备提供商。
- 执行企业提供商政策。
- 按产品监控 AI 使用情况。
安全更新
高级软件更新需要可靠的交付。
LemonX Pro 和高级产品模块可能需要安全更新检查。云网关可以帮助验证站点是否允许接收特定的更新包或发布通道。
更新频道
- 稳定
- 安全发布
- 贝塔
- 代理预览
- 企业控制的推出
更新检查
- 当前安装的版本
- 产品许可状态
- 网站授权
- 计划权利
- 释放通道访问权限
- 兼容性要求
- 更新包签名
- 安全发布优先级
使用案例
- 向许可用户提供产品更新。
- 为选定的帐户提供测试版访问权限。
- 允许机构在广泛推出之前测试更新。
- 优先考虑安全发布。
- 防止未经授权的高级下载。
- 支持企业更新控制。
代理工作流程
云网关帮助机构管理许多 WordPress 站点。
使用案例 1：多站点许可证管理
代理机构可以在一个帐户下连接多个客户端站点，并监控激活状态、计划访问和产品可用性。
用例 2：客户的使用情况可见性
各机构可以了解哪些网站使用最多 AI、翻译、索引或 MCP 活动。
用例 3：客户报告
云网关可以支持集中报告访问，帮助机构展示SEO、翻译、MCP和增长活动。
用例 4：座位分配
机构可以跨客户网站分配许可证席位或产品访问权限。
用例 5：批量授权刷新
当代理计划发生变化时，连接的站点可以通过云网关刷新权利。
用例 6：站点运行状况监控
机构可以检测断开连接的站点、过期的许可证、失败的同步或使用警告。
企业工作流程
云网关可以支持大型团队的治理。
使用案例 1：批准的 AI 提供商政策
企业帐户可以定义允许哪些 AI 提供商。
用例 2：按团队或站点划分的使用上限
组织可以按部门、站点或项目限制AI、翻译或云的使用。
用例 3：审核导出
企业团队可以导出日志以进行安全审查和合规性工作流程。
用例 4：私有或受限路由
某些计划可能会通过批准的基础设施路由 AI 或云工作流程。
用例 5：中央权限控制
管理员可以跨多个属性启用或禁用产品功能。
用例 6：优先支持和 SLA 上下文
网关可以帮助确定计划级别、支持优先级和服务上下文。
错误处理
云网关响应应该清晰且可操作。
| 错误 Code | 含义 | 建议采取的行动 |
|---|---|---|
| 网关不可用 | 网关无法到达 | 稍后重试或检查连接 |
| 无效站点 | 网站标识缺失或无效 | 重新连接站点 |
| 许可证_无效 | 许可证密钥无效 | 检查许可证 |
| 许可证_过期 | 许可证已过期 | 更新许可证 |
| 权利要求 | 功能不包含在计划中 | 升级计划 |
| 超出配额 | 达到使用限制 | 升级或等待重置 |
| 签名无效 | 请求签名失败 | 检查令牌和请求签名 |
| 令牌_过期 | 网关令牌已过期 | 刷新令牌 |
| 产品_非活动状态 | 所需产品未激活 | 启用产品 |
| 提供商不可用 | AI 提供商路由失败 | 重试或使用后备 |
| 不允许更新 | 网站无法访问更新 | 检查许可证和渠道 |
| 速率限制 | 请求太多 | 降低请求频率 |
最佳实践：错误消息应该帮助开发人员解决问题而不暴露敏感信息。
健康检查
从WordPress监控云网关状态。
开发人员和网站所有者需要了解云网关是否已连接并正常运行。运行状况检查有助于诊断许可、权利、更新、使用和 AI 网关问题。
推荐健康领域
健康反应示例
{
"success": true,
"gateway": {
"connected": true,
"last_sync": "2026-07-04T10:00:00Z",
"license": "active",
"entitlements": "synced",
"usage": "synced",
"cloud_token": "valid"
},
"products": {
"aeo": "active",
"code": "active",
"verto": "active",
"MCP": "active",
"pro": "active"
}
}
最佳实践
安全地构建云网关工作流程。
最佳实践 1：切勿在前端代码中公开网关令牌
网关凭据只能在服务器端使用。
最佳实践 2：验证站点身份
不要仅依赖域名。尽可能使用站点绑定身份。
最佳实践 3：签署敏感请求
使用请求签名来执行许可证、权利、使用和安全更新操作。
最佳实践 4：工作开始前检查权利
在验证访问权限之前避免运行昂贵的任务。
最佳实践 5：仔细跟踪使用情况
防止自动化失控和意外成本。
最佳实践 6：明智地使用重试逻辑
重试暂时性网关错误，但避免无限循环。
最佳实践 7：优雅地失败
如果非关键网关同步失败，请保持管理 UI 可用并显示明确的警告。
最佳实践 8：记录请求 ID
使用请求 ID 跨 WordPress 和云服务调试问题。
最佳实践 9：分离演出和制作
暂存站点应使用单独的身份、使用记录和更新渠道。
最佳实践 10：尊重隐私
仅发送请求的云工作流程所需的数据。
隐私
仅发送云服务需要的内容。
云网关应围绕数据最小化进行设计。某些工作流程仅需要许可证和站点元数据。其他人可能需要 AI 提示数据、翻译内容或使用详细信息。开发人员应该了解每个工作流程发送的内容。
可能需要的数据
- 站点ID
- 域名
- 插件版本
- 许可证密钥哈希或令牌
- 产品激活状态
- 功能请求
- 使用事件
- 任务状态
- AI 使用云时的提示或内容 AI
- 使用云翻译时翻译文本
- 用于调试的错误上下文
除非需要，否则不应发送的数据
- 原始数据库转储
- 不相关的用户数据
- 本地存储的付款详细信息
- 私有 API 密钥
- 密码
- 敏感个人数据
- 不相关的客户记录
开发者推荐：对于每个网关连接的工作流程，记录发送的数据、为什么需要这些数据以及如何保护这些数据。
比较
工作流程何时应使用云网关？
仅本地工作流程
最好是任务可以完全在 WordPress 内完成。
- 管理界面渲染
- 本地设置存储
- 简单的内容编辑
- 本地模板选择
- 本地钩子执行
- 基本只读操作
云网关工作流程
当任务需要帐户、许可证、云、使用情况或高级服务上下文时最好。
- 许可证验证
- 产品权利检查
- AI 网关路由
- 使用情况追踪
- 安全更新
- 高级报告
- 代理现场管理
- 企业政策
摘要：当本地执行足够时，在本地使用 WordPress 。当工作流程需要安全的云连接上下文时，请使用云网关。
示例
通用云网关开发人员工作流程。
示例 1：在展示高级功能之前检查许可证
流量
- 本地管理页面加载。
- WordPress 检查用户权限。
- 插件请求权利状态。
- 云网关确认计划访问。
- UI 显示或隐藏高级功能。
结果：用户只能看到其计划可用的功能。
示例2：记录AI页面生成后的使用情况
流量
- 用户生成一个登陆页面。
- LemonX Code 完成生成。
- 使用事件已创建。
- 云网关记录AI使用情况。
- 仪表板更新剩余配额。
结果：AI 使用保持可见和受控。
示例 3：通过批准的提供商传送翻译
流量
- Verto 对翻译进行排队。
- 云网关检查计划和语言。
- 网关选择提供商路由。
- 翻译任务运行。
- 使用情况被记录。
结果：翻译工作流程遵循计划、语言和提供商规则。
示例 4：验证更新资格
流量
- WordPress 检查 LemonX Pro 更新。
- 云网关验证License和通道。
- 网关返回更新元数据。
- WordPress 通过正常更新流程安装更新。
结果：高级更新仅提供给符合条件的站点。
示例 5：代理账户同步
流量
- 代理机构连接多个客户站点。
- 每个站点都会同步许可证和健康数据。
- 云网关将站点分组到代理账户下。
- 代理仪表板显示状态和使用情况。
结果：机构可以从一个帐户层监控客户站点。
云网关常见问题
什么是LemonX云网关？
云网关是云连接层，支持许可、权利、使用情况跟踪、AI 路由、安全更新和高级 LemonX 工作流程。
每个 LemonX 功能都需要云网关吗？
不需要。许多本地 WordPress 工作流程可以在没有云服务的情况下运行。云网关主要用于许可、Pro、云连接、使用跟踪和高级工作流程。
云网关是否会取代WordPress？
WordPress 仍然是核心站点系统。云网关通过安全的云连接功能扩展了 LemonX。
云网关可以路由AI请求吗？
是的。它可以支持 AI 提供者路由、后备逻辑、基于计划的模型访问和使用跟踪（如果启用）。
云网关是否存储我的网站内容？
它应该仅处理或接收特定云连接工作流程所需的数据。开发人员应记录为每个功能发送的数据。
如果云网关不可用怎么办？
本地特色应尽可能继续。依赖云的功能可能会显示明显的错误，稍后重试或根据配置回退。
机构可以使用云网关吗？
是的。机构可以使用云网关来管理多个客户端站点的许可证席位、站点激活、使用情况、报告和产品权利。
企业可以控制 AI 提供商的使用吗？
企业工作流程可以使用 Cloud Gateway 来执行经批准的提供商策略、使用上限和治理规则（如果支持）。
云网关与 LemonX Pro 有什么关系？
LemonX Pro 是可以解锁许可、权利、云连接功能和高级访问权限的产品层。云网关是可以为这些功能提供支持的服务层。
开发者可以在本地获取网关状态吗？
是的。本地 LemonX REST API 端点可以向授权用户和集成公开许可证、权利、使用情况和云状态。
云网关是 WordPress 控制和云驱动的 AI 功能之间的桥梁。
将 WordPress 保留在应该本地的地方。在许可、权利、使用、AI 路由、安全更新和多站点工作流程需要可信云层的情况下使用云网关。