让 agent 在服务器上一直跑，
你在任何设备上随时接管。

WebMux 是一个在浏览器里持续运行的终端，为远程遥控 Claude Code、Codex 等 CLI agent 而生。会话放在服务端；浏览器、手机和本机终端只是“附着”上去。

curl -fsSL https://github.com/mzdluo123/webmux/releases/latest/download/install.sh | sh

v0.10.2 · Linux、macOS、Windows（WSL 2）· MIT

01 / 电脑上开工

你在电脑前让 Claude Code 重构一个模块，然后得出门。

合上笔记本，agent 还在干活。总览里按仓库分组列出所有会话，实时显示谁在运行、谁在等你、屏幕上正在发生什么。

了解会话列表

02 / 手机上接管

地铁上手机亮起，它停下来问你一个问题。

锁屏推送叫你回来。可以用软键栏在原生 TUI 里回答，也可以把同一段对话切到聊天视图；回一句话它就继续。

了解需要你介入的提醒

03 / 回到电脑审阅

到了公司打开浏览器，改动的 Diff 已经摆在终端旁边。

审完在同一个终端里接着干，一键把路径:行号发给 agent。这一路是同一个进程，一行输出都不会丢。

了解代码工作区

为什么会爱上它

一个约 24 MB 的单二进制，把终端会话放在服务端。

断线不断会话: 锁屏、换网、关标签页都不影响；重连只补发缺失的输出。
原样运行你的 agent: Claude Code、Codex、omp 等九款 CLI 预置即用，跑在真实 PTY 里。
TUI ↔ 聊天一键切换: 同一段对话，电脑上用 TUI，手机上用聊天视图，历史完整保留。
它在等你时会告诉你: 识别 agent 的提问与授权请求：总览标记、标签页提示、锁屏推送。
写代码的工作台: 分屏、草稿模式、资源管理器与 Diff、多格式预览、Git worktree、终端里显示图片。
轻到可以忘了它: 单二进制、空闲约 13 MB 内存，无需 root、tmux 或数据库；Windows 经 WSL 2 一等支持。

界面一览

全部是真实界面截图，来自 WebMux 仓库。

混合会话：同一段对话切换到聊天视图 — 混合会话：同一段对话在 TUI 与聊天视图间切换

更多截图：分屏、终端图形、资源管理器、启动配置

终端分屏与草稿模式 — 终端分屏 + 草稿：最多 8 个窗格，Ctrl+B 前缀操作

浏览器终端中显示 Kitty 协议图片 — 终端图形：Kitty 图形协议，agent 可直接显示图片

预置的 CLI agent 启动配置 — 启动配置：预置九款 CLI agent，可自由编辑

混合会话

同一段对话，电脑上用 TUI，手机上用聊天视图。

OpenCode、omp、Codex CLI 与 Claude Code 可以在终端与聊天视图之间切换，历史完整保留；聊天端支持附件、权限请求作答与 Token 用量。Codex CLI 与 Claude Code 的聊天端需要另装第三方 ACP 连接器（codex-acp、claude-agent-acp），它们不是 WebMux 或 agent 厂商的官方组件。

混合会话文档

预置九款 CLI agent

外加 Shell 与 omp。图标只用于说明兼容性，各商标归其所有者。

查看兼容矩阵

两分钟装好

1. 安装。 自动识别 Linux / macOS 与 amd64 / arm64，校验 SHA-256 后装到 ~/.local/bin，不需要 sudo，也不改写 shell 配置。
```
curl -fsSL https://github.com/mzdluo123/webmux/releases/latest/download/install.sh | sh
```
2. 运行。 然后在浏览器打开 http://127.0.0.1:7681，点击“新建会话”。
```
webmux --listen 127.0.0.1:7681
```
3. 下一步： 让服务常驻后台、从手机访问、在常用终端里启动 agent。

Debian / Ubuntu. arm64 设备请在下载表中选择对应的包。

curl -LO https://github.com/mzdluo123/webmux/releases/download/v0.10.2/webmux_0.10.2-1_amd64.deb
sudo apt install ./webmux_0.10.2-1_amd64.deb

Fedora / RHEL / openSUSE. arm64 设备请在下载表中选择对应的包。

curl -LO https://github.com/mzdluo123/webmux/releases/download/v0.10.2/webmux-0.10.2-1.x86_64.rpm
sudo dnf install ./webmux-0.10.2-1.x86_64.rpm

开机自启。 软件包不会为任何用户启用服务；首次启动会在 ~/.config/webmux/config.toml 生成带随机 Token 的配置。
```
systemctl --user enable --now webmux
```

不用脚本时，手动下载对应平台的二进制与 SHA256SUMS，校验后安装（以 Linux amd64 为例）：

curl -LO https://github.com/mzdluo123/webmux/releases/latest/download/webmux-linux-amd64
curl -LO https://github.com/mzdluo123/webmux/releases/latest/download/SHA256SUMS
sha256sum --check --ignore-missing SHA256SUMS   # macOS: shasum -a 256 -c --ignore-missing SHA256SUMS
install -m 755 webmux-linux-amd64 ~/.local/bin/webmux

其他平台把文件名换成 webmux-{linux,darwin}-{amd64,arm64}。安装与升级文档

安全边界

WebMux 等同于以当前用户身份把 shell 暴露到网络，默认监听 0.0.0.0:7681。仅本机使用请改为 127.0.0.1；远程访问请绑定 Tailscale / WireGuard 等可信 VPN；除非明确使用隧道并接受“Token 是唯一入口屏障”的风险，不要开放到公网。它不是进程沙箱，服务重启会结束所有终端会话。阅读安全模型

和你现在用的方案比

WebMux 与常见方案的对比摘要
维度	WebMux	SSH + tmux	ttyd / gotty	mosh
浏览器 / 客户端断开后会话继续	是PTY 由服务端持有；服务重启会结束会话	是tmux 会话在 detach 后继续	未核实需自行配合 tmux；ttyd 有 --once 断开即退出	部分官方说明支持漫游与休眠后恢复连接
手机 TUI 适配（软键栏、触摸滚动）	是软键栏、触摸滚动、锁定终端尺寸	部分取决于手机上的 SSH 客户端	未核实官方文档未说明	未核实官方文档未说明
agent 提问 / 授权推送到锁屏	是取决于 CLI 发出的状态信号；推送需 HTTPS	未核实官方文档未说明	未核实官方文档未说明	未核实官方文档未说明
聊天视图与 TUI 互切	部分Claude Code、Codex CLI、OpenCode、omp	否纯终端	否纯终端	否纯终端
单二进制，无需 root、数据库	是约 15 MB 静态二进制，无需 tmux	部分需要 sshd 与 tmux；tmux 无需 root	是单个可执行文件	部分无特权代码、无守护进程；需 SSH 与 UDP 端口

WebMux

浏览器 / 客户端断开后会话继续: 是 · PTY 由服务端持有；服务重启会结束会话
手机 TUI 适配（软键栏、触摸滚动）: 是 · 软键栏、触摸滚动、锁定终端尺寸
agent 提问 / 授权推送到锁屏: 是 · 取决于 CLI 发出的状态信号；推送需 HTTPS
聊天视图与 TUI 互切: 部分 · Claude Code、Codex CLI、OpenCode、omp
单二进制，无需 root、数据库: 是 · 约 15 MB 静态二进制，无需 tmux

SSH + tmux

浏览器 / 客户端断开后会话继续: 是 · tmux 会话在 detach 后继续
手机 TUI 适配（软键栏、触摸滚动）: 部分 · 取决于手机上的 SSH 客户端
agent 提问 / 授权推送到锁屏: 未核实 · 官方文档未说明
聊天视图与 TUI 互切: 否 · 纯终端
单二进制，无需 root、数据库: 部分 · 需要 sshd 与 tmux；tmux 无需 root

ttyd / gotty

浏览器 / 客户端断开后会话继续: 未核实 · 需自行配合 tmux；ttyd 有 --once 断开即退出
手机 TUI 适配（软键栏、触摸滚动）: 未核实 · 官方文档未说明
agent 提问 / 授权推送到锁屏: 未核实 · 官方文档未说明
聊天视图与 TUI 互切: 否 · 纯终端
单二进制，无需 root、数据库: 是 · 单个可执行文件

mosh

浏览器 / 客户端断开后会话继续: 部分 · 官方说明支持漫游与休眠后恢复连接
手机 TUI 适配（软键栏、触摸滚动）: 未核实 · 官方文档未说明
agent 提问 / 授权推送到锁屏: 未核实 · 官方文档未说明
聊天视图与 TUI 互切: 否 · 纯终端
单二进制，无需 root、数据库: 部分 · 无特权代码、无守护进程；需 SSH 与 UDP 端口

第三方信息按官方文档核对于 2026-11-03；“未核实”表示官方文档未说明。查看全部对比

常见问题

查看全部问题

重启服务后会话去哪了？

会话、PTY 和缓冲只保存在内存中，服务重启即结束所有会话。这是有意的设计边界：WebMux 不使用数据库、不做守护进程分离，也不与 tmux 互通。只有显式登记的状态文件（仓库清单、启动配置、偏好等，见持久化清单）会持久保存，会话本身不会。例外是混合会话：WebMux 记录它与 agent 会话的对应关系，重启后可从首页“可恢复”分组恢复，对话本身由 agent 保存。

创建会话时找不到 claude / codex？

systemd 和 launchd 不会加载你的交互 shell 配置。可在自定义启动配置中显式使用 bash -ic 'exec opencode "$@"' opencode 来加载 ~/.bashrc 中的 PATH 和环境变量，或把程序目录加入服务的 PATH，参见 agent 的 PATH。

手机怎么访问？

推荐在服务器和手机上安装 Tailscale 并加入同一网络，在配置中设置 [tailscale] mode = "serve"，手机打开 https://<节点>.ts.net/；也可以把监听地址设为服务器的 Tailscale / WireGuard 地址，并输入一次 token。防火墙应只允许可信 VPN 接口访问该端口。HTTPS 地址还可以安装为应用并接收锁屏推送。详见手机访问。

WebMux 安全吗？

WebMux 以启动服务的系统用户身份执行任意命令，等同于把一个 shell 暴露到网络上；它不是进程沙箱，也不提供多用户隔离。安全依赖网络隔离：仅本机使用请监听 127.0.0.1:7681，远程访问绑定 Tailscale / WireGuard 等可信 VPN，并使用随机 token（首次启动会生成 256 位 Token）。不要直接暴露到公网；确需公网访问时只用受控隧道，此时 Token 是唯一入口屏障。详见安全与部署建议。

Windows 能用吗？

能，但服务不原生运行在 Windows 上，而是运行在 WSL 2 发行版中。需要 Windows 10 22H2 及以上或 Windows 11，以及从 Microsoft Store 安装的 WSL 2；托盘程序负责安装 / 升级、启动、监控和远程访问转发，无需管理员权限，webmux.exe 可在 PowerShell / Windows Terminal 中 run / attach WSL 里的会话。详见 Windows（WSL）部署。

收费吗？用什么许可？

WebMux 是 MIT 许可的开源项目，不收费，源码在 GitHub。它不代管模型密钥：Claude Code、Codex 等 CLI 使用服务用户自己的账号、订阅与配置，相关费用和条款由各 agent 厂商决定。

开源、MIT、单二进制。

复制命令装好它，或者先到 GitHub 看看源码。

curl -fsSL https://github.com/mzdluo123/webmux/releases/latest/download/install.sh | sh

在 GitHub 上查看

让 agent 在服务器上一直跑，你在任何设备上随时接管。

它怎么工作