【免费下载链接】waku⚡ A native app for all your coding agents.项目地址https://gitcode.com/gh_mirrors/waku/waku点击查看免费下载Waku 是一个用 Rust 构建的原生编码 Agent 控制台而 Waku Mobile 让你的手机变成它的遥控器通过wss://加密 WebSocket 连接电脑里常驻的 Waku Daemon你在地铁上就能查看 Claude Code、Codex、OpenCode 等 Agent 的任务进展、发消息、审 Diff。本文是面向新手的完整配置教程覆盖桌面端开启远程 Daemon、移动端填写地址与令牌token的全部步骤。Waku Mobile 是什么把电脑上的 Agent 装进口袋一句话理解 Waku 的架构电脑端跑一个独立的waku-daemon进程服务端手机、浏览器、桌面应用都只是连上去的客户端。Daemon 拥有全部重资产项目、会话、转录记录、SQLite 数据、附件、Git 操作全部留在电脑上Waku Mobile 只负责渲染界面与收发 RPC 消息不存储任何敏感数据因此即使手机断开Agent 任务依然在 Daemon 主机上继续运行这就是 Waku 主界面深色主题左侧是任务与会话列表右侧是 Agent 的实时输出流。连接 Waku Mobile 后你看到的正是同一份数据。架构细节可以在项目文档中确认桌面端与 daemon 的关系见 README.md移动端说明见 apps/mobile/README.md。先搞懂原理wss 远程连接是怎么工作的理解下面 3 点配置时就不会迷路默认只监听本机loopback。Daemon 启动时默认只绑定127.0.0.1外部网络根本连不进来——这是刻意的安全设计暴露需要显式授权。要让手机连上Daemon 必须携带--allow-non-loopback参数启动监听局域网或公网接口。Waku 桌面端的暴露开关就是帮你加了这个参数见 crates/waku-client/src/process.rs认证靠令牌token。每次连接都要出示 token它是完全控制权凭证能访问主机上的任务、文件、Git 和 Agent等同于万能钥匙公网必须走 wss://。Daemon 自身不终结 TLS在可信局域网内可以用ws://但一旦出内网家里访问公司电脑、出门访问家里电脑就必须在前面挂一个受信任的 TLS 反向代理或隧道如 Tailscale、Cloudflare Tunnel 等自组方案把 WebSocket 转发过去地址写成wss://Daemon 的启动参数与安全约束完整定义在 crates/waku-daemon/src/main.rs说明文档见 crates/waku-daemon/README.md。桌面端一键开启三步暴露 Waku Daemon不需要手写命令行Waku 桌面应用把这一切做成了开关第 1 步打开 Settings → Daemon在桌面端进入设置页的Daemon分区你会看到暴露由 Waku 管理的守护进程开关中文文案见 locales/zh-CN.yml开启暴露开关Daemon 重启后会在所有网络接口上监听状态从仅本机变为已暴露设置端口默认示例为34123可改成任意 1-65535 的端口允许的浏览器来源只有网页版需要填且必须精确匹配纯手机连接可以不填对应的界面实现代码在 src/app/settings.rs应用按钮会触发 Daemon 热重启并自动带上--allow-non-loopback。第 2 步复制 WebSocket 地址和令牌暴露成功后连接信息区会显示两项内容直接复制备用项目示例用途WebSocket 地址ws://my-mac.local:34123填入手机 App令牌一串随机字符可点重新生成认证身份⚠️ 地址里的my-mac.local是局域网主机名只在同一局域网有效。如果要跨网络访问请让隧道/代理把流量转发到该地址再把地址换成隧道域名wss://。手机端添加 Daemon填写地址与令牌在手机上打开 Waku MobileExpo 客户端支持 iOS / Android进入 Daemon 列表选择添加填写规则App 会自动校验地址支持ws://或wss://开头也可以省略协议直接写host:portApp 会自动补全apps/mobile/src/lib/daemon-profile.ts智能安全拦截如果你填的是ws://且指向公网地址保存按钮会被禁用——App 强制你走wss://避免 token 明文裸奔daemon-editor.tsx令牌安全存储iOS / Android 上 token 通过 Expo SecureStore 存入系统钥匙串与普通配置分开保管删除档案只删本地凭证不影响电脑上正在跑的任务连接成功后的体验保存后 App 会立即尝试连接成功后可以 浏览电脑上的项目与会话列表实时观看 Agent 输出✍️ 新建任务、给正在运行的 Agent 追加消息或转向steer 查看 Git 分支、审查代码 Diff断线自动重连为什么手机 App 很稳Waku Mobile 的连接层内置了完整的看门狗apps/mobile/src/lib/daemon-link.ts对新手来说这意味着心跳探测每 30 秒检查一次连接是否假死iOS 会把后台 Socket 挂起容易出现半开连接8 秒无响应就判定失效并重建指数退避重试掉线后立即重连失败则按递增延迟 抖动自动重试回到前台立即再试断点续读重连后凭 replay cursor 从断开处继续拉取消息不丢流错误分级token 被拒、版本不匹配这类只有人能修的错误会停止重试并直接告诉原因顶部连接横幅会实时显示状态已连接 / 重连中含第几次尝试/ 错误原因实现在 apps/mobile/src/components/connection-banner.tsx。安全清单配置前务必过一遍#检查项说明1公网必须wss://Daemon 不做 TLS需自建代理/隧道2token 视为完全控制权可操作主机上的文件、Git 与 Agent别发到聊天群3不要把 token 交给网页 JS只有信任的前端才配拥有它4不需要时关闭暴露关掉开关 Daemon 会退回仅本机监听5跨设备前先重启验证修改端口/开关后 Daemon 会自动重启等状态变已暴露再连常见问题速查FAQQ手机上显示无法连接依次排查① 电脑和手机是否同一网络ws://只在局域网有效② 防火墙是否放行了 Daemon 端口③ token 是否复制完整④ 桌面端状态是否显示已暴露。Q换了手机能继续用吗可以。档案里存的是地址 token新手机重新填一遍即可会话数据永远在 Daemon 主机上。Q能用一台手机连多台电脑吗能。每台电脑配一个 Daemon 档案App 内随时切换。Q只想要浏览器端远程访问同样走 Settings → Daemon 暴露流程网页版要求wss://且需把浏览器来源精确加入白名单说明见 apps/web/README.md。小结Waku Mobile 的远程连接本质就是桌面端一个开关暴露 Daemon → 复制地址和 token → 手机 App 填进去公网场景再套一层 TLS 隧道换成wss://。配置完成后电脑里的编码 Agent 就成了你口袋里的常驻服务出门在外也能随时跟进任务进度。赞分享【免费下载链接】waku⚡ A native app for all your coding agents.项目地址https://gitcode.com/gh_mirrors/waku/waku点击查看免费下载相关推荐快速上手JoyCon手柄连接电脑的完整配置方案快速上手JoyCon手柄连接电脑的完整配置方案 JoyCon Driver项目为Windows系统提供了完整的Nintendo Switch JoyCon手柄驱动开发硬件开发如何使用MySQL Connector/C连接数据库3分钟快速入门教程如何使用MySQL Connector/C连接数据库3分钟快速入门教程 MySQL Connector/C是MySQL官方提供的C数据库连接器它嵌入式物联网机器人自动驾驶智能硬件Foundation Sites响应式框架从零开始构建现代化后台管理系统的完整指南Foundation Sites响应式框架从零开始构建现代化后台管理系统的完整指南 Foundation Sites是全球最先进的响应式前端框架专为快速构建前端创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考