返回首页

安装指南

安装 Agent

方式一:安装脚本(推荐)

curl -sL https://tgent.omscd.com/install.sh | bash

安装脚本当前会完成这些事:

  • 检测系统与架构(Linux / macOS / FreeBSD;支持 386 / amd64 / arm64,Linux 额外支持 armriscv64
  • /api/agent/check-update 获取适配的最新 Agent 发布包
  • 下载并安装到用户家目录下的可执行目录(通常是 ~/bin~/.local/bin
  • 检查该目录是否在 PATH
  • 提示使用 tgent start 后台启动,以及通过 statuslogsstop 管理服务

安装脚本不会再生成 config.yaml。Agent 现在统一通过命令行参数和环境变量配置。

方式二:手动下载

你也可以直接查询当前平台可用版本:

curl -s "https://tgent.omscd.com/api/agent/check-update?version=0.0.0&os=linux&arch=amd64"

返回中会包含:

  • version
  • downloadUrl
  • mirrors
  • sha256

拿到下载地址后手动安装即可:

wget <download_url>
chmod +x tgent-*
mkdir -p ~/.local/bin
mv tgent-* ~/.local/bin/tgent

如果 ~/.local/bin 还没进 PATH,请把下面这行加到你的 shell 配置里:

export PATH="$HOME/.local/bin:$PATH"

验证安装

可以用下面两种方式检查命令是否就绪:

command -v tgent
tgent -h

安装完成后可直接后台启动:

tgent start --listen :8080

启动成功并打印连接信息后,命令会返回 shell。常用管理命令:

tgent status
tgent logs -f
tgent stop

系统要求

  • Linux、macOS 或 FreeBSD
  • tmux 3.0+
  • 对应平台的 386 / amd64 / arm64 环境,或 Linux arm(32 位 ARMv7)/ riscv64
  • 若要使用远程 Hub,服务器需要能访问你的控制平面 API 或指定的 Hub 地址

Android 客户端

当前公开下载渠道:

iOS 版本暂未公开发布,因此文档中的移动端说明默认以 Android 客户端为准。