コンテンツにスキップ
moshpit
JA

ドキュメント · トピック

Mosh

Mosh を使うと、Wi-Fi とモバイル通信の切り替え、IP アドレスの変更、端末のスリープ、パケットロスの多い回線でもターミナルセッションを維持できます。接続フォームの Mosh を使用 でホストごとに有効化できるほか、設定 › ターミナル › 新規接続で Mosh を使用 で既定値にできます。

ホストに mosh-server をインストールする

Section titled “ホストに mosh-server をインストールする”

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 セッションはサーバー側で 1 つの UDP ポートを使用します(既定の範囲は 60000–61000)。サーバーのファイアウォールやクラウドのセキュリティグループでこの範囲のインバウンド UDP を許可し、利用中のネットワークでアウトバウンド UDP が通ることを確認してください。

すべての接続で使うポート範囲を狭めたり変更したりするには:

  1. 設定 › ターミナル › UDP ポート範囲 を開きます。
  2. 開始 と 終了(1〜65535)を設定します。
  3. 保存 をタップします。

遅延の大きい回線でサーバーからの応答を待つあいだ、入力した文字を先行表示し、サーバー側で確定するまで下線やトレイルで示すことができます。

既定値は 設定 › ターミナル › 予測エコー で設定でき、ホストごとに 接続を編集 の 予測モード で上書きできます:

モード 動作
自動(Adaptive) 往復遅延が大きくなったときにのみ入力を予測表示します。
常に(Always) 遅延の大きさにかかわらず、すべての Mosh セッションで予測表示します。
なし(Never) すべての文字についてサーバーからのエコーを待ちます。

設定 › ターミナル の カーソル セクションで 予測時のトレイル のオン・オフも切り替えられます。

ローミングとバックグラウンド復帰

Section titled “ローミングとバックグラウンド復帰”

ネットワークが切り替わったりスリープから復帰したりしたとき:

  • Moshpit に戻った時点で mosh-server が稼働して到達可能であれば、再接続なしでそのまま作業を再開できます。
  • ネットワーク切替直後でまだ UDP 応答が返っていない間は、通知を表示しつつ入力をキューに溜め、サーバーが応答した瞬間にまとめて送信します。
  • ターミナル上部バーの MOSH ピルを長押しすると、RTT やパケットカウンタの確認と 画面を再描画 が行えます。

次のようなケースでは Mosh を使用 をオフにするか、UDP が通らないときに表示される SSH に切り替え をタップしてください:

  • 踏み台ホスト:Mosh は対象マシンへの直接 UDP 通信が必要です。経由接続 を使う接続は自動的に SSH になります(詳しくは踏み台ホストを参照)。
  • UDP が遮断されたネットワーク:60000–61000 の UDP パケットを落とすゲスト Wi-Fi や厳格なファイアウォール。
  • インライン画像表示:Mosh は生バイト列ではなく文字画面の状態を同期するため、kitty・iTerm2・sixel のインライン画像を使うには SSH が必要です(詳しくはターミナルの閲覧と操作を参照)。