命令行参考
最常见的三种启动命令
# 本地模式
tgent --listen :8080
# Hub 模式
tgent --mode hub --token <your_token>
# 混合模式
tgent --mode both --listen :8080 --token <your_token>常用参数
| 参数 | 默认值 | 说明 |
|---|---|---|
--listen | :8080 | 本地 HTTP 服务监听地址 |
--password | 自动生成 | 本地模式认证密码 |
--no-auth | false | 关闭本地密码认证 |
--jwt-secret | 自动生成 | 本地 JWT 签名密钥 |
--pipe-dir | /tmp/tgent/pipes | pipe-pane 使用的 Unix socket 目录 |
--web-dir | 空 | 覆盖内嵌前端资源目录 |
--data-dir | ~/.tgent | 数据目录 |
--mode | local | local / hub / both |
--connect-addr | 自动探测 | 自定义客户端连接地址，可多次传入 |
--name | 主机名 | 节点展示名称 |
--token | $TGENT_TOKEN | 访问令牌 |
--no-tui | false | 关闭 TUI，使用纯文本输出 |
--snapshot-scrollback | 1000 | 终端快照滚动缓冲最大行数，0 表示不限制 |
环境变量
export TGENT_TOKEN=<your_token>说明：
TGENT_TOKEN主要服务于hub/both模式- 如需私有部署，还可以使用
TGENT_API_URL和TGENT_HUB_ADDR - 不再支持通过 YAML 配置文件传参
常见组合示例
给节点指定名称
tgent --mode both --name prod-api-01 --listen :8080 --token <your_token>明确告诉客户端该连哪些地址
tgent --listen :8080 \
--connect-addr 192.168.1.10:8080 \
--connect-addr 10.10.0.8:8080在 systemd 或脚本里运行
TGENT_TOKEN=<your_token> tgent --mode both --listen :8080 --no-tui在非交互环境关闭 TUI
tgent --no-tui --mode both --token <your_token>行为提示
hub模式不会对外提供本地监听服务，因此不会使用本地密码认证hub模式下传入--connect-addr没有效果- 如果没有显式指定
--password，本地模式会自动生成并持久化密码 - 如果没有显式指定
--jwt-secret，本地模式会自动生成并持久化签名密钥