tmux · iOS

iOS 上的 tmux 与 Herdr:从 iPhone 和 iPad 接入你真正的会话

iOS 上没有官方的 tmux 应用,你也不需要。你真正想要的,是从手机或平板接上自己机器里已经在运行的 tmux(或 Herdr)会话,从上次离开的地方精确续上。这正是 QuickTUI 所做的事。

iPhone 上带 tmux 控制的 QuickTUI 终端工具栏
QuickTUI 终端工具栏——tmux 窗口、窗格与按键都在拇指可及之处。

tmux 让你的终端会话在电脑上持续运行:长时间的构建、Agent、日志跟踪和 SSH shell,在你断开连接后都能继续存活。一直缺的那块拼图,是从 iPhone 或 iPad 顺畅接入它们的方式。QuickTUI 是原生 iOS 客户端(另有 iPad 与浏览器版本),通过你自己的电脑接入这些会话,中间没有任何第三方。

一个"iOS tmux 客户端"应该做到什么

动手配置(约两分钟)

在运行会话的机器上安装 QuickTUI 服务端。它会配置好服务。macOS/Linux 需自行安装 tmux 3.2+(安装器不代装 tmux);Windows 会自动安装 qscn 会话后端。

macOS / Linux

curl -fsSL https://quicktui.ai/q.sh | sh

Windows (PowerShell)

irm https://quicktui.ai/q.ps1 | iex

Windows 说明:会话后端是 qscn,不是 tmux。请在 App 里用 New Session 建会话;下文的 tmux new-session 示例适用于 macOS/Linux。

然后用下面的平台命令完成扫码配对。二维码会注册当前设备并固定 server identity,不需要输入 root token。打开一个会话,你就接上了。想要逐步操作的版本,参见从手机接入 tmux 会话

# macOS / Linux
quicktui-server pairing qrcode

# Windows(PowerShell)
& "$env:LOCALAPPDATA\QuickTUI\quicktui-server.exe" pairing qrcode

它真的是 tmux 吗?

是的。在 macOS/Linux 上 QuickTUI 驱动的是你电脑上真正的 tmux,而不是重新实现的替代品。你现有的 ~/.tmux.conf、按键绑定、窗口和窗格全都生效。如果尚未安装 tmux,请自行安装 3.2+(安装器不代装);也可用 QUICKTUI_TMUX_BIN 指向已有二进制。Windows 上默认会话后端是自动安装的 qscn。

iPhone 和 iPad 上的 Herdr

如果你的 Agent 跑在 Herdr 里而不是裸 tmux,同一个 App 照样适用。在 macOS/Linux 上,QuickTUI 服务端可以把 Herdr v0.8.0(当前已验证的版本)作为会话后端:Herdr 仍是本机会话的所有者,QuickTUI 在其上叠加设备配对、iPhone / iPad / 浏览器客户端和终端多路复用。在配置文件里指向你的 Herdr 二进制并重启服务:

session_backend = "herdr"
herdr_bin = "/absolute/path/to/herdr"

session_backends = "tmux,herdr" 可同时保留两者,Herdr 会话会带 Herdr 标签出现在会话列表里。workspace 请在 Herdr 里创建和管理,QuickTUI 只负责列出、聚焦和接入。截至 2026 年 8 月,Herdr 后端随 preview 通道的服务端发布(install --channel preview),tmux 仍是默认后端。手机不会直接连接 Herdr,连接它的是电脑上的 QuickTUI 服务端。

在 tmux 里跑 Agent?QuickTUI 正是为此而生:在会话里启动 Claude Code、Codex 或任意 CLI Agent,然后从手机上盯着它。参见从 iPhone 运行 Claude Code

一览

能力QuickTUI
原生 iPhone 和 iPad 应用支持
浏览器客户端支持,由你自己的电脑提供
真正的 tmux(窗口、窗格、回滚缓冲)支持
自托管、直连支持,代码绝不经过我们的服务器
跨断连的会话保活支持
会话后端tmux(macOS/Linux)、Herdr(macOS/Linux,preview 通道)、qscn(Windows)
价格单台电脑免费;Pro 为一次性买断

常见问题

iOS 上有官方的 tmux 应用吗?

没有。tmux 是一个服务端程序,没有官方 iOS 应用。QuickTUI 是原生 iOS 客户端,接入运行在你自己电脑上的 tmux。

我需要 SSH 吗?

不需要。QuickTUI 通过 HTTP/WebSocket 与它自己的轻量服务端通信。你可以在局域网内、通过 VPN 或隧道(Tailscale、Cloudflare Tunnel),或经由公网地址访问它。

它能在 iPad 上用吗?

能。iPad 上的 tmux 和 iPhone 上完全一样:同一个应用、同一个实时会话,任何浏览器里也一样。

QuickTUI 支持 Herdr 吗?

支持,限 macOS/Linux。在服务端配置里设置 session_backend = "herdr"herdr_bin;截至 2026 年 8 月,Herdr 后端在 preview 通道的服务端里。iPhone、iPad 和浏览器客户端不会直接连接 Herdr,只连接 QuickTUI 服务端。

Web 配对状态。浏览器访问仅适用于已持有设备凭据的既有 profile。当前 server CLI 不会导出新 Web 或 Desktop profile 配对所需的完整 payload;新设备请用原生 App 扫描二维码配对。