> ## Documentation Index
> Fetch the complete documentation index at: https://docs.avibe.bot/llms.txt
> Use this file to discover all available pages before exploring further.

# 远程 Web UI

> 使用 vibe remote 从另一台设备打开本地 Avibe Web UI。

# 远程 Web UI

你的 Avibe 跑在家里那台机器上。但你不可能 24 小时守着它。

飞机上。咖啡馆里。手里是借来的笔记本。Bot 刚 ping 你说有任务要处理，而控制面板还在家里。

```bash theme={null}
vibe remote
```

就这一行命令。本机 Web UI 立刻变成「地球上任意浏览器都能打开」的东西，走 avibe.bot 安全 tunnel。

* 🌍 **专属 `you-app.avibe.bot`** — 30 秒登录，域名跟着你账号走
* 🔒 **失败即拒绝** — 鉴权、路由、主机校验，任何不确定一律拦下
* 📱 **任意浏览器打开就用** — 单手友好的小屏布局
* ⏱ **24 小时会话** — Cookie 中途自动续期，不会突然掉线

不用 VPN。不用做端口转发。不用纠结「我公网 IP 是啥来着」。没有指向你笔记本的公开 webhook。**数据平面留在你机器上**，avibe.bot 只负责控制平面的握手。

## 它会做什么

`vibe remote` 会引导你完成：

* avibe.bot 登录。
* 配对你的本地 Avibe 实例。
* 创建通往本地 Web UI 的安全 tunnel。
* 从另一台设备打开 Web UI。

## 它不会做什么

它不会把你的编码 agent 搬到云端。

你的代码库、agent 进程、凭证和工作目录都留在本地机器上。远程 URL 只用于访问 Web UI。

## 信任模型

avibe.bot 是**控制平面**，不是数据平面——是那道门，不是你的房子。它只干两件很窄的事：证明是你本人，以及开一条隧道。它从不查看、也不存储你的代码、密钥或 agent 的工作。

```text theme={null}
你的手机 ──> avibe.bot（只管身份）──────────> 登录
你的手机 ──> Cloudflare 隧道 ──> 你机器上的 Web UI（你的数据）
```

* **身份走 OIDC + RS256。** 登录用标准的 OpenID Connect（PKCE），令牌用 RS256 签名。avibe.bot 发布 JWKS，所以你**本地**的 Avibe 能自己验证会话签名，不必每次请求都回连。
* **Cloudflare 隧道，本地运行。** `cloudflared` 跑在你的机器上、主动外拨。浏览器流量通过这条隧道到达你的 Web UI；它不经过 avibe.bot 的服务器转发，你的机器上也不开任何入站端口。
* **每一道关口都失败即拒绝。** 鉴权、路由、主机校验都默认拒绝。配错只会把你自己挡在外面，而不会悄悄把机器暴露出去。

→ 同一个立场，贯穿始终：[本地优先](/zh/concepts/local-first) · [设计哲学](/zh/concepts/philosophy)

## 谁能登录

远程访问是一个私人工作区，不是团队网关。只有你授权的邮箱能登录你的公网 URL——绑上你信任的那些，别人就算拿到链接也进不来。没有团队席位，没有角色矩阵：只有你和你明确邀请的人。

## 什么时候使用

在这些情况下使用 `vibe remote`：

* 你想从手机配置 Avibe。
* Avibe 正运行在远程开发机上。
* 你离开运行 agent 的机器后，仍想查看 dashboard。

正常的聊天控制仍然可以直接使用 Slack、Discord、Telegram、微信或 Lark。

## 配对和 tunnel

配对每个实例只需做一次：

1. 在 avibe.bot 登录并新建一个 remote-access bot。
2. 复制一次性配对 key（`vrp_…`）。
3. 把它粘贴到 `vibe remote`，或者直接传入：`vibe remote pair <key>`。

配对完成后，用 `vibe remote status`、`vibe remote start` 和
`vibe remote stop` 管理 tunnel。tunnel 本身由本地 `cloudflared` 进程承载，
公网 URL 只是把流量代理到本地 Web UI。

## 登录会话

公网 URL 受 avibe.bot 登录保护。在某台设备上登录后：

* 会话有效期约为 24 小时。
* 过半有效期后还在活动，会话会自动续期，正在使用的浏览器基本不需要再次登录。
* 想退出当前设备时，使用 dashboard 中的退出操作；tunnel 仍会为其他设备和后续登录继续运行。

如果某台设备显示会话已过期，重新在公网 URL 上登录即可。

## 停止远程访问

`vibe remote stop` 会关闭 cloudflared tunnel，但保留配对配置，
之后可以用 `vibe remote start` 恢复。再次运行 `vibe remote` 并粘贴新的
配对 key 会替换原有配置。