常见问题

Linux / macOS 可运行 curl -fsSL https://github.com/mzdluo123/webmux/releases/latest/download/install.sh | sh，脚本自动识别架构并校验 SHA-256，安装到 ~/.local/bin/webmux，不需要 root。也可以使用 deb / rpm 安装包、手动下载、Windows 安装程序或从源码构建，见 下载与安装 与 安装与升级。

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

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

能，但服务不原生运行在 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 厂商决定。

会话只在内存中；状态目录只保存显式登记的 JSON 文件（仓库清单、启动配置、偏好、推送、隧道与 Tailscale 设置、混合会话记录），见 持久化清单。终端输入输出不会写入日志，配置接口不返回 token。按 2026-11-03 对源码的检索，WebMux 不包含遥测或使用统计代码；对外连接只发生在你启用的功能中，例如下载 cloudflared、隧道与手机推送。

不能当作多用户系统使用。WebMux 只有一个共享 token，所有命令以启动服务的系统用户身份运行，不提供多用户隔离。拿到 token 的人与你拥有同样的 shell 权限；需要隔离时请为每个人使用独立的系统用户和独立的 WebMux 实例。

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

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

两端共享同一个 PTY，但只有控制端决定终端尺寸：先打开的设备控制，后打开的设备观察（按原网格显示、可平移）。在观察端输入或点击“接管控制”即可切换。

HTTP 不是浏览器安全上下文，Clipboard API 不可用。WebMux 会回退到文本框手动粘贴 / 复制；也可以通过 tailscale serve 或 Caddy 提供 HTTPS，见 HTTPS。

缓冲按字节环形存储，最旧的数据可能从多字节字符或转义序列中间开始，属于设计允许范围。

首次启动生成的 token 持久化在配置文件中，可用 webmux status --json --reveal-token 查看，或用 webmux config path 找到配置文件。详见 配置。

升级需要重启服务，重启会结束所有终端会话。升级前先让 agent 告一段落，见 升级。