安装 taosX-Agent
概述
当 taosX 无法直接连接数据源时,可以在数据源所在网络安装 taosX-Agent。可将 taosX-Agent 安装在数据源所在主机,或安装在同一网络中且能访问该数据源的其他主机。之后 taosX 即可通过 taosX-Agent 连接数据源。
- 数据源所在主机不必安装 TDengine。
- 若 taosX 可直接连接数据源,则无需安装 taosX-Agent。
创建代理
- Windows
- Linux
-
在浏览器中打开 taosExplorer。
-
在左侧主菜单中选择 数据写入。
-
打开 代理 标签页,点击 +创建新的代理。
-
点击 Windows 下载 taosX-Agent。
-
在本机运行 taosX-Agent 安装程序,并按提示完成安装。
-
在 taosExplorer 中点击 下一步。
-
为代理输入唯一名称,点击 下一步 生成认证 token。
-
在本机打开
C:\TDengine\cfg\agent.toml文件。 -
将 taosExplorer 界面中显示的
endpoint与token值复制到agent.toml文件中。endpoint="http://localhost:6055"
token="eyJ0eX...BhA" -
在 taosExplorer 中点击 下一步。
-
在本机以管理员身份打开终端,执行以下命令:
sc start taosx-agent -
在 taosExplorer 中点击 检查代理是否连接正常。
-
若显示 正常,点击 完成。
-
在浏览器中打开 taosExplorer。
-
在左侧主菜单中选择 数据写入。
-
打开 代理 标签页,点击 +创建新的代理。
-
点击 Linux 下载 taosX-Agent。
-
在本机运行 taosX-Agent 安装程序,并按提示完成安装。
-
在 taosExplorer 中点击 下一步。
-
为代理输入唯一名称,点击 下一步 生成认证 token。
-
在本机打开
/etc/taos/agent.toml文件。 -
将 taosExplorer 界面中显示的
endpoint与token值复制到agent.toml文件中。endpoint="http://localhost:6055"
token="eyJ0eX...BhA" -
在 taosExplorer 中点击 下一步。
-
在本机打开终端,执行以下命令:
sudo systemctl start taosx-agent -
在 taosExplorer 中点击 检查代理是否连接正常。
-
若显示 正常,点击 完成。
之后在创建数据写入任务时,即可选择该代理连接数据源。
任务配置与 Agent 生命周期
taosX-Agent 在数据源侧安装并连通后,长期复用同一 Agent 即可。在 taosExplorer 中可以:
- 创建、编辑、启停 Data In 任务(含 OPC DA / OPC UA 等)
- 调整任务级采集参数(如采集间隔)
- 追加点位、更新点位 CSV / 映射
上述操作不要求在 OPC 等服务器主机上重新安装 Agent,也不要求重新生成并下发一套新的“代理安装包”才能改点位。任务通过已配置的 endpoint 与 token 与中央 taosX 通信。
需要再次改动 Agent 本机的情况包括:更换连接 endpoint / token、升级 Agent 版本、修改本机 agent.toml 或存储转发等本机选项。组件级说明见 taosX-Agent;亦可通过 SQL 管理 Agent 与任务,见 数据接入(Xnode)。
相关文档
完整配置项说明见 taosX-Agent。








