Tailscale、NetBird、headscale、素の WireGuard——いずれも中身は WireGuard メッシュです。 サーバーでコマンドを 1 つ実行するだけで、自分の端末からだけ到達できる固定アドレスが得られます。
Tailscale では 100.64.0.0/10 のアドレスと、m1-pro.your-tailnet.ts.net のような名前が割り当てられます。
エージェントが動いているマシンは、たいてい自宅ルーターや社内ネットワーク、デスク上のノート PC など NAT の内側にあります。SSH をインターネットへ公開せずに iPhone から到達する方法をまとめます。
解決策は 2 つあります。1 つはルーターでポート転送すること。もう 1 つは両方のマシンを プライベートなメッシュネットワークに参加させ、インターネット側には一切待ち受けポートを開けず、 安定したアドレスで通信することです。このガイドでは後者を扱います。前者はサーバー乗っ取りの定番原因だからです。
Tailscale、NetBird、headscale、素の WireGuard——いずれも中身は WireGuard メッシュです。 サーバーでコマンドを 1 つ実行するだけで、自分の端末からだけ到達できる固定アドレスが得られます。
Tailscale では 100.64.0.0/10 のアドレスと、m1-pro.your-tailnet.ts.net のような名前が割り当てられます。
各サービスの iOS アプリを入れてサインインすると VPN プロファイルが追加されます。 この段階では Moshpit の操作は不要です。
iOS は原則として同時に 1 つの VPN トンネルしか張れないため、社内 VPN とメッシュは通常併用できません。
ホスト = メッシュの名前またはアドレス。ポート = 変更していなければ 22。 ユーザー名、そして認証欄で SSH キー を選びます。
Moshpit は入力されたアドレスへそのまま接続します。統合に必要な作業はそれだけです。
Moshpit 自体には VPN 機能も Tailscale 固有の連携もありません。 ダイヤルも経路制御も端末探索も行いません。 フォームに入力されたホスト文字列へ TCP を張り、mosh の場合は同じホストへ UDP を送るだけです。 iPhone から到達できるアドレスなら、Moshpit からも接続できます。
保存モデルの内部に useTailscale というフィールドが残っていますが、アプリのどこからも参照されておらず、
フォームにも表示されません。トグルを探し回らずに済むよう、ここに明記しておきます。
まず、やってはいけないこと
公開された 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 つあります:
forwardAgent)には対応していません。UDP が重要な理由
下の層では WireGuard が UDP プロトコルだから。上の層では mosh が UDP を使うから。 両者は壊れ方が違うため、頭の中で分けておくと切り分けが楽になります。
wireguard · udp
tailscale status を打てば direct かリレー経由か分かりますトンネルの内側
mosh-server は設定範囲(既定 60000–61000)から セッションごとに 1 ポート を確保します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>
| 対象 | ポート | 向き | 理由 |
|---|---|---|---|
| SSH | TCP 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 で 開始 ≤ 終了)で行えます。 接続フォームにも同じ範囲が読み取り専用で表示されます。
よくある落とし穴
バグに見えて実は仕様通りの挙動という最たる例です。一晩溶かす人も多いので独立した章にしています。
Moshpit は mosh-server new -s で起動します。これは mosh 1.4 以降の既定である
--bind-server=ssh を意味し、SSH ログインが届いたアドレスにだけバインドします。
ログイン時と同じ経路でデータグラムを往復させるための意図的な設計です。
その結果:
192.168.1.30 に接続して始めたセッションの mosh-server は
192.168.1.30 にバインドされます。メッシュ経由では到達できません。--bind-server=ssh の仕様そのものです。対策はシンプルです。メッシュ名で接続を保存し、自宅にいるときもそれを使ってください。 同一 LAN 内のメッシュ通信は自動でローカル直接経路になります。アドレスも接続設定も 1 つにしておけば、 外へ出た瞬間に切れる驚きがなくなります。
接続するたびに新しい 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)で接続するために必要であることが記載されています。
iOS が LAN 向け UDP を黙って破棄します。TCP には影響しないため SSH は問題なく動き、 mosh だけがカーソルの出た黒い画面のまま止まります。
ダイアログは自動では再表示されません。iOS の設定からオンにして、セッションを再接続してください。
対象範囲を明確にしておくと、この権限が影響するのは 192.168.x.x や 10.x.x.x などの
LAN アドレスです。メッシュアドレス宛ての通信は VPN トンネル経由になります。
それでも LAN アドレスで繋ぐ可能性があるなら許可しておくのが無難です。ファイアウォール障害とまったく同じ見え方をするため、
切り分けで遠回りすることになるからです。
確認手順
各ステップで下のレイヤーを切り分けます。飛ばさずに進めてください。原因はたいてい 1 か 2 にあります。
tailscale status # ピア行の末尾が "direct" かリレー名か確認 tailscale ip -4 # ホスト欄に入力するアドレス
リレー経由でも動きますが遅延が増え、回線状態が悪い日には実用性の分かれ目になります。
ssh -v user@m1-pro.your-tailnet.ts.net
ここが通らなければ先に進んでも解決しません。mosh に単独モードはなく、Moshpit もまず SSH クライアントだからです。
多くの人が飛ばしがちですが、原因を一発で特定できる確認です。設定範囲内のポートを 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 の黒画面そのものです。
アプリではなくネットワーク側の問題と確定します。
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、変更可能)と一致しているかも確認してください。
mosh セッション中にターミナル上部バーのトランスポートピルを長押しすると MOSH DIAGNOSTICS が開きます。
datagrams、applied、parse fails、gaps が並びますが、
最も重要なのは数値ではない次の 1 行です:
MOSH DIAGNOSTICS No datagrams yet.
このカウンタは復号や解析より前に加算されるため、これが表示されるときは文字通り 1 パケットも戻っていません。 戻り経路が死んでいます。Moshpit の設定いじりを止めてステップ 3 へ戻ってください。
いまいるネットワークが 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 コマンドを表示します。その後の一覧画面や「このホストを忘れる」はなく、
接続を削除しても指紋は残ります。正当な鍵更新は警告ダイアログで承認します(既定ボタンは 切断、更新ボタンは破壊的操作として表示)。
よくある質問
いいえ。Moshpit は指定されたアドレスに接続するだけで、そこへどう到達させるかは完全に自由です。 NetBird、headscale、素の WireGuard、ZeroTier、社内 VPN、固定グローバル IP のサーバーなど、アプリ側から見ればすべて同じです。 ゼロから動かす最短ルートとして Tailscale を例に挙げています。
はい。Moshpit 1.1.0 から 1 ホップの踏み台ホスト(ssh -J 相当)に対応しました。
踏み台ホストを接続として保存し、接続先の「経由接続」で選択します(通信は SSH になります)。
詳しくは 踏み台ホスト をご覧ください。なおエージェント転送には対応しておらず、
UDP の必要な mosh を使いたい場合はメッシュ構成が有効です。
ほぼ確実に、送信 UDP は通すのに戻り UDP を落とすネットワーク環境(スプリットトンネル VPN、プロキシ、社内ファイアウォールなど)です。
同じ経路を TCP で通る SSH だけは動き続けます。上記の nc -u 確認をその Wi-Fi で実行し、
モバイル通信では返るのに Wi-Fi で返らないなら原因確定です。
一般的に iOS では同時に 1 つの VPN トンネルしか有効にできません。会社の VPN を常時オンにする必要がある場合、 メッシュは同時起動できないため、社内ネットワークから到達できる経路を使うことになります。これは iOS の制約です。
いいえ。ネットワーク探索機能もアカウントもありません。アプリが知るのはあなたが入力した接続先だけで、 ターミナル通信もそこだけへ向かいます。Moshpit が運用する唯一の要素は通知プッシュリレーですが、 解読不能な暗号化通知を中継するだけで、メッシュやセッションには一切触れません。 ローカルネットワーク権限もスキャン用ではなく、iOS が LAN 宛て UDP を落とさないようにするためだけのものです。
ほとんどの場合、アドレスの違いが原因です。mosh-server は SSH ログインが届いたアドレスにだけバインドするため、
メッシュ経由で作ったセッションには LAN アドレスから届かず、逆も同様です。接続設定にはメッシュ名を保存し、
自宅でもそれを使ってください。上の アドレスは 1 つに決める をご覧ください。
続けて読む: iPhone から Claude Code を動かす · ガイド一覧へ戻る