云端部署

概述

tracio.ai 是一个完全托管的云平台。你的应用从浏览器发送信号，云端返回识别结果。平台负责处理扩缩容、冗余和基础设施管理。

上手只需几分钟：创建账户、获取公钥、安装 SDK，然后开始识别访客。

仅提供托管云。 TRACIO 不提供自托管或本地部署（on-premise）——没有可安装的服务端组件。你能控制的是流量所在的数据区域（见下文）；如果希望从自有域名分发 agent，可以通过 endpoint / scriptUrl 选项，在托管端点前放置一层第一方代理。

工作原理

你的应用通过客户端 JavaScript SDK 与云端通信。SDK 会在浏览器中加载一个 agent，采集信号，并返回识别结果：

Browser (JS SDK)  ──▶  tracio.ai Cloud
                  ◀──  (identification result)

1. 浏览器 SDK 加载 agent 并采集信号。
2. 信号被发送到 tracio.ai 云端。
3. 云端返回结果：visitorId 和 bot 信息。

若要在自己的服务器上对结果做出响应，可将每次识别作为经过签名的 webhook 接收，或通过 Data API 按需读取。

快速开始

1. 注册并打开你的控制台。
2. 选择你的数据区域（见下文）。
3. 复制你的公钥——它可以安全地随客户端代码一起发布。
4. 安装 SDK 并初始化：

import { Tracio } from "@tracio/sdk"

const tracio = Tracio.init({
  publicKey: "5ca175fc...",
  region: "eu",
})

数据区域

SDK 的 region 选项用于选择 SDK 与哪个数据区域通信。它接受 "us" 或 "eu"。若未设置，SDK 会使用通用的 https://edge.tracio.ai 端点——显式设置该选项即可固定到某个区域。

API 密钥管理

你的工作区使用两种密钥，二者不可互换：

• 两种密钥都在控制台的 API Keys 中创建和管理。私密密钥需要 Pro 及以上套餐。
• 私密密钥在创建时只显示一次——我们这边只保存哈希。一旦丢失就无法找回，只能轮换。
• 轮换私密密钥后，上一把密钥仍可继续使用 7 天，方便你无停机上线。公开密钥不做轮换：它不是机密，按设计就会出现在页面源码中。

在服务器端获取结果有两种方式，二者可以很好地配合：

• 配置 webhook——每次识别都会投递到你的端点，并使用 X-Tracio-Signature 签名。
• 用私密密钥调用 Data API，按需读取访客历史、单次会话或 velocity 计数。

Webhooks

你可以配置 webhook，把云端的识别事件接收到自己的服务器上。webhook 从 Pro 套餐起可用——有关配置、payload 与签名校验的详情，请参阅 Webhooks。