FrontierStack iPhone/iPad コンパニオン マニュアル先頭
デスクトップ版マニュアル モバイル版マニュアル English frontierstack.app ↗

第 II

II

FrontierStack モバイルを使う

日々使う 5 つのタブ — フリート、そのサービス、シェル、AI 管理者、その他は More にまとめて。

5

第 5

アプリを使う:Fleet・Services・Shell・AI

ペアリングが済めば、アプリはデスクトップの完全なリモコンになります。本章では 5 つのタブが何を表示し、何ができるのかを順に解説します。

iPhone/iPad 版 FrontierStack は、Mac 上の FrontierStack アプリの完全なリモコンです。メイン画面は FleetServicesShellAIMore の 5 つのタブからなります。各タブは、Mac がすでに行っていることをのぞく窓であり、ペアリング時に確立した安全な署名付き接続を通じて手元の端末に届きます。本章ではこの 5 つすべてを扱います。設定とロック画面は次章で、ペアリング自体は「デバイスをペアリングする」で説明します。

すべてのタブを貫く考え方が 2 つあります。第一に、Mac が頭脳です。端末は Mac が見て行うことを表示・操作するだけなので、Mac がオフラインだとタブは静かになります。第二に、何ができるかは、この端末の権限レベル(Mac 側で設定)によって決まります。最も強力なもの(生のシェル、AI に変更を許可)は追加の付与が必要で、その都度説明します。

5.1Fleet — サーバとデバイス

Fleet タブがホームです。上部の端末接続とフリートは、端末から Mac への接続経路と、Mac が監視・デバイスの対象に使うフリート拠点を分けて表示します。その下にサーバとピン留めデバイスの 2 グループが並びます。

Servers セクションはピン留めした全サーバを一覧します — ローカルの Mac は最初の行にすぎず、他と同じように操作できます。各行には状態ドットが付きます。

ドット意味
Up — 到達可能で健全。
橙の三角Degraded — 到達可能だが要注意。
Down — 現在 Mac から到達できません。
中空Unknown — まだ未計測。

サーバをタップして開きます。詳細画面ではデスクトップと同じホストレベルの操作ができます。

  • サービス — 検出した各サービスの起動・停止・再起動・リロード。
  • 再起動診断の実行(今何が問題かを平易に)、ログ表示
  • Web UI を開く(組み込みブラウザ)、シェルを開く(このサーバに紐づくシェルへ)。
  • Remote Tools — ping・traceroute・待受ポート・Web チェック・ログ tail をサーバ上で実行。
  • Fleet Run — 全サーバへの一括操作(下記 More を参照)。
  • Full status details — Mac が把握しているホスト情報を 1 画面に集約:OS・稼働時間・CPU・メモリ・全アドレス・各サービスの状態・SSH 情報(ホスト鍵のフィンガープリントを含む)。詳細画面は操作を主に置いていますが、こちらは診断のための残り半分です。
  • Performance & history — 後述。
  • Emergency — 後述。

5.5.1Performance & history

デスクトップでは現在のパフォーマンスと Behaviour & History は別セクションですが、端末では「このマシンは正常か」という 1 つの問いに答えるため同じ画面にまとめています。現在の状態(CPU・メモリ・ディスク・ロード・稼働時間)に続き、6 時間から 1 週間の推移をグラフで表示し、判定を示します:正常の基準を学習中、正常に動作中、またはこのサーバにとって異常な点の具体的な指摘です。

再起動はグラフ上に赤い破線で表示され、オンホストのウォッチドッグが動作した時点と共に下に一覧されます。この文脈こそがスパイクを読み解く鍵です。CPU の急落は、その最中にマシンが再起動していたなら意味がまったく変わります。

メモこの履歴はサーバ上の監視ヘルパーが記録するため、Mac がスリープ中でもオフラインでも記録が続きます。ヘルパー未導入のサーバには表示する履歴がなく、空のグラフではなくその旨を表示します。

5.5.2Emergency — SSH 自体が失われたとき

データベースが接続プールを使い切ると、多くの場合そのマシンは SSH も受け付けなくなります。つまり「ログインして直す」という通常の手段が、まさに必要なその瞬間に失われます。Emergency 画面はそのためにあります。その操作はデータベースに直接、そのプロトコルで、そのポートに接続します。ログインができなくても機能します。

手順は影響の小さいものから順に並んでいます。Kill connections が最初にあるのは、これだけでサーバが復旧することが多いためです——再起動も電源断も不要です。その後、書き込みの停止、ディスクへのフラッシュ、最後にデータベースのクリーンシャットダウン(この後なら電源の強制断も安全)と進めます。データベースを停止する操作は必ず確認を求めます。

セキュリティEmergency の操作にはフル権限のデバイスと、ロック解除された Mac が必要です。シェルや AI 変更の許可とは異なり、デバイスに対して事前承認する手段は意図的にありません。データベースの停止は、その場での明確な判断なしに起きてよいことではないからです。データベースの資格情報は Mac に留まり、端末が送るのはホスト・エンジン・手順の指定だけです。
注意Start だけは SSH を必要とします。停止したデータベースは自身のクライアントプロトコルでは起動できないため、サーバが応答するようになって初めて実行できます——もっとも、詰まりを解消したシャットダウンの後であれば、それこそが狙いどおりです。

サーバの下に、ピン留めデバイスが種別ごとの折りたたみセクション(ルータ、スイッチ、プリンタ、NAS、スマートホームなど)で並びます。各行にはオンライン/オフラインのドットと、Web UI を開く・状態確認・電源再投入(Mac 側でプラグや KVM を紐づけている場合)のメニューが付きます。

スクリーンショット追加予定
図 5.1. Fleet タブ:ロケーションバナー、Mac を先頭にした Servers リスト(各行に状態ドット)、その下に折りたたみのデバイスセクション。撮影手順: capture: 接続済みの Fleet タブ。サーバ 2〜3 台がそれぞれ緑/橙のドット付きで並び、デバイスグループが 1 つ展開された状態
メモFleet はライブミラーであり、キャッシュではありません。赤いドットや「オフライン」表示は、端末(または Mac)が今そのホストに本当に到達できていないことを意味します。Mac が動作しているか、同じ Wi-Fi・同じ Tailnet にいるか、Cloudflare トンネルが上がっているかを確認してください。

5.2Services — ライブ状態(Mac のサイドバーとは独立)

サービスの状態と操作は Operations タブにあります。現在実際に動作しているものを表示し、この端末に許可された範囲で開始・停止・再起動・リロードを行えます。

本アプリは Mac のサイドバーとは独立 しています。デスクトップ側でウインドウを整理するために非表示にした項目も、ここからは到達できます。2 つの画面は用途が異なります。デスクに向かっているときは日常的に見るものを絞り込み、外出先では壊れたものに到達したいからです。端末での操作が Mac の表示を変えることはなく、Mac で非表示にした項目が端末から隠されることもありません。

メモ以前のバージョンでは端末から Mac のサイドバーを編集できました。これは廃止しました。端末の有用性がデスクトップの見た目の設定に左右されてしまい、Mac から離れていて障害が起きているときにはまさに不都合な結び付きだったためです。

5.3Shell — 本物のコマンドライン

Shell タブは Mac や任意の連携サーバ上のコマンドラインを開きます。上部のバーで対象 — This Mac または任意のサーバ — を選び、コマンドを入力して出力を読みます。サーバへは、Mac に保存済みの鍵と認証情報で自動ログインします。sudo コマンドはサーバの保存済み sudo パスワードを使います。これらの認証情報が端末に届くことはありません — Mac がコマンドを実行し、出力だけを返します。

More → Scripts には、Mac から同期された保存済みスクリプトと既製のメンテナンスプリセットがあります。タップして実行し、出力を確認できます。

直接 SSH — Mac がオフラインのとき。上記のシェルは Mac を経由します。サーバのページでは Enable direct SSH(Mac がオンラインのとき)をタップして、この端末自身の SSH 鍵をそのサーバに導入できます。以後は SSH (direct) で、端末からサーバへ直接、本物のターミナルを開けます — Mac がオフラインでも別ネットワークにいても — サーバのネットワークに到達できる限り(同じ Wi-Fi または Tailscale 経由)。端末の SSH 鍵は端末上で生成され、端末から出ることはなく、Mac 自身の鍵やパスワードが端末にコピーされることもありません。デバイスを失効またはペアリング解除すると、その鍵はサーバから削除されます。

セキュリティシェルはアプリで最も強力な機能なので、厳重に制限されます。この端末はフル権限で、Mac の Paired Devices ペインでその端末に 「Allow remote shell」がオンになっている必要があり、Mac はロック解除済みで、すべてのリクエストが署名されます。この明示的な付与がなければシェルはオフのままです —「フル権限」だけでは不十分です。
メモシェルは行指向で、作業ディレクトリはコマンド間で保持されます(cd は効きます)。通常のコマンドやスクリプトを実行しますが、topvim のような全画面ターミナルプログラムには対応しません。

5.4AI — 管理者と会話する

AI タブは、Mac 上で動くのと同じ AI 管理者とのマルチターン会話です。サーバ・サービス・デバイスについて平易な言葉で尋ねると、作業しながら実行したツールとその結果をその場に表示するので、どう答えに至ったかが分かります。

既定ではアシスタントは読み取り専用で、見るだけで変更はしません。右上の 「Allow changes」をオンにすると操作を許可します:サービスの再起動、DNS のフラッシュなど。会話履歴 — 秘密情報を含みうるツール結果も — は Mac に残り、端末には表示用の応答だけが届きます。ここでの AI の動作はすべて Mac 上で実行され、デスクトップと同じガードに従います。端末ごとの会話は Mac の AI 管理者を許可スイッチで完全にオフにでき、常にアプリのロック解除とこの端末の署名を必要とします。電話からの会話は Mac の AI 管理者履歴に保存されるので、そこで続きを再開できます。

メモ「承認が必要」と拒否された場合。FrontierStack は既定で、外部からの変更ごとに Mac のアプリ上での確認を求めます。端末を手にしている状態では当然それに答えられません。代わりに、この端末を一度だけ承認してください。Mac で Paired Devices ▸ 対象の端末 ▸「Allow AI changes without asking me here」です。これで免除されるのは確認ダイアログだけです。端末にはツールを許可する権限レベルが必要で、Mac のロック解除も必要、その会話で Allow changes がオンである必要もあり、外部変更にパスワードを要求する設定にしている場合はそれも引き続き適用されます。

各応答の左にある緑のシールドは、その答えが保護されたことを意味します:AI モデルへ何かが Mac を離れる前に、FrontierStack がツール結果から秘密情報(鍵・トークン・パスワード)を除去しました — シールドをタップすると意味が読めます。質問と応答はどちらも選択してコピーできます(長押し、または Copy 操作)。他所に貼り付けられます。またサーバを選択しているときは、アシスタントはそのマシンについて答えます — クエリ自体は Mac 上で動きますが、「どれくらい稼働している?」「何が待ち受けている?」は Mac ではなく選んだデバイスにスコープされます。

スクリーンショット追加予定
図 5.2. 会話中の AI タブ:質問、緑の保護シールドを添えたアシスタントの応答、その場の「ran read_logs」ツール行、右上に Allow changes トグル。撮影手順: capture: 緑のシールド・ツール操作・Allow changes トグルが見える 1 往復を表示した AI チャット

5.5More — アラート・ロケーションなど

More タブは、専用タブが要らないものをまとめます。

5.5.3キュー運用

キュー運用は Mac の読み取り専用キューダッシュボードを表示します。プルして RabbitMQ、Kafka、NATS/JetStream、Redpanda、AWS SQS、Azure Service Bus、Google Pub/Sub、Celery、Redis Streams、Pulsar、RocketMQ の健全性を更新できます。メッセージ本文をダウンロードせず、バックログ・コンシューマ・遅延・デッドレター合計を表示します。資格情報としきい値は Mac で設定し、端末が受け取るのは署名付きのサニタイズ済みヘルスサマリーだけです。

5.5.4Alerts

Alerts はサーバアラートの受信箱です — サービス停止、ディスク逼迫、証明書の期限切れなど — Mac とそのエージェントが発します。Enable push notifications をタップすれば、アプリを閉じていても届きます。プッシュの送信には Mac(またはそのリレー)がオンラインである必要があります。

セキュリティ端末がプッシュサーバに直接登録することはありません。通知を有効にすると、端末はプッシュトークンを署名付き接続でペア済み Mac に渡し、Mac が有効なライセンスの鍵で登録内容に署名して代わりに登録します。そのため Mac 側で端末を失効する — またはここでペアリング解除する — と、端末がオフラインでもそのプッシュ通知が停止します。

5.5.5Checks — ウォッチドッグと保守用の一時停止

Checks は Mac の Service Guardian の管理画面です。監視対象のサービス、それぞれの健全性、Keep AliveAuto Recover が有効かどうかを確認できます。デスクトップ版マニュアル 第 11 章 のペインを端末側から見たものです。

ディスク修復は自動的に保護されます。Disk UtilityのFirst Aidやファイルシステム修復ツールの実行中は、設定を変えずに自動復旧を一時停止します。保守中のタイムアウト回数を消去し、修復終了後も60秒待ってから新しい状態で再開します。この安全停止はChecks画面に表示されます。

便利なのが一時停止です。作業を始める前に、すべてのチェック、または特定のサービスだけを 15 分から 1 日まで一時停止できます。停止中は Mac がヘルスチェックも再起動も行わないため、保守作業がウォッチドッグと衝突したり、アラートを発生させたりしません。

ヒント一時停止はウォッチドッグをオフにすることとは異なります。何も無効化されず、設定も失われません。時間が過ぎれば、設定どおりに自動で再開します。早めに再開することもできます。これが要点で、保護を戻し忘れることがありません。

5.5.6端末接続とフリート拠点

端末接続とフリート拠点は、以前の「ロケーション」という表示で混同しやすかった 3 つを分けます。この iPhone から Mac への接続方法、Mac 自身のネットワークから一致した拠点、そして監視・デバイスの対象に使うフリート拠点です。端末の現在地やネットワークがフリート拠点を選ぶことはありません。

Mac が検出した拠点に追従を選ぶと、フリートの対象は Mac に追従します。別のフリート拠点に固定しても、端末から Mac への接続経路は変わらず、別拠点のプライベートネットワークが自動的に到達可能になることもありません。その拠点のデバイスを開くには、Tailscale や VPN など既存の経路が必要です。

5.5.7Fleet Run・共有・Web UI

Fleet Run は全サーバへの一括操作 — パッケージ更新、サービス再起動、ディスクや稼働時間の確認 — を実行し、ホストごとの結果を表示します。Shared は Mac が開いた一時的な Debug Share(トンネル経由で公開した localhost 開発サイトなど)を一覧し、開いたり停止したりできます。新規に開くにはフル権限と Mac 側の「Allow changes」が必要です。Web UIs & Bookmarks は、ルータ・NAS・カメラの管理ページを自己署名 LAN 証明書を信頼する組み込みブラウザで開き、端末側でブックマークしたアドレスも扱えます。

メモ「到達可能」とは、端末がそのデバイスのネットワークにいることを意味します。同じ Wi-Fi 上なら成り立ち、外出先でも Tailscale 経由(例:サブネットルータ)で成り立つことがあります。デバイスのページが開けない場合、ほぼ常に到達性の問題で、アプリの問題ではありません。ブラウザは証明書をすでに信頼しています。

5.5.8端末の中のマニュアル

More ▸ Manual は、本書をアプリ内に収録したものです。ネットワークもペアリング済みの Mac も不要です。トラブルシューティングの章は、まさに何かに到達できないときに最も役立つため、これは重要です。章ごとに読むことも、本全体を検索することもできます。検索は端末上で実行されます。

ヒントマニュアルはペアリング画面からも開けます。Mac をまだ接続していなくても読めるので、ペアリング自体がうまくいかないときに役立ちます。

最後に、More には設定ヘルプがあります — 次章で扱います。

FrontierStack ユーザマニュアル · バージョン 1.0.0 · 第 5