GoTTY 使用指南

1. 项目介绍

GoTTY 是一个基于 Go 语言开发的简单命令行工具，它能够将你的 CLI 工具转换为 Web 应用程序。通过 GoTTY，用户可以在浏览器中访问和控制终端会话，非常适合用于远程管理、教学演示等场景。

2. 项目快速启动

2.1 安装 GoTTY

2.1.1 通过 Homebrew 安装（适用于 macOS）

brew install yudai/gotty/gotty

2.1.2 通过 go get 安装（适用于有 Go 环境的系统）

go get github.com/yudai/gotty

2.1.3 下载二进制文件（适用于所有系统）

从 Releases 页面 下载最新的稳定版本二进制文件，并解压到系统路径中。

2.2 启动 GoTTY

使用以下命令启动 GoTTY，并指定要运行的命令：

gotty [options] <command> [<arguments>]

例如，启动一个简单的终端会话：

gotty bash

启动后，打开浏览器访问 http://localhost:8080 即可看到终端界面。

2.3 常用选项

• --address value：指定监听的 IP 地址（默认：0.0.0.0）
• --port value：指定监听的端口号（默认：8080）
• --permit-write：允许客户端向 TTY 写入数据
• --credential value：启用基本身份验证（例如：user:pass）
• --random-url：为 URL 添加随机字符串以增加安全性
• --tls：启用 TLS/SSL

3. 应用案例和最佳实践

3.1 远程管理

在服务器上启动 GoTTY，管理员可以通过浏览器远程访问和管理服务器终端，无需直接登录服务器。

gotty -w tmux new -A -s gotty top

3.2 教学演示

教师可以通过 GoTTY 在浏览器中实时演示命令行操作，学生可以在自己的设备上观看和学习。

gotty -w python3

3.3 容器化管理

结合 Docker 和 Kubernetes，GoTTY 可以用于远程访问和管理容器内的终端会话。

gotty -w docker run -it --rm busybox

4. 典型生态项目

4.1 tmux

tmux 是一个终端复用器，可以与 GoTTY 结合使用，实现多客户端共享同一个终端会话。

4.2 Docker

Docker 是一个容器化平台，GoTTY 可以用于远程访问和管理 Docker 容器内的终端会话。

4.3 Kubernetes

Kubernetes 是一个容器编排平台，GoTTY 可以用于远程访问和管理 Kubernetes 集群中的容器终端会话。

通过这些生态项目的结合，GoTTY 可以实现更复杂和强大的远程终端管理功能。