远程数据拉取
一句话理解
本端是"下游",要从"上游"另一个 ThinkLink 部署同步系统内置(PUBLIC)资源到本地。
系统平台 → 高级功能 → 远程数据拉取,用于让 TKG 网关 / TKE / Docker 独立部署 的 ThinkLink 实例,从中心(上游)ThinkLink 部署同步内置的物模型、RPC 模型、联动模型、设备模板、插件。这是分布式部署场景下保持各节点"内置模型库"一致的核心通道。

适用场景
- 现场网关装的是 TKG,但没人手工去维护本地的物模型/插件 → 配好上游地址,定期一键拉取即可。
- 客户私有部署的 TKE,希望复用厂商中心服务器上沉淀的官方模型与设备模板。
- 多个分支独立部署,统一从一个"主站"同步标准化资源。
前置条件:先在上游开放数据拉取
在你打算从中拉数据的那台 上游 ThinkLink 上:
- 用 admin 登录 → 系统平台 → 系统配置 → 网服务配置。
- 打开
允许数据拉取开关。 - 点
秘钥右侧的按钮生成/刷新secret_key,复制下来。
记下上游的 host、端口(默认 80)和这把 secret_key,下一步要用。
本端配置与一键拉取
回到本端的"远程数据拉取"页:
| 字段 | 填法 |
|---|---|
| Remote URL | 协议 (http:// / https://) + Host + 端口;默认 80 |
| tenant_code | 默认 PUBLIC,一般不用改(拉的是上游 PUBLIC 范围资源) |
| secret_key | 粘贴上游生成的秘钥 |
填完后:
- 点
一键拉取—— 一次性把插件、物模型、RPC、联动模型、设备模板五类全部从上游同步过来。 - 也可以展开
高级功能,选择性地只拉某一类:拉取插件拉取物模型拉取 RPC拉取联动模型拉取设备模板拉取设备配置通过本地设备模板拉取设备拉取 LoRaWAN 档案
增量补齐
"高级功能"里的单类拉取按钮,常用于上游临时加了一类新资源时只补这一类,不必整盘重拉。
拉取行为
- 拉到的资源写入本端 PUBLIC 范围,落到对应的"模型管理 / 插件"列表里。
- 同 ID 的资源走"已存在则更新":本端原有的 PUBLIC 记录会被上游版本覆盖。
- 拉的是上游的 PUBLIC 范围,不会拉走上游其他租户的私有模型。
常见问题排查
| 现象 | 可能原因 |
|---|---|
| 请求连接失败 / 超时 | URL/端口写错、上游端口未开放、网络/防火墙不通 |
| 401 / 403 | 上游的 允许数据拉取 没开,或 secret_key 不匹配 |
| 调用成功但本端没新增数据 | 上游 PUBLIC 范围本来就没有这类资源 |
| 某些插件失败 | 上游插件依赖的关联资源(如某个物模型)未一起拉过来;建议优先用"一键拉取"避免依赖错位 |
相关页面
- 上游开放秘钥的位置 → 系统配置 — 网服务配置
- 拉过来的资源落地位置 → 模型管理、插件