VibeTunnel：随时随地，用浏览器操控你的Mac终端！

有没有遇到过这种情况：人在外面，却急需查看服务器上的AI训练进度？或者想在手机上监控长时间运行的任务？又或者想和同事分享终端会话，却不想配置复杂的SSH？ VibeTunnel就是为此而生的！它能让你像打开一个网页一样简单地访问和控制你的Mac终端，随时随地，想”vibe-code”就”vibe-code”。

**VibeTunnel到底是什么？**

简单来说，VibeTunnel就是一个能把你的Mac终端搬到浏览器里的“传送门”。它通过代理技术，让你可以在任何设备上，只要有浏览器，就能连接到你的Mac终端。想象一下，你在咖啡馆，用手机就能查看你的AI模型训练进度，是不是很酷？

**为什么需要VibeTunnel？**

VibeTunnel的诞生源于开发者们的一个痛点：远程监控AI代理太麻烦了！于是他们决定开发一个“开箱即用”的工具，让终端访问变得像打开网页一样简单。

**VibeTunnel的强大之处：**

* **浏览器访问：** 无论你在哪里，只要有浏览器，就能访问你的Mac终端。
* **零配置：** 不需要复杂的SSH密钥、端口转发，一切都简单明了。
* **AI友好：** 特别适合监控像Claude Code、ChatGPT等基于终端的AI工具。
* **安全设计：** 支持密码保护、localhost模式，还可以通过Tailscale/ngrok进行安全隧道连接。
* **移动设备支持：** 手机、平板，随时随地查看你的终端。
* **会话录制：** 所有会话都会被录制成asciinema格式，方便以后回放。

**快速上手：**

1. **下载安装：** 下载VibeTunnel，然后把它拖到你的“应用程序”文件夹里。
2. **启动VibeTunnel：** VibeTunnel会出现在你的菜单栏里，点击图标启动服务器。
3. **使用`vt`命令：** 在任何命令前面加上`vt`，就可以让它在浏览器中访问。例如：

* `vt claude`：监控AI代理Claude。
* `vt npm run dev`：运行开发服务器。
* `vt python train_model.py`：监控长时间运行的进程。
* `vt –shell`：直接打开一个shell。
4. **打开你的仪表盘：** 访问`http://localhost:4020`，就可以在浏览器中看到所有终端会话了。

**真实应用场景：**

* **AI开发：** 远程监控和控制AI编码助手，随时了解AI代理的进度。例如：`vt claude –dangerously-skip-permissions`
* **远程开发：** 随时随地访问你的开发环境，再也不用担心“需要在工作电脑上查看”的问题了。例如：`vt code .` 和 `vt npm run dev`
* **系统监控：** 从任何设备监控系统资源、日志或长时间运行的进程。例如：`vt htop` 和 `vt tail -f /var/log/system.log`
* **教学与协作：** 通过简单的网页链接，与同事或学生实时分享终端会话。

**远程访问选项：**

* **Tailscale (推荐)：** 在你的Mac和远程设备上安装Tailscale，然后通过`http://[你的Mac名称]:4020`访问VibeTunnel。
* **ngrok：** 在VibeTunnel设置中添加你的ngrok认证令牌，启用ngrok隧道，然后分享生成的URL。
* **本地网络：** 在设置中设置仪表盘密码，切换到“网络”模式，然后通过`http://[你的Mac IP地址]:4020`访问。

**命令选项：**

* `vt –claude`：自动定位并运行Claude。
* `vt –claude-yolo`：以危险权限运行Claude。
* `vt –shell` 或 `vt -i`：启动交互式shell。
* `vt -S ls -la`：直接执行命令，绕过shell别名。

**配置：**

通过菜单栏图标访问设置：

* **服务器端口：** 更改默认端口（4020）。
* **开机启动：** 自动启动VibeTunnel。
* **在Dock中显示：** 在菜单栏或Dock中显示图标。
* **服务器模式：** 切换Rust（默认）或Swift后端。

**架构：**

VibeTunnel采用现代、安全的架构：

* 原生macOS应用，使用Swift/SwiftUI编写。
* 高性能Rust服务器，用于终端管理。
* 具有实时终端渲染的Web界面。
* 通过Tailscale或ngrok进行安全隧道连接。

**从源代码构建：**

1. **安装Rust：** 通过[https://rustup.sh/](https://rustup.sh/)安装。安装后，添加x86\_64目标以支持通用二进制文件：`rustup target add x86_64-apple-darwin`
2. **安装Node.js：** 构建Web前端需要。
3. **构建步骤：**

“`bash
# 克隆仓库
git clone https://github.com/amantus-ai/vibetunnel.git
cd vibetunnel
# 构建Rust服务器
cd tty-fwd && cargo build –release && cd ..
# 构建Web前端
cd web && npm install && npm run build && cd ..
# 在Xcode中打开
open VibeTunnel.xcodeproj
“`

**本地开发设置：**

为了避免重复的权限和密钥链对话框，需要在`Local.xcconfig`中配置你的开发团队ID。

1. 获取你的团队ID：`security find-identity -v -p codesigning`
2. 复制`Local.xcconfig.template`到`Local.xcconfig`，并插入你的团队ID。

**贡献：**

欢迎贡献！请查看贡献指南了解详情。

**许可：**

VibeTunnel是根据MIT许可证授权的开源软件。

**总结：**

VibeTunnel是一款非常方便的工具，它可以让你随时随地通过浏览器访问和控制你的Mac终端。无论你是AI开发者、系统管理员，还是只是想远程访问你的电脑，VibeTunnel都能帮你轻松搞定。赶紧下载体验吧！

vibetunnel.sh

amantus-ai/vibetunnel: Turn any browser into your terminal & command your agents on the go.
https://github.com/amantus-ai/vibetunnel