# 随处访问你的终端

Termbridge 让你可以通过任何带浏览器的设备访问本地终端。运行一条命令，扫描 QR 码，即可连接。

```bash
npx termbridge
```

就是这样。现在可以通过手机访问你的终端了。

## 为什么选择 Termbridge？

**在沙发上检查构建进度。** 启动了一个耗时很长的构建？喝咖啡时也能用手机查看它何时完成。

**随时随地监控服务器。** 已通过 SSH 登录到运行某个进程的服务器？无论身在何处，都能随时查看。

**远程运行 AI 编程工具。** 正在使用 Claude Code、Codex 或类似工具？离开办公桌时，也能用平板查看它们的运行情况。

**快速访问，无需设置。** 无需端口转发、VPN 或复杂配置，只需运行命令并扫描即可。

## 工作原理

1. 在计算机上运行 `npx termbridge`
2. Termbridge 会创建通往终端的安全隧道（或在直连模式下使用沙盒链接）
3. 扫描 QR 码（或复制 URL）
4. 终端会以完整交互模式显示在浏览器中

默认情况下，所有内容都在你的计算机本地运行。可选的沙盒模式会在你的 Daytona 账户中运行，并且没有由 Termbridge 运营的后端。

## 核心设计

**本地优先。** 默认情况下，服务器、WebSocket 和终端注册表都运行在你的计算机上。沙盒模式会在你的 Daytona 账户中运行，但 Termbridge 仍不会运营后端或存储你的数据。

**安全交接。** Termbridge 会发放一次性令牌，并将其兑换为 Cookie 会话。你在移动设备上扫描的就是令牌 URL。

**适合移动设备。** UI 刻意保持简洁：全高终端、紧凑控制栏和终端切换面板。

## 你可以做什么

- **完整终端访问** - 色彩、htop 和 vim 等 TUI，以及正确的按键处理都能正常使用
- **多个会话** - 运行多个终端并在应用中切换
- **移动端控制** - 屏幕按钮支持 Ctrl+C、方向键、Tab 和其他按键
- **默认安全** - 一次性令牌确保只有你能连接

## 快速开始

若要使用默认的本地隧道流程，请安装 [Node.js](https://nodejs.org) 20 或更高版本、[tmux](https://github.com/tmux/tmux) 和 [cloudflared](https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/downloads/)，然后：

```bash
npx termbridge
```

用手机扫描 QR 码即可连接。沙盒模式请参阅 Sandboxes 指南。

### [入门指南](https://termbridge.inline0.dev/zh/docs/getting-started)

包含安装步骤的完整设置指南

### [使用指南](https://termbridge.inline0.dev/zh/docs/usage)

手机控制、多个终端等更多内容

### [开发服务器预览](https://termbridge.inline0.dev/zh/docs/usage/dev-server-preview)

在终端旁预览你的应用

### [沙盒](https://termbridge.inline0.dev/zh/docs/sandboxes)

在 Daytona 云沙盒中运行终端