本地终端桥接

TSH 本地终端桥接功能让你通过网页终端直接操作本地真实终端——复制一行系统命令即可建立连接，无需安装任何软件。

工作原理

浏览器 (TSH 网页)  ←WebSocket→  本地脚本 (127.0.0.1)  →  本地 CMD/Shell

• 浏览器通过 WebSocket 连接本地脚本
• 本地脚本监听 127.0.0.1，仅接受本机连接
• 每次连接生成唯一随机 Token，防止 CSRF
• 数据仅在浏览器和本地之间传输，不经过第三方服务器

Windows 使用

1. 打开 TSH 网页

在 Chrome 或 Edge 中打开 TSH 在线版本。

2. 点击连接本地终端

点击页面上的 Connect Local 按钮，弹出连接模态框，其中包含一行 PowerShell 命令。

3. 复制并执行命令

将命令复制到 PowerShell 中执行：

powershell -c "$env:TSH_T='your_token_here'; iwr https://look.tsh.qzz.io/relay.ps1 | iex"

命令说明

• $env:TSH_T 设置连接 Token（页面自动生成）
• iwr ... | iex 下载并执行桥接脚本
• 脚本仅监听 127.0.0.1，外部无法访问

4. 自动连接

执行后，浏览器会自动检测到本地服务并建立连接。连接成功后：

• 模态框关闭
• 终端自动聚焦
• 提示符变为 local@cmd D:\path >

5. 开始使用

现在你可以在 TSH 中直接执行本地 CMD 命令：

local@cmd D:\ > dir
local@cmd D:\ > ipconfig
local@cmd D:\ > systeminfo
local@cmd D:\ > cd C:\Users

Linux / macOS 使用

复制并执行 Python 命令

TSH_TOKEN=your_token_here python3 -c "$(curl -fsSL https://look.tsh.qzz.io/relay.py)"

需要 Python 3.6+ 和 websockets 库：

pip install websockets

连接特性

特性	说明
自动重试	连接失败时每 2 秒重试，持续 60 秒
Token 认证	每次连接生成唯一随机 Token
仅限本地	WebSocket 只监听 127.0.0.1
原生命令	Windows 使用 cmd /c 执行，输出原生 CMD 格式
目录持久	工作目录在命令间保持持久
无依赖	Windows 使用 PowerShell，Linux/macOS 使用 Python

提示符格式

连接本地终端后，提示符格式为：

local@cmd <当前路径> >

颜色编码：

• local — 绿色
• @cmd — 灰色
• 路径 — 黄色
• > — 品红色

键盘操作

按键	功能
Backspace	删除光标前字符
Delete	删除光标处字符
Enter	执行命令
Ctrl+C	中断当前命令

同时支持 0x08 (Backspace) 和 0x7F (Delete) 键码，匹配 Linux 终端行为。

安全说明

• 桥接脚本仅监听 127.0.0.1，外部网络无法访问
• 每次连接生成随机 Token，防止跨站请求伪造 (CSRF)
• 数据仅在浏览器和本地机器之间传输
• 不涉及任何第三方服务器
• 断开连接后本地服务自动停止

常见问题

连接失败

• 确认 PowerShell 命令中的 Token 与页面一致
• 检查本地端口是否被占用
• 确认浏览器和本地脚本在同一台机器上

输入无响应

• 确认连接成功（模态框已关闭）
• 点击终端区域确保获得焦点
• 尝试按回车键

命令执行异常

• Windows 命令通过 cmd /c 执行，支持所有原生 CMD 命令
• cd 和 chdir 使用 PowerShell Set-Location 实现
• 如果命令卡住，尝试 Ctrl+C 中断