安装 Agent

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

如果你不想使用安装脚本，也可以参考 安装指南 手动下载二进制。

启动本地模式

tgent --listen :8080

• --listen 默认就是 :8080
• 未指定 --password 时会自动生成一个本地连接密码
• 启动后终端会展示二维码和连接信息

下载 Android 客户端并扫码

下载地址：/api/v1/app/releases/latest?platform=android&type=apk&redirect=true

打开 Android 客户端后扫描终端中的二维码；如果当前二维码包含本地模式信息，客户端会直接尝试连接服务器。

开始使用

连接成功后，你就可以：

• 查看并进入 tmux 会话
• 使用虚拟键盘、Fn 面板和命令片段
• 在支持的连接能力下浏览或传输文件

登录 Web 控制台

访问 /register 注册账号，或使用 /login 登录已有账号。

开通订阅并创建访问令牌

在控制台完成订阅后，进入“访问令牌”页面创建一个令牌。远程节点注册依赖这个令牌。

启动 Hub 或混合模式

只走远程访问：

tgent --mode hub --token <your_token>

同时保留局域网直连：

tgent --mode both --listen :8080 --token <your_token>

用 Android 客户端扫码完成配对

Agent 启动后会显示新的二维码。Android 客户端扫码后会保存与该节点对应的配对信息，之后即可在外网环境通过 Hub 远程连接。