• 简体中文

      • Vibelet 设置与网络路径：LAN / 远程直连 / Cloudflare / Tailscale 怎么选

      人已经离开键盘，电脑上的 Claude 或 Codex 还在等你批准下一步。差别不在「再装一个更强的远程」，而在手机能不能到达二维码里的那台电脑。本文帮你在局域网、远程直连、按需 Cloudflare 和 Tailscale 里选一条，并处理扫码后的 Network request failed。官方 Remote 够不够用，见 Claude Code Remote Control 和 Codex 手机远程。

      步骤细节以 远程直连 和 Stash 内置 Tailscale 为准。电脑休眠、断网，或 vibelet 进程退出，遥控就停。手机是控制器，不是云工作区。

      一句话结论

      • 不确定手机是否离开当前网络：直接 npx vibelet。默认是远程直连（Remote Direct），不是 Cloudflare。
      • 手机和电脑始终同一 Wi-Fi，而且这次不要远程直连：npx vibelet --access=local。离开这个局域网就连不上。
      • 远程直连仍到不了，需要额外公网路径：再加 npx vibelet --cloudflare，或把自备隧道填进 --access=https://...。
      • 已经有 Tailscale：--access= 后面填电脑的 Tailscale IP，不是 https URL。
      • iPhone 上代理 VPN 不能关、又要走 Tailnet：用支持内置 type: tailscale 的代理（指南以 Stash 为例）。iOS 不能同时开两个系统 VPN。

      离开电脑前的最小设置

      电脑

      在真正跑编程会话的那台机器上执行：

      npx vibelet

      Mac 也可以用站点下载区里的 Apple Silicon Beta。以 首页 当日下载入口为准。

      手机

      iPhone 用 App Store 上的 Vibelet。Android 用站点给出的正式 APK。打开当前 App，扫描这一次新生成的二维码。

      会话

      新建会话，选择电脑端已经配置好的远程助手。助手名单以当前 App 为准，常见是 Claude 和 Codex。敏感步骤在手机上审批。

      硬前提

      电脑保持醒着，连接器进程还在，手机到二维码里的 host 网络可达。配好网络不能让电脑去睡。

      我该走哪条路径

      1. 手机几乎总在同一 Wi-Fi，并且想关掉远程直连：npx vibelet --access=local。扫不上时，看本机网络权限，或改用电脑的局域网 IP 再跑一次。
      2. 会出门，或不确定网络：保持默认 npx vibelet。失败再看下面的排障清单，不要一上来改成 Cloudflare。
      3. 远程直连仍不够：npx vibelet --cloudflare。要换一条新的 Cloudflare URL，加上 --force。已有自己的 cloudflared 或 ngrok 时，用 --access=https://...。
      4. 已经加入 Tailscale：npx vibelet --access=<电脑的-tailscale-ip>。先在同一 Tailnet 上打开 http://<该-ip>:9876/health。
      5. iPhone 必须同时代理上网和走 Tailnet：不要再开一个系统级 Tailscale App。按 Stash 指南 把 Tailscale 做成代理内部节点。

      路径各自要注意什么

      远程直连（默认）

      远程直连指南 写明：打开 App 扫码即可，不必先装额外网络应用。Vibelet 会尝试加密直连；直连失败时使用加密中继。连上了，不代表底层一定已经是 P2P。这条路径不改系统 VPN、DNS 或路由。

      Cloudflare（按需）

      Cloudflare 默认关闭。只有需要远程直连之外的另一条路径时才加 --cloudflare。代理软件有时会误接管 *.argotunnel.com。npm 上个别旧 README 仍把 Cloudflare Tunnel 写成默认项；以本站和当前 npx vibelet 的行为为准，不要按过期 README 把 Cloudflare 打开当第一步。

      自定义 relay

      自备公网隧道后：

      npx vibelet --access=https://你的隧道地址

      指南写默认监听端口是 9876。中继地址会记在本机，不要把配对二维码或诊断文件发出去。

      Tailscale

      --access 传的是 Tailscale IP，例如 100.x.y.z，不是 https://。手机必须在同一个 tailnet。MagicDNS 能不能解析，以你自己的 Tailscale 配置为准，不要把它写成 Vibelet 的必选项。

      iPhone：代理 VPN 加 Tailscale

      Stash 指南 的验证顺序是：节点认证延迟、Safari 打开 /health、设备地址是 Tailscale IP、活动连接命中 Tailnet、普通网站仍走原来的代理策略。不要把 100.64.0.0/10 放进跳过路由，否则 Tailnet 流量不会进那个节点。其他代理软件不能直接照搬那段 YAML。

      Network request failed

      这个错误表示：HTTP 请求还没到 host，手机已经连不上二维码里的地址。按顺序看：

      1. 手机和电脑是否还在二维码对应的网络上。.local 或纯局域网地址，手机经常解析不了。
      2. iPhone 的「本地网络」权限是不是拒绝了当前 App。
      3. 若走 Cloudflare 或自建隧道，代理是不是把 *.argotunnel.com 或你的 relay 域名接管了。先确认这个域名本身在手机上打得开。
      4. 只想用局域网时，改用电脑的局域网 IP，或用正确的 --access 再跑一次。
      5. 二维码是短时、一次性的。过期就重新执行 npx vibelet（或你这条路径对应的命令），用当前 App 扫新码。已经配对过的设备可以先试重连。
      6. 诊断用 npx vibelet status 或 npx vibelet logs。不要把配对码或诊断文件发到公开渠道。

      常见误解

      • 「默认就是 Cloudflare Tunnel。」现网默认是远程直连，Cloudflare 按需再加。
      • 「连上了就一定是点对点直连。」也可能是加密中继。
      • 「Tailscale 也填 https URL。」填 Tailscale IP。
      • 「再开一个 VPN App 就能同时代理和 Tailscale。」iOS 只有一个系统 VPN 通道。
      • 「网络配好了电脑就能睡。」不行。
      • 「这页用来决定要不要官方 Remote。」那是上面两篇对照。本文只选到达电脑的路径。

      和另外两篇怎么分

      Claude Code Remote Control 比较官方资格和双助手。 Codex 手机远程 比较 ChatGPT 桌面 Remote。本文是设置和排障。官方文档仍以 Claude Remote Control 和 Codex remote connections 为准。

      常见问题

      离开电脑前最少做哪几步？

      电脑上跑 npx vibelet，手机装 App 并扫码，新建会话并选好已经在电脑上配置的助手。电脑必须醒着。

      还要不要开 Cloudflare？

      默认不要。远程直连不够用时再加 --cloudflare。--force 用来换新 URL。

      什么时候用 --access=local？

      手机和电脑在同一局域网，而且这次明确不要远程直连。不确定会不会离开这个网络，就用默认命令。

      自定义 relay 和 Tailscale 差在哪？

      自定义 relay 是一条你自己的公网 https:// 地址。Tailscale 是私网 IP，手机必须在同一个 tailnet，没有公网 relay URL。

      代理和 Tailscale 能一起用吗？

      可以，但不要同时开两个系统 VPN。用带内置 Tailscale 节点的代理，并按指南做五步验证。

      下一步

      按上面的决策树跑通一条路径，在手机上完成一次敏感步骤的审批。扫码失败就回到排障清单，再打开对应指南。还在比较官方通道，回到两篇对照。产品入口在 vibelet.icu，货架见 shop.lifeos.md。