返回首页

常见问题

安装与版本

当前提供哪些客户端?

  • 服务端 Agent:Linux / macOS 可安装
  • 移动端:当前公开发布的是 Android APK
  • iOS:暂未公开发布

现在还有 config.yaml 吗?

没有。tgent 现在统一通过 命令行参数环境变量 配置。

TGENT_TOKEN 应该怎么传?

推荐两种方式:

  • 启动命令里直接传 --token
  • 通过环境变量 TGENT_TOKEN

连接与配对

扫码后连接不上怎么办?

按下面顺序检查:

  1. 确认目标机器上的 tgent 仍在运行
  2. 如果是 local 模式,确认手机与服务器网络可达,且监听端口已放通
  3. 如果是 hub / both 模式,确认令牌有效、订阅可用、Agent 已成功注册到控制台
  4. 重新启动 Agent,使用新的二维码再次扫码

为什么控制台里节点显示“未配对”?

这表示 Agent 已注册到你的账号,但手机端还没有完成二维码配对。用 Android 客户端扫描 Agent 启动后显示的二维码即可完成配对。

删除访问令牌后,已经注册的节点会怎样?

已有节点不会立刻被删除,但这个令牌不能再用于注册新节点。如果你删除了节点本身,之后要重新注册,就需要新的令牌。

为什么我能本地直连,但不能远程连接?

通常是以下原因之一:

  • 当前 Agent 只运行在 local 模式
  • 你还没有创建访问令牌,或者启动时没有带上 --token
  • 当前账号没有有效订阅,无法使用 Hub 远程能力

账号与订阅

哪些功能需要订阅?

局域网直连和本地使用可以先体验;创建访问令牌、通过 Hub 远程连接和远程管理节点需要有效订阅。

忘记密码怎么办?

Web 登录页支持“忘记密码”,系统会向注册邮箱发送 6 位验证码。验证码 10 分钟内有效,输错次数过多需要重新获取。

邀请奖励怎么生效?

被邀请用户完成注册并购买订阅后,邀请人会获得额外订阅奖励天数。你可以在控制台“邀请好友”页面查看已邀请人数和奖励进度。

使用体验

支持哪些命令行程序?

只要能在 tmux 里正常运行,通常都可以配合 tgent 使用,例如:

  • shell(bash、zsh、fish)
  • 编辑器(vim、nano、emacs)
  • AI Agent(Claude Code、OpenCode 等)
  • 全屏 TUI(htop、btop、gitui 等)

文件传输是不是一定可用?

文件浏览和传输能力取决于当前客户端能力、连接状态以及账号可用权限。若当前连接路径或账号策略不允许中转文件传输,Android 客户端可能只提供终端能力。

可以同时在多台手机上连接同一个节点吗?

通常可以,但最终体验取决于当前会话、网络和客户端实现。tmux 会话本身是持续存在的,断开移动端后服务端任务也不会停止。

安全

Hub 会看到我的终端内容吗?

Hub 负责节点发现、连接协调和中转能力,不是用来保存你的终端内容。当前实现里,Hub 连接还会结合用户 JWT、Agent 公钥和配对密钥完成校验与加密链路建立。

本地模式的密码如何处理?

本地模式下如果没有显式传入 --password,系统会自动生成并持久化密码;也可以使用 --no-auth 关闭本地密码校验,但这只适合可信网络或调试环境。