ガイド

どこからでも自分のマシンへ接続する

エージェントが動いているマシンは、たいてい自宅ルーターや社内ネットワーク、デスク上のノート PC など NAT の内側にあります。SSH をインターネットへ公開せずに iPhone から到達する方法をまとめます。

解決策は 2 つあります。1 つはルーターでポート転送すること。もう 1 つは両方のマシンを プライベートなメッシュネットワークに参加させ、インターネット側には一切待ち受けポートを開けず、 安定したアドレスで通信することです。このガイドでは後者を扱います。前者はサーバー乗っ取りの定番原因だからです。

1 サーバーをメッシュに参加させる

Tailscale、NetBird、headscale、素の WireGuard——いずれも中身は WireGuard メッシュです。 サーバーでコマンドを 1 つ実行するだけで、自分の端末からだけ到達できる固定アドレスが得られます。

Tailscale では 100.64.0.0/10 のアドレスと、m1-pro.your-tailnet.ts.net のような名前が割り当てられます。

2 iPhone を同じメッシュに入れる

各サービスの iOS アプリを入れてサインインすると VPN プロファイルが追加されます。 この段階では Moshpit の操作は不要です。

iOS は原則として同時に 1 つの VPN トンネルしか張れないため、社内 VPN とメッシュは通常併用できません。

3 Moshpit に接続を追加する

ホスト = メッシュの名前またはアドレス。ポート = 変更していなければ 22。 ユーザー名、そして認証欄で SSH キー を選びます。

Moshpit は入力されたアドレスへそのまま接続します。統合に必要な作業はそれだけです。

Moshpit 自体には VPN 機能も Tailscale 固有の連携もありません。 ダイヤルも経路制御も端末探索も行いません。 フォームに入力されたホスト文字列へ TCP を張り、mosh の場合は同じホストへ UDP を送るだけです。 iPhone から到達できるアドレスなら、Moshpit からも接続できます。

保存モデルの内部に useTailscale というフィールドが残っていますが、アプリのどこからも参照されておらず、 フォームにも表示されません。トグルを探し回らずに済むよう、ここに明記しておきます。

まず、やってはいけないこと

パスワード認証のままポート 22 を開放しない。

公開された SSH ポートは数分以内にスキャナに見つかります。パスワード認証が有効だと、 無制限の総当たり攻撃の的になります。メッシュを使えば強化する以前に標的そのものを消せます。

どうしてもメッシュを使えない場合

ネットワーク環境によってはメッシュが組めないこともあります。やむを得ず SSH を公開するなら、 公開鍵認証のみに絞るのが最低ラインです(推奨ではなく最低限の防御です):

# /etc/ssh/sshd_config.d/moshpit.conf
PasswordAuthentication no
KbdInteractiveAuthentication no
PermitRootLogin no
AuthenticationMethods publickey
# check it parses, then reload: sudo sshd -t && sudo systemctl reload ssh

設計前に知っておくべき Moshpit 側の仕様が 3 つあります:

  • 認証方式は 2 種類のみ。 パスワードと公開鍵です。keyboard-interactive には対応していないため、 TOTP プロンプトを要求する sshd 設定ではサインインできません。
  • エージェント転送は非対応。 なお 1.1.0 では 1 ホップの踏み台ホストに対応しました(詳しくは 踏み台ホスト を参照)。 エージェント転送(forwardAgent)には対応していません。
  • インライン貼り付けのパスフレーズ付き秘密鍵に注意。 接続フォームへ直接貼り付ける暗号化 PEM ではなく、 Moshpit 内で生成した鍵(設定 → SSH キー → +)を使い、公開鍵をサーバーへ登録してください。 Secure Enclave に保存して Face ID で保護できます。

UDP が重要な理由

UDP は 2 つの層に、別々の理由で登場する。

下の層では WireGuard が UDP プロトコルだから。上の層では mosh が UDP を使うから。 両者は壊れ方が違うため、頭の中で分けておくと切り分けが楽になります。

下層のメッシュ

wireguard · udp

  • Tailscale は 2 台の間に 直接 UDP 経路 を張ろうとします(既定ポートは双方からの送信 UDP 41641)
  • NAT 越えできない場合は リレー に切り替わります。動作はしますが遅延が増えます
  • どちらの端末でも tailscale status を打てば direct かリレー経由か分かります
  • ルーター側でインバウンドポートを開く必要はありません

上層の mosh

トンネルの内側

  • mosh はエンドツーエンドで UDP を使い、メッシュ上では トンネル内の UDP になります(ルーターからは見えません)
  • mosh-server は設定範囲(既定 60000–61000)から セッションごとに 1 ポート を確保します
  • Moshpit はフォームに書かれた 同じホスト名・アドレス と、サーバーから返されたポートへデータグラムを送ります
  • mosh は最初に SSH ログインが通らないと起動できません。UDP の前に TCP が通る必要があります
ブートストラップの仕組み

SSH が起動して、あとは退く

Moshpit は認証済み SSH セッション上でコマンドを 1 つ実行し、返ってくる 1 行を読み取ったら SSH を閉じます。 そこから先はすべて UDP です。

接続後に SSH を止めても mosh が生き残り、UDP を止めると止まるのはこのためです。 また TCP は通っても UDP リレーが極端に遅いメッシュでは、素の SSH の方が快適に感じられることもあります。

PATH="$PATH:/opt/homebrew/bin:/opt/homebrew/sbin:/usr/local/bin:/usr/local/sbin:$HOME/.local/bin" \
  mosh-server new -s -c 256 -p 60000:61000 -l LANG=en_US.UTF-8

MOSH CONNECT 60001 <22 base64 chars = a 16-byte AES-128 key>

どこで何を開放する必要があるか

対象ポート向き理由
SSHTCP 22 (または指定ポート) サーバーのインバウンド mosh に単独起動モードはなく、SSH が mosh-server を起動して鍵を受け取る
mosh セッションUDP 60000–61000 サーバーのインバウンド、iPhone からのアウトバウンド 1 セッションにつき 1 ポートを mosh-server が範囲内から選択
メッシュ直接経路UDP 41641 双方からのアウトバウンド Tailscale の既定ポート。遮断されてもリレー経由で動作は継続
自宅ルーター不要 — ポート転送は一切不要。これがメッシュを使う最大の理由

メッシュ上での「サーバーのインバウンド」とは、メッシュインターフェース上のインバウンドを指します。 ufw や firewalld、クラウドのセキュリティグループはトンネルと mosh-server の間に存在します。 tailscale0 上で範囲を開けることは全世界へ開放することとは別であり、ここを見落とすケースが一番多く見られます。

範囲の変更は 設定 → ターミナル → UDP ポート範囲(開始 / 終了、1–65535 で 開始 ≤ 終了)で行えます。 接続フォームにも同じ範囲が読み取り専用で表示されます。

よくある落とし穴

アドレスは 1 つに決め、どこでもそれを使う。

バグに見えて実は仕様通りの挙動という最たる例です。一晩溶かす人も多いので独立した章にしています。

Moshpit は mosh-server new -s で起動します。これは mosh 1.4 以降の既定である --bind-server=ssh を意味し、SSH ログインが届いたアドレスにだけバインドします。 ログイン時と同じ経路でデータグラムを往復させるための意図的な設計です。

その結果:

  • 自宅で 192.168.1.30 に接続して始めたセッションの mosh-server は 192.168.1.30 にバインドされます。メッシュ経由では到達できません。
  • メッシュ経由で始めたセッションはメッシュアドレスにバインドされ、LAN アドレスからは到達できません。
  • どちらも Moshpit の不具合ではなく、--bind-server=ssh の仕様そのものです。

対策はシンプルです。メッシュ名で接続を保存し、自宅にいるときもそれを使ってください。 同一 LAN 内のメッシュ通信は自動でローカル直接経路になります。アドレスも接続設定も 1 つにしておけば、 外へ出た瞬間に切れる驚きがなくなります。

孤立した mosh-server が溜まる問題

接続するたびに新しい mosh-server が起動します。回線が切れても古いプロセスはすぐ終了せず、 UDP ポートを握ったまま残ります。何週間も再接続を繰り返すと溜まっていきます。 Moshpit はこれらを自動回収しておらず、ここは意図ではなく現状の課題です。

pgrep -fl mosh-server                 # 残っているプロセスを確認
lsof -nP -iUDP | grep mosh-server     # それぞれがバインドしているアドレスを確認
pkill -f mosh-server                  # 一括終了(稼働中セッションも終了するので注意)

2 つ目のコマンドで見えるバインドアドレスは診断にも役立ちます。 そのセッションがどのネットワークから作られたかが分かるため、応答しなくなった理由をすぐ突き止められます。

iOS

ローカルネットワーク権限と、拒否したときの症状

iOS はローカルネットワークへのアクセスを初回 1 回だけのダイアログで管理します。 数か月前に別の画面でうっかり拒否していると、次のような症状になります。

確認ダイアログ

表示は一度きり

LAN アドレスへの初回接続時に表示されます。Moshpit の説明文には、ローカルネットワーク上のサーバーへ SSH や mosh(UDP)で接続するために必要であることが記載されています。

拒否された場合

SSH は通るのに mosh が真っ黒になる

iOS が LAN 向け UDP を黙って破棄します。TCP には影響しないため SSH は問題なく動き、 mosh だけがカーソルの出た黒い画面のまま止まります。

対処法

設定 → Moshpit → ローカルネットワーク

ダイアログは自動では再表示されません。iOS の設定からオンにして、セッションを再接続してください。

対象範囲を明確にしておくと、この権限が影響するのは 192.168.x.x や 10.x.x.x などの LAN アドレスです。メッシュアドレス宛ての通信は VPN トンネル経由になります。 それでも LAN アドレスで繋ぐ可能性があるなら許可しておくのが無難です。ファイアウォール障害とまったく同じ見え方をするため、 切り分けで遠回りすることになるからです。

確認手順

この順番で確認する 6 ステップ

各ステップで下のレイヤーを切り分けます。飛ばさずに進めてください。原因はたいてい 1 か 2 にあります。

1 · ピアがオンラインで、direct になっているか?

tailscale status          # ピア行の末尾が "direct" かリレー名か確認
tailscale ip -4           # ホスト欄に入力するアドレス

リレー経由でも動きますが遅延が増え、回線状態が悪い日には実用性の分かれ目になります。

2 · 同じメッシュ上のノート PC から素の SSH が通るか?

ssh -v user@m1-pro.your-tailnet.ts.net

ここが通らなければ先に進んでも解決しません。mosh に単独モードはなく、Moshpit もまず SSH クライアントだからです。

3 · UDP が本当に往復できているか?

多くの人が飛ばしがちですが、原因を一発で特定できる確認です。設定範囲内のポートを 1 つ選び、 サーバーで待ち受け、iPhone と同じネットワークのマシンから送信します:

# サーバー側
echo REPLY | nc -u -l 60005 > /tmp/udp-in

# iPhone と同じ Wi-Fi 上のノート PC から
echo PING | nc -u -w3 m1-pro.your-tailnet.ts.net 60005

双方が相手の文字列を受け取れる必要があります。サーバーには PING が届くのに クライアントへ REPLY が戻らないなら戻り経路が塞がっており、それが mosh の黒画面そのものです。 アプリではなくネットワーク側の問題と確定します。

4 · 通信が届くインターフェースでポート範囲が開いているか?

sudo ufw status verbose                       # Debian / Ubuntu
sudo firewall-cmd --list-all                  # Fedora / RHEL
sudo ufw allow in on tailscale0 to any port 60000:61000 proto udp

クラウドを使っている場合はセキュリティグループも別途確認し、Moshpit 側で設定している範囲 (既定 60000–61000、変更可能)と一致しているかも確認してください。

5 · アプリ側からどう見えているか確認する

mosh セッション中にターミナル上部バーのトランスポートピルを長押しすると MOSH DIAGNOSTICS が開きます。 datagrams、applied、parse fails、gaps が並びますが、 最も重要なのは数値ではない次の 1 行です:

MOSH DIAGNOSTICS
   No datagrams yet.

このカウンタは復号や解析より前に加算されるため、これが表示されるときは文字通り 1 パケットも戻っていません。 戻り経路が死んでいます。Moshpit の設定いじりを止めてステップ 3 へ戻ってください。

6 · 非常口を使う

いまいるネットワークが UDP を落としていて、すぐターミナルを使いたいときは、 バナーの SSH に切り替え を押すか、上部バーの MOSH ピルをタップして「SSH に切り替えますか?」を確定します。 SSH はデータグラムが落ちた同じ経路を TCP で通ります。バナーは閉じることができ操作を妨げません。

⚠  Mosh isn't receiving data — your network may be
   blocking UDP (VPN, proxy, or firewall).

   Switch to SSH                                    ×

約束ではなく、ひとつの実測データ

まだ大規模な統計値はありませんが、開発テストに使っている 1 台のホストでの実測値は、 曖昧な形容詞よりずっと参考になります。

モバイル回線経由の Tailscale 直接経路で接続した Mac: RTT 433–640 ms、パケットロス約 13%。この回線では SSH ハンドシェイクに 5.8–9 秒かかります。 それでも Mosh は動作します。素の mosh セッションの初期画面は約 10 秒で表示され、 mosh+tmux は SSH ハンドシェイクが 2 回走るため、ネイティブのパンくずリストが埋まるまで 20–25 秒かかりました。

これは所有ハードウェア上の 1 回線を測った一例であり、ベンチマークではありません。 「パケットロスに強い」と言う以上、実際の数字を添えるべきだと考えて載せています。

この検証から分かった注意点も 2 つあります。ノート PC がスリープするとメッシュから完全に外れること(direct → relayed → offline)、 そして重いプラグイン構成の tmux サーバーは初回起動時にデッドロックすることがある点です。 どちらもネットワーク障害ではありませんが、外からはまったく同じに見えます。

運用前に知っておくべき制限

接続できたあとにも残る制約。

バックグラウンドではアプリが停止する iOS は Moshpit と 12 秒ごとの keepalive、ポーリングを停止します。ライブのエージェント状態はアプリへ戻るまで更新されませんが、 ホストから直接送られるエンドツーエンド暗号化プッシュ通知は届き続けます。 20 秒以上離れていた場合は、半開きソケットの誤判定を避けるため復帰時に明示的に再接続します。

mosh 上では tmux と herdr は独自の TUI で動く Mosh は行区切りの生バイト列ではなく描画済み画面差分を送るため、tmux -CC や herdr のフレームプロトコルは通りません。 どちらも mosh シェル内で通常の全画面インターフェースとして動作し、ネイティブ一覧シートは別立ての軽量 SSH 接続から取得します。 そのため UDP は通っても SSH が遮断されている環境では、ネイティブ一覧なしの tmux になります。

herdr のダイレクトアタッチはペインごとに排他 Moshpit は --takeover でアタッチします。同じ herdr ペインに 2 台の Moshpit を繋ぐと約 2 秒ごとに奪い合いになります。 これは herdr 側の排他仕様によるものです。デスクトップの herdr TUI はアタッチ枠を占有しないため安全な見込みですが、未検証です。

herdr 0.7.3 はペインコマンド名を返さない Homebrew 安定版の 0.7.3 ではスナップショットにコマンド名が含まれないため、パンくずリストは pane N になります。 見た目上の問題ですが、ペイン選択シートへの入口なので覚えておくと便利です。

信頼済みホストキーの一覧表示・個別削除は未対応 初回接続時に指紋と ssh-keygen コマンドを表示します。その後の一覧画面や「このホストを忘れる」はなく、 接続を削除しても指紋は残ります。正当な鍵更新は警告ダイアログで承認します(既定ボタンは 切断、更新ボタンは破壊的操作として表示)。

よくある質問

リモート接続に関する具体的な疑問。

Tailscale を使う必要がありますか?

いいえ。Moshpit は指定されたアドレスに接続するだけで、そこへどう到達させるかは完全に自由です。 NetBird、headscale、素の WireGuard、ZeroTier、社内 VPN、固定グローバル IP のサーバーなど、アプリ側から見ればすべて同じです。 ゼロから動かす最短ルートとして Tailscale を例に挙げています。

踏み台ホスト経由で接続できますか?

はい。Moshpit 1.1.0 から 1 ホップの踏み台ホスト(ssh -J 相当)に対応しました。 踏み台ホストを接続として保存し、接続先の「経由接続」で選択します(通信は SSH になります)。 詳しくは 踏み台ホスト をご覧ください。なおエージェント転送には対応しておらず、 UDP の必要な mosh を使いたい場合はメッシュ構成が有効です。

5G では繋がるのに会社の Wi-Fi だと動きません。

ほぼ確実に、送信 UDP は通すのに戻り UDP を落とすネットワーク環境(スプリットトンネル VPN、プロキシ、社内ファイアウォールなど)です。 同じ経路を TCP で通る SSH だけは動き続けます。上記の nc -u 確認をその Wi-Fi で実行し、 モバイル通信では返るのに Wi-Fi で返らないなら原因確定です。

会社の VPN とメッシュを同時に使えますか?

一般的に iOS では同時に 1 つの VPN トンネルしか有効にできません。会社の VPN を常時オンにする必要がある場合、 メッシュは同時起動できないため、社内ネットワークから到達できる経路を使うことになります。これは iOS の制約です。

Moshpit にメッシュや他のマシンが見られますか?

いいえ。ネットワーク探索機能もアカウントもありません。アプリが知るのはあなたが入力した接続先だけで、 ターミナル通信もそこだけへ向かいます。Moshpit が運用する唯一の要素は通知プッシュリレーですが、 解読不能な暗号化通知を中継するだけで、メッシュやセッションには一切触れません。 ローカルネットワーク権限もスキャン用ではなく、iOS が LAN 宛て UDP を落とさないようにするためだけのものです。

帰宅したら mosh セッションが切れました。なぜですか?

ほとんどの場合、アドレスの違いが原因です。mosh-server は SSH ログインが届いたアドレスにだけバインドするため、 メッシュ経由で作ったセッションには LAN アドレスから届かず、逆も同様です。接続設定にはメッシュ名を保存し、 自宅でもそれを使ってください。上の アドレスは 1 つに決める をご覧ください。

続けて読む: iPhone から Claude Code を動かす · ガイド一覧へ戻る