跳转到内容
moshpit

文档 · 专题

Mosh

Mosh 能让终端会话撑过 Wi-Fi 切 5G、IP 变动、手机息屏和高丢包网络。你可以在单条连接里打开 使用 mosh,也可以在 设置 › 终端 › 新连接默认用 mosh 里把它设为新建主机的默认项。

Moshpit 会先通过 SSH 登录主机启动 mosh-server,随后切到 UDP 通信。在服务器上用系统包管理器装好 mosh 即可:

Terminal window
# Debian / Ubuntu
sudo apt install mosh
# Fedora / RHEL
sudo dnf install mosh
# macOS(Homebrew)
brew install mosh

如果 mosh-server 不在默认 PATH 里(比如装在 /opt/homebrew/bin/mosh-server),可以在连接表单底部的 高级 › mosh-server 路径 里填上完整路径。连接时要是主机没装 mosh-server,Moshpit 会直接说明并改走 SSH,不会卡死或静默失败。

每个 Mosh 会话会在服务器上占用一个 UDP 端口,默认范围是 60000–61000。服务器的系统防火墙和云厂商安全组需要放行这段 UDP 入站端口,手机所在网络也需要放行 UDP 出站。

要统一修改所有连接使用的端口范围:

  1. 打开 设置 › 终端 › UDP 端口。
  2. 填入起始端口与 结束 端口(1–65535)。
  3. 点 保存。

网络延迟高时,Mosh 可以在服务器回包前先把你敲下的字符画在屏幕上,等服务器确认后再落定。

在 设置 › 终端 › 预测回显 里设全局默认值,或在单条连接的 预测模式 里单独指定:

模式 表现
自适应 往返延迟升高时才开启本地预测回显。
始终 所有 Mosh 会话全程开启预测回显。
从不 每个字符都等服务器回传后再显示。

在 设置 › 终端 的 光标 一栏里,还可以开关 预测时显示轨迹。

当你带着手机出门换网,或切去别的 App 一阵子再回来:

  • 只要主机上的 mosh-server 还在且 UDP 通畅,回到 Moshpit 时连接会直接接着用,不用重连。
  • 刚换完网络、暂时还没收到 mosh-server 回包时,顶部横幅会说明情况并暂存你刚敲的内容,一收到服务器应答就自动发出去。
  • 长按终端顶栏的 MOSH 传输标签,可以查看当前往返延迟与收发统计,或点 重绘屏幕。

遇到下面几种情况,请关掉 使用 mosh(或在连不上 UDP 时点 改用 SSH):

  • 经由跳板主机:Mosh 必须用 UDP 直连目标主机。凡是设了 经由 的连接都会走 SSH,见 跳板主机。
  • 网络封了 UDP:酒店、访客 Wi-Fi 或防火墙拦掉了 60000–61000 的 UDP 包。
  • 终端内嵌图片:Mosh 同步的是字符屏幕快照而不是原始字节流,需要看 kitty、iTerm2 或 sixel 内嵌图片时请用 SSH,见 阅读终端。