リモート Mac

macOS Tahoe 26 SSH切断後にタスクをどう継続するか?2026年ガイド

tmuxが断線後の対話的なタスクを守り、launchdまたはCI Agentが再起動後の無人タスクを担当します。macOS Tahoe 26でSSHを使う場合は、KeepAliveやnohupだけに頼らず、タスクの寿命に合わせて二層に分けて運用してください。

対象となる開発者

SSH経由でXcodeのビルド、テスト、依存関係の導入を実行する開発者に適した内容です。AI Agentや自動化スクリプトを長時間動かすエンジニア、常時稼働するMacの復旧を確認するDevOps担当者にも有効です。

なお、macOS Tahoe 26はAppleが正式に案内しているmacOSのバージョンであり、AppleはRemote LoginによるSSHアクセスを引き続き提供しています。OS自体がSSH切断を引き起こすと決めつけず、端末切断、通信断、ユーザーのログアウト、Macの再起動を別の事象として扱います。詳細はmacOS Tahoe 26の公式資料とRemote Loginの設定手順で確認できます。

実行前の中断条件

最初に、どの中断に耐える必要があるかを決めます。SSHウィンドウを閉じただけならtmuxで復帰できる可能性がありますが、Mac本体が再起動すればtmuxのセッションも失われます。

  • 端末を閉じた場合:前台プロセスは停止する可能性があります。tmux内のプロセスはセッションを残したまま再接続できます。
  • ネットワークが一時的に切れた場合:SSH接続は終了しても、tmux内の処理は継続できる構成があります。
  • ユーザーがログアウトした場合:対話的な処理と、システム側で管理されたサービスでは挙動が異なります。
  • Macが再起動した場合:tmuxに再接続するのではなく、launchdやCI Agentが起動条件を満たしたかを確認します。

SSHのKeepAliveは接続断の検出や再接続判断を補助しますが、コンパイルやスクリプトを管理する機能ではありません。接続の安定性と、プロセスの存続性を同じものとして扱わないことが重要です。

接続経路の初期確認

macOS側ではRemote Loginを有効にし、アクセス対象を指定アカウントに限定します。全ユーザーを許可したまま運用せず、実際に使うアカウント、ホスト識別情報、作業ディレクトリを記録します。

クライアントからの最初の接続では、次の情報を作業記録に残してください。

  • ホスト名または管理上の識別子
  • ログインアカウント
  • SSHホストキーの指紋
  • プロジェクトの絶対パス
  • 実行スクリプトとログの保存先
  • 成果物の出力先

サンプルではdev-user@example.invalidや~/projects/sample-appのような置き換え値だけを使います。パスワード、秘密鍵、トークン、証明書、実在する接続先は手順に記載しません。

接続後に、作業ディレクトリとログ先を確認します。

ssh dev-user@example.invalid
cd ~/projects/sample-app
pwd
mkdir -p ~/var/log/sample-app

SSH接続のセキュリティ確認を別途進める場合は、SSH接続の確認に使えるKuzCloudのヘルプも参照できます。

tmuxセッションの作成

対話的に状態を確認しながら実行するビルド、テスト、依存関係の導入、AI Agentは、名前付きtmuxセッションに入れます。tmuxは外部端末からデタッチしたセッションへ、後から再アタッチできる設計です。tmux公式の開始手順でも、この分離と再接続の基本操作が説明されています。

Homebrewで導入する場合は、まずインストール状態を確認します。Homebrewの公式formulaでは、tmuxの導入方法と現在のパッケージ情報を確認できます。

brew list tmux >/dev/null 2>&1 || brew install tmux
tmux -V

次に、セッションを作成してタスクを起動します。

tmux new -s build-job
cd ~/projects/sample-app
./scripts/build.sh 2>&1 | tee -a ~/var/log/sample-app/build.log

作業を継続させたまま端末だけ離れる場合は、Ctrl-bの後にdを入力します。SSHからログアウトした後、再接続して次のコマンドで既存セッションを確認します。

tmux ls
tmux attach -t build-job

セッション名を固定し、ログを永続ディレクトリへ出すことで、画面が消えたこととタスクが失敗したことを区別できます。tmuxのFAQにも、セッションの分離と再接続に関する注意点が整理されています。

注意:tmuxは端末切断から処理を切り離す仕組みであり、プロセスの成功、Macの再起動、ディスク容量不足、署名エラーまで解決するものではありません。

切断後の復旧判定

SSHを再接続した直後に、同じビルドをすぐ再実行してはいけません。まずtmuxセッション、対象プロセス、ログ、成果物の順に確認し、二重ビルドや同じファイルへの同時書き込みを避けます。

判定は次のように分けます。

  • セッションが残っている場合:tmux attach -t build-jobで画面を確認し、ログの末尾とプロセス状態を照合します。
  • セッションはあるがタスクが終了している場合:終了コード、最後のログ、成果物の更新時刻を確認し、成功なら再実行しません。失敗なら原因を保存してから再試行します。
  • セッションが見つからない場合:前台実行だった可能性、Macの再起動、ユーザー環境の違いを確認します。ログやプロセス一覧に証拠がなければ、重複実行を避けて入口スクリプトを点検します。
  • プロセスは動いているが出力が止まっている場合:CPUや入出力だけで成功と判断せず、ログの更新、子プロセス、ロックファイル、タイムアウト条件を調べます。

最低限、次の情報を復旧記録に保存します。

tmux ls
pgrep -af 'build.sh'
tail -n 80 ~/var/log/sample-app/build.log
stat -f '%Sm %N' ~/var/log/sample-app/build.log

終了コードだけでなく、成果物の存在、更新時刻、主要ログの終端を合わせて確認することで、「画面が戻った」だけの誤判定を防げます。

FAQ:中断の種類別の判断

SSH切断とタスクの存続

SSHを切断すると、通常の前台プロセスはセッション終了の影響を受ける可能性があります。一方、tmuxのセッション内で起動した処理は、端末を閉じても再接続の対象として残せます。ただし、処理が実際に進んでいるかはログとプロセスで検証する必要があります。

macOS Tahoe 26でのtmux利用

macOS Tahoe 26でビルドを継続したい場合は、tmuxセッションを先に作り、その中で作業ディレクトリへ移動してコマンドを起動します。デタッチ後に再接続できるため、Xcode関連のビルドやテストを端末の開閉から分離できます。再実行前の状態確認は省略できません。

再起動とtmux

Macの再起動後に、以前のtmuxセッションが自動的に復元されるとは考えないでください。再起動をまたぐ処理はlaunchdまたはCI Agentへ移し、起動条件、環境変数、作業ディレクトリ、ログパスを定義します。tmuxはあくまで実行中の端末から切り離すための道具です。

tmuxとlaunchdの選択

担当範囲を分けると判断しやすくなります。人が再接続して状態を見ながら進める処理はtmux、ログアウト後も無人で起動し、再起動後の復帰や定期実行が必要な処理はlaunchdまたはCI Agentを選びます。

再起動前の常駐化

長期間動かすスクリプト、スケジューラー、CI Agentは、tmuxからlaunchdへ移行します。AppleはmacOSのバックグラウンドタスク管理にlaunchdを用いる構成を説明しており、サービスの起動条件や管理単位を定義する際の基礎資料になります。AppleのDaemons and Services文書を確認してください。

ユーザーセッションに紐づく処理はLaunchAgent、システム側で管理する処理はLaunchDaemonが候補になります。ただし、権限、ログイン状態、ファイルアクセス範囲が異なるため、最初から特権実行にするのではなく、必要な権限だけで動く構成を優先します。

plistには少なくとも次の設計要素を明示します。

  • 実行ファイルまたはスクリプトの絶対パス
  • 作業ディレクトリ
  • 必要な環境変数
  • 標準出力と標準エラーの保存先
  • 起動条件
  • 終了後の扱い
  • 停止と再読み込みの方法

launchctlの操作やplistキーは、利用するOSの手引きとlaunchctlのマニュアル、launchd.plistのマニュアルで確認します。古いコマンド例をそのまま本番手順にせず、対象ユーザーのドメインと現在の推奨操作を検証してください。

投入前の復旧演習

本番投入前には、単にSSHを切断して画面が戻るかを見るだけでは不十分です。次の順番で、タスクの証拠と終了条件を記録します。

  • [ ] Remote Loginが対象アカウントだけに許可されている
  • [ ] ホスト指紋、作業ディレクトリ、ログ先が記録されている
  • [ ] 対話的タスクを名前付きtmuxセッションから起動している
  • [ ] SSHを意図的に切断し、再接続後にセッションとログを確認した
  • [ ] クライアント側の通信経路を切り替え、処理の継続を確認した
  • [ ] 受け入れ可能な時間帯にMacを再起動し、launchdまたはCI Agentの起動を確認した
  • [ ] 終了コード、成果物、ログ末尾、再起動後の開始記録を保存した
  • [ ] 失敗時に停止、修正、再実行できる手順がある

最後の判断は、タスクが人の操作を必要とするか、GUIセッションを必要とするか、長期間オンラインである必要があるか、再起動後に自動復帰すべきかで決まります。短期の調査や一度限りのビルドならtmuxを備えた一時ノードで足りますが、継続的なビルドやAgent運用では常駐サービスとして設計します。

既存のMacを常時オンラインにできず、実際のXcodeビルドやAgent処理で復旧を検証したい場合は、KuzCloudのリモートMac利用環境を候補にできます。導入前に、必要な稼働期間と再起動復旧条件を決めたうえで、利用プランと運用要件を照合してください。利用開始後は、管理画面への接続確認だけで終わらせず、対象タスクを実際に切断・再接続・再起動まで通して判定することが重要です。

SSH接続が切れても続けられるMac環境をKuzCloudで

Xcodeのビルドやテスト、AI Agentの実行に適したMacを、必要な期間だけご利用いただけます。

SSH接続が切断された後も、再接続して作業を再開しやすいリモートMac環境を構築できます。