常见问题
安装与版本
当前提供哪些客户端?
- 服务端 Agent:Linux / macOS 可安装
- 移动端:当前公开发布的是 Android APK
- iOS:暂未公开发布
现在还有 config.yaml 吗?
没有。tgent 现在统一通过 命令行参数 和 环境变量 配置。
TGENT_TOKEN 应该怎么传?
推荐两种方式:
- 启动命令里直接传
--token - 通过环境变量
TGENT_TOKEN
连接与配对
扫码后连接不上怎么办?
按下面顺序检查:
- 确认目标机器上的
tgent仍在运行 - 如果是
local模式,确认手机与服务器网络可达,且监听端口已放通 - 如果是
hub/both模式,确认令牌有效、订阅可用、Agent 已成功注册到控制台 - 重新启动 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 关闭本地密码校验,但这只适合可信网络或调试环境。