# 远程连接

> 在另一台电脑的桌面端中，连接并管理运行 Bot 的设备。

来源：https://vonvon.bot/docs/remote/
更新时间：2026-11-05

装了 Vonvon Bot 的每台电脑或服务器都是一台“设备”。Bot 可以跑在办公室的 Mac、家里的 Windows 或一台 Linux 服务器上，你在手边这台电脑的桌面端里把它加进来，切过去，就用同样的界面管那台的 Bot、群和设置。

适合这些情况：Bot 要 24 小时在线；代码在另一台机器上，Bot 得在那里干活；你有几台电脑，想在一处管。

## 哪台跑什么

**你的电脑** Vonvon Bot 桌面端，用来看和管

**被连的那台（Mac、Windows 或 Linux）** 服务端、Bot、群、记忆和设置；Codex、Claude 在这台干活

-   Bot 和它的数据都在被连的那台上。Codex 或 Claude 也装在那台、在那台登录。
-   切过去以后，看到的 Bot、群、设置都是那台的；选文件夹，选的也是那台上的文件夹。
-   退出你这台电脑上的 Vonvon Bot，不影响那台上的 Bot。
-   管别的设备要用 Mac 或 Windows 桌面端，浏览器里的网页端只能管本机。

## 推荐做法：Tailscale + 桌面端

两台都装上 [Tailscale](https://tailscale.com/download)、登录同一个账号，就能用 100.x 开头的地址直接连，不用开端口，也不经过公网。两台在同一个局域网里时，也可以直接用局域网地址；ZeroTier 这类组网工具分的地址也行。两台都要是 0.9.0 或以后的版本，建议都升到最新。

### 1\. 在被连的那台装好

Mac、Windows：到[下载页](https://vonvon.bot/get/)下载桌面端，装好打开，它自带服务端。

Linux：SSH 登录服务器，到[下载页的 Linux 服务端区域](https://vonvon.bot/get/#download-linux)点「复制安装命令」，粘贴到服务器终端运行。只安装服务端，没有桌面界面。

看到“装好了”就装上了。退出 SSH 后它还在不在跑、开机会不会自己起来，看最后几行，对照下面的[Linux](https://vonvon.bot/docs/remote/#linux-boot)一节。支持 x64 和 arm64、glibc 2.28 以上的发行版，例如 Ubuntu 20.04、Debian 10、RHEL 或 Rocky 8 及以后，不支持 Alpine 这类 musl 系统。卸载用下面这条，数据目录 `~/.vonvon-bot` 留着：

```
sh -c "$(curl -fsSL https://dl.vonvon.cc/bot/server/uninstall.sh)"
```

### 2\. 在那台开启并生成连接链接

1.  打开 Vonvon Bot → 设置 → 设备连接，在设备列表下面找到「允许别的设备连接本机」（0.9.0 版在 设置 → 应用与启动 页）。
2.  在「别的设备用哪个地址连过来」里选一个地址，有 Tailscale 时它标着“推荐”。点「开启」，等状态变成“监听中”。
3.  在「连接链接」里点「生成连接链接」，再点「复制」。

Linux 服务器没有桌面端，在终端里做这一步，见[只用命令行](https://vonvon.bot/docs/remote/#cli)。

![「办公室 Mac」上的「允许别的设备连接本机」：Tailscale 地址监听中，生成了一条连接链接，下面是已配对的设备](https://vonvon.bot/assets/remote-allow-kQz92z2d.webp)

远程连接操作图 · 在目标设备生成链接；旧图的入口名称可能与当前界面不同

### 3\. 在你的电脑上添加

1.  打开 Vonvon Bot → 设置 → 设备连接，点「添加设备」，把链接粘进去。
2.  起个名字，点「连接并添加」。
3.  看到“已添加”就配好了。点「切换到」过去，它在设备列表里显示“在线”。

![在自己的电脑上粘贴链接后，「添加设备」里显示「办公室 Mac」的地址和链接剩余时间](https://vonvon.bot/assets/remote-add-BlVwcYos.webp)

远程连接操作图 · 在自己的电脑上添加目标设备

## 使用远程设备

一次看一台。点左上角的设备名切换，切过去整个界面都换成那台的；第一行永远是“这台电脑”。这里也能「添加设备…」和「管理设备…」。

![左上角的设备切换：这台电脑和「办公室 Mac」都在线](https://vonvon.bot/assets/remote-switch-BPC9LMkW.webp)

远程连接操作图 · 在左上角切换当前设备

-   改名：你这台电脑上给它起的名字，在设置 → 设备连接的列表里点「⋯」→「改名」。那台自己的名字（别的设备配对时看到的），在它的「允许别的设备连接」→「设备名字」里改。
-   先在那台把 Codex 或 Claude 装好、登录，再照平常添加 Bot。
-   升级那台的服务端：切过去，打开设置 → 应用与启动，在“「设备名」的服务端”里检查更新。会重启服务端，正在进行的对话会中断。Mac 上桌面端自带的服务端，要那台的 Vonvon Bot 开着才能远程更新；Windows 上的，这一版要在那台电脑上打开 Vonvon Bot 更新。
-   两边版本不同时，界面顶部会提示“版本不一致”。两边不能一起工作时，只能先升级旧的那边。

## 访问和安全

连接链接等于密码

谁用它配对，谁就能管那台设备上的 Vonvon Bot，所以只给自己的电脑用，别发给别人。链接 10 分钟内有效，只能用一次。

-   配对后每台电脑有自己的密钥，连接全程加密。授权不会过期，不再用的电脑要撤销：在被连的那台的「已配对的设备」里点「⋯」→「撤销」，Linux 上用 `vonvon clients ls` 和 `vonvon clients revoke`。撤销后那台电脑马上断开。
-   有新电脑配对时，被连的那台桌面端会弹出提示。不是你操作的，马上撤销。
-   暂时不想让别的电脑连：点「关闭远程连接」，或运行 `vonvon remote disable`。配对都留着，在同一个地址重新开启后会自己连上。
-   公网地址和运营商地址（不在 Tailscale 或组网工具上的 100.x）开启后，互联网上或同一运营商的人都能尝试连这台设备，所以要先勾「我了解风险」。建议用 Tailscale 或局域网地址。
-   连上的电脑都按你本人对待，什么都能改。

## 各平台当被连的那台

### Mac

-   可以关窗口，别退出 Vonvon Bot：退出后服务端和 Bot 都会停。
-   电脑睡着了连不上，别让它自动睡眠。锁屏没关系。
-   重启后登录时自动跑起来：在设置 → 应用与启动里打开「登录电脑时启动」。重启后要有人登录这台 Mac（或者开了自动登录），Bot 才会上线。
-   开着防火墙时，第一次会问要不要让 Vonvon Bot 接受传入的网络连接，点允许。
-   Mac 的桌面端带 `vonvon` 命令：打开过一次 Vonvon Bot 后，新开一个终端就能用，下面[只用命令行](https://vonvon.bot/docs/remote/#cli)的命令在 Mac 上也能用。

### Windows

-   可以关窗口，别退出 Vonvon Bot；电脑睡着了连不上，别让它自动睡眠。
-   这一版没有登录时自动启动，重启后要登录、打开 Vonvon Bot。
-   第一次开启时，Windows 会问是否允许 Vonvon Bot 访问网络，把专用网络、公用网络都勾上，点「允许」。点过「取消」的话别的设备连不上：到 Windows 安全中心 → 防火墙和网络保护 → 高级设置 → 入站规则，删掉名为 Vonvon Bot 的「阻止」规则（要管理员权限），再关掉、重新开启。
-   默认端口是 7767；被别的程序占着时，关掉那个程序后会自己开始，也可用 `vonvon remote port` 换端口。Windows 桌面端打开过一次后会注册 `vonvon` 命令，关闭整个 PowerShell 或 CMD 程序后重开即可使用。

### Linux

安装命令的最后几行说明 Bot 能不能开机自动启动：

| 最后几行写着 | 要做什么 |
| --- | --- |
| 装好了。Vonvon Bot 已在后台运行，开机自动启动。 | 不用做什么。 |
| 这台机器没让它开机自动启动，退出登录后它会停。 | Bot 在跑，退出登录后会停。要它一直在线，用有管理员权限的账号运行一次脚本给的那条命令。 |
| 装好了。已直接启动一次。上面一行写着“可能是容器” | Bot 在跑，但停了或机器重启后不会自己起来，到时运行 `vonvon daemon start`。 |
| 装好了。已直接启动一次。上面一行写着“用 sudo 切过来时常见” | Bot 在跑，但重启后不会自己起来。用这个账号直接 SSH 登录，运行 `vonvon service install`。 |

没看到 `vonvon` 命令时，重开一个终端，或运行 `. ~/.bashrc`（zsh 用 `. ~/.zshrc`）。

## 只用命令行

在被连的那台设备上打开终端：Mac、Windows 桌面端打开过一次后，或 Linux 服务端安装完成后，可以运行：

```
vonvon remote enable
```

它会列出这台设备的地址，标好 Tailscale、组网、局域网等类型，回车选默认的那个。在脚本里、或者让终端里的 Codex、Claude Code 替你运行时，直接写地址，比如 Linux 上的 Tailscale 地址：

```
vonvon remote enable "$(tailscale ip -4)"
```

再生成连接链接，粘到你电脑上的「添加设备」里（[第 3 步](https://vonvon.bot/docs/remote/#add)）：

```
vonvon pair
```

| 命令 | 做什么 |
| --- | --- |
| `vonvon remote status` | 看开着的地址和状态，“在听”就是开好了 |
| `vonvon remote disable` | 关掉远程连接，经它的连接马上断开 |
| `vonvon remote port 7768` | 换端口（默认 7767），换完已配对的电脑要粘一次新链接 |
| `vonvon clients ls` | 列出配对过的电脑 |
| `vonvon clients revoke <id>` | 撤销一台，马上断开 |
| `vonvon device rename <名字>` | 改这台设备的名字 |
| `vonvon update` | 升级 Linux 上的服务端，`--check` 只查不装 |

飞书里的 Bot 不能替你开启或生成链接，这几步要你自己或终端里的 AI 来做。

## 排错

### 没有能选的地址

这台设备上没有别的设备能连过来的地址。两台都装上 Tailscale、登录同一个账号，或者连到同一个局域网，再点右上角的刷新。

### 一直是“等地址出现”

这台设备现在没有这个地址，比如开机时 Tailscale 还没连上，出现后会自动开始。一直不出现，换一个列出来的地址。写着端口被占用的，可以用 `vonvon remote port` 换一个端口，或关掉占着端口的程序。

### 链接过期或已经用过

链接 10 分钟内有效，只能用一次，在那台再生成一条。提示这条链接已经被用掉了、又不是你用的：马上到那台撤销不认识的电脑，再生成新的。

### 添加时连不上

-   Tailscale：两台登录的是同一个账号吗？在你的电脑上运行 `tailscale ping` 加那台的地址试一下；Mac 上没有 `tailscale` 命令时，在 Tailscale 的设备列表里看那台在不在线。
-   局域网：两台在同一个局域网里吗？
-   通了还连不上，看那台的防火墙：Windows 见[上面](https://vonvon.bot/docs/remote/#windows)，Linux 看 ufw、firewalld 有没有放行这个端口。

### 你的 Mac 上用局域网或组网地址连不上

macOS 15 起，你这台 Mac 可能拦住了 Vonvon Bot 访问本地网络，局域网地址和 ZeroTier 这类组网地址都会连不上。弹出询问就点「允许」再试；没有弹出，打开 系统设置 → 隐私与安全性 → 本地网络，把 Vonvon Bot 打开。Tailscale 地址不受这个限制。

### 提示身份和配对时不一样了

那台可能重装过、换了数据目录，也可能是别的机器占了它原来的地址。为安全起见已断开。确认是你自己的设备后，在设备列表里点「重新配对」，粘一条那台新生成的链接。

### 那台换了地址或端口

在那台生成一条新链接，粘到「添加设备」里。提示“已按新链接更新了它的地址”就好，不用重新配对。

## 下一步

-   切到那台，把 Codex 或 Claude 配好，再[添加 Bot](https://vonvon.bot/get/#start)。
-   还没装桌面端的电脑，到[下载页](https://vonvon.bot/get/)下载。
-   遇到这里没写的问题，到[交流群](https://vonvon.bot/#community)里问。
