安装 Agent

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

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

启动本地模式

tgent start --listen :8080

• --listen 默认就是 :8080
• 未指定 --password 时会自动生成一个本地连接密码
• 启动成功后终端会展示二维码和连接信息，然后返回 shell
• 后续可用 tgent status、tgent logs -f 和 tgent stop 管理服务

下载 Android 客户端并扫码

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

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

开始使用

连接成功后，你就可以：

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

登录 Web 控制台

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

开通订阅并创建访问令牌

注册并登录控制台后，进入“访问令牌”页面创建一个令牌。免费版可注册 2 台远程节点，节点注册依赖这个令牌。

启动 Hub 或混合模式

只走远程访问：

tgent start --mode hub --token <your_token>

同时保留局域网直连：

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

用 Android 客户端扫码完成配对

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