ttyd 终端共享工具：在网页上安全共享你的命令行界面

ttyd 终端共享工具：在网页上安全共享你的命令行界面

ttyd Share your terminal over the web 项目地址: https://gitcode.com/gh_mirrors/tt/ttyd

什么是 ttyd？

ttyd 是一款功能强大的命令行工具，它允许你将本地终端会话通过网页浏览器进行共享。基于 Libwebsockets 和 libuv 构建，ttyd 提供了高性能的终端共享解决方案，特别适合远程协作、教学演示或服务器管理等场景。

核心特性

1. 跨平台支持：可在 macOS、Linux、FreeBSD/OpenBSD、OpenWrt/LEDE 和 Windows 系统上运行
2. 完整终端功能：基于 Xterm.js 实现，支持 CJK（中文、日文、韩文）和输入法
3. 文件传输支持：
   • 图形化 ZMODEM 集成（配合 lrzsz）
   • trzsz 文件传输支持
4. 图像显示：支持 Sixel 图像输出
5. 安全特性：
   • 基于 OpenSSL 的 SSL 加密
   • 基础认证支持
   • 客户端证书验证
6. 灵活配置：可运行任何自定义命令及其参数

安装与基本使用

安装方法

ttyd 提供了多种平台的预编译二进制文件，用户可以根据自己的操作系统下载对应的版本。对于 Linux 用户，也可以通过包管理器进行安装。

基本命令

最简单的启动方式：

ttyd bash

这将在默认端口 7681 启动一个 bash shell，可通过浏览器访问 http://localhost:7681 进行连接。

常用选项

• -p/--port：指定监听端口（默认 7681）
• -c/--credential：设置基础认证的用户名和密码
• -W/--writable：允许客户端写入（默认只读）
• -B/--browser：自动用默认浏览器打开终端页面
• -o/--once：只接受一个客户端连接，断开后退出

高级配置

客户端选项

ttyd 提供了丰富的客户端配置选项，可以通过 -t/--client-option 参数传递：

# 更改终端字体大小
ttyd -t fontSize=20 bash

# 启用 ZMODEM 文件传输
ttyd -t enableZmodem=true bash

# 自定义终端主题
ttyd -t 'theme={"background": "#282c34", "foreground": "#abb2bf"}' bash

SSL 安全配置

为了安全考虑，生产环境建议启用 SSL：

ttyd --ssl --ssl-cert server.crt --ssl-key server.key bash

文章提供了完整的自签名证书创建指南，包括 CA 证书、服务器证书和客户端证书的创建方法。

实际应用场景

1. 多用户协作

使用 tmux 实现多用户共享同一终端会话：

ttyd tmux new -A -s shared-session

2. 远程教学

教师可以共享特定的命令行操作：

ttyd -t titleFixed="Linux教学演示" bash

3. 服务器管理

通过网页安全访问服务器：

ttyd -c admin:complexpassword -S -C server.crt -K server.key bash

性能优化与安全建议

1. 连接限制：使用 -m/--max-clients 限制最大连接数
2. 源检查：启用 -O/--check-origin 防止跨站请求
3. 用户隔离：通过 -u/--uid 和 -g/--gid 以非特权用户运行
4. 资源控制：对于公共访问，考虑使用 -o/--once 或 -q/--exit-no-conn

常见问题解答

Q：如何解决中文显示乱码问题？

A：确保终端和远程系统使用相同的字符编码（通常为 UTF-8），可以通过 locale 命令检查。

Q：文件传输失败怎么办？

A：确保两端都安装了正确的工具（lrzsz 或 trzsz），并且客户端选项已正确启用。

Q：如何提高响应速度？

A：可以调整 ping 间隔（-P/--ping-interval），在网络稳定的环境中可以适当增大该值。

总结

ttyd 作为一个功能丰富的终端共享工具，为远程协作和管理提供了便捷的解决方案。通过合理的配置，可以在保证安全性的同时，提供近乎原生的终端体验。无论是用于团队协作、远程教学还是服务器管理，ttyd 都是一个值得考虑的工具选择。

对于更高级的使用场景，如 Docker 集成或 Nginx 反向代理配置，文章也提供了详细的指导，帮助用户在各种环境下灵活部署 ttyd 服务。

ttyd Share your terminal over the web 项目地址: https://gitcode.com/gh_mirrors/tt/ttyd