コンテンツにスキップ
AegisMesh ドキュメント

クイックスタートガイド

本ガイドでは、AegisMesh の管理コンソールへログインし、クライアント端末を接続してセキュアなメッシュネットワークを開通させるまでの最短手順を、実際のダッシュボード画面と合わせてステップ・バイ・ステップで解説します。

全体の流れ

sequenceDiagram
    autonumber
    actor Admin as 管理者
    actor User as 接続端末 (PC)
    participant Console as AegisMesh 管理画面
    participant Client as AegisMesh アプリ
    participant Peer as 接続先サーバー/PC

    Admin->>Console: 管理コンソールにログイン
    Admin->>Console: セットアップキーまたは端末追加画面を開く
    User->>Client: アプリをダウンロード & インストール
    User->>Client: セットアップキーを入力 (または SSO ログイン)
    Client->>Console: 端末登録 & 暗号鍵交換
    Console-->>Client: ピア一覧 & ルーティング情報配信
    Client-->>Peer: WireGuard P2P 暗号化トンネル確立 (完了!)

【事前準備・前提条件】

作業を開始する前に、以下の準備が整っていることを確認してください。

  • 管理者権限のアカウント: AegisMesh 管理コンソールへのログインID（メールアドレス / IdP SSO）。
  • 接続先クライアント端末: Windows、macOS、Linux、Android、iOS のいずれか。
  • ネットワーク環境: 一般的なインターネット接続（ポート開放は一切不要です）。

【手順 1】管理コンソールへのログインと画面の確認

  1. Webブラウザで AegisMesh 管理コンソール（https://app.aegismesh.kusa-cloud.com）にアクセスします。
  2. アカウント情報（または Google / Microsoft などのシングルサインオン）でログインします。
  3. ログインに成功すると、以下のようなメインダッシュボード（Peers一覧画面）が表示されます。

管理コンソール初期画面と主要操作メニュー

画面の主要操作ポイント

番号画面項目説明
①Setup Keys（左メニュー）端末の自動一括登録や無人サーバー用キーを発行する場合に選択します。
②+ Add Peer ボタン今すぐこの画面から新しい端末（PC / スマホ / サーバー）を追加する場合にクリックします。

【手順 2】新規端末の追加画面を開く

  1. 画面右上の [+ Add Peer] ボタン（上記 ②）をクリックします。
  2. 「Add new peer」モーダルダイアログが表示されます。

新規端末追加モーダルの操作箇所

操作手順と入力ポイント

番号操作項目設定内容・説明
①OS 選択タブご利用の端末に合わせて、[Linux] / [Windows] / [macOS] / [iOS] / [Android] / [Docker] から該当するOSを選択します。
②インストーラーのダウンロードボタンをクリックして、端末専用の最新インストーラーを取得します。
③Management URL（接続先）AegisMesh の専用管理サーバーアドレスです。右端のコピーアイコンをクリックして控えます。
https://app.aegismesh.kusa-cloud.com

【手順 3】クライアントアプリのインストールと接続

A. Windows / macOS の場合 (GUI アプリ)

  1. ダウンロードしたインストーラーを実行し、画面の指示に従ってインストールを完了します。
  2. アプリを起動し、タスクトレイ（またはメニューバー）の AegisMesh アイコンをクリックします。
  3. [Settings] を開き、Management URL に https://app.aegismesh.kusa-cloud.com が設定されていることを確認します。
  4. [Connect] ボタンをクリックし、IdP（ブラウザログイン）または セットアップキー を入力します。

B. Linux の場合 (CLI ワンライン導入)

ターミナルを開き、以下のコマンドを実行するだけで自動インストールと初期接続が完了します。

Terminal window
# ワンラインインストーラーの実行
curl -fsSL https://aegismesh.kusa-cloud.com/install.sh | sudo sh


# 管理サーバーを指定して接続
sudo aegismesh up --management-url https://app.aegismesh.kusa-cloud.com

ブラウザ認証用URLが表示されるので、アクセスしてログインを承認するか、事前に発行したセットアップキー（--setup-key <KEY>）を指定して即時接続します。

【手順 4】接続完了と通信ステータスの確認

接続が正常に確立されると、管理コンソールの 「Peers」 画面に接続した端末がリアルタイムで反映されます。

接続完了時のピア一覧画面

正常接続の確認ポイント

番号確認項目正常な状態
①ステータス表示端末名の左隣に 緑色の丸アイコン（● Connected） が点灯し、最終通信が「Few seconds ago」または「Active」になっていること。
②AegisMesh 仮想IP端末ごとに一意の仮想IPアドレス（例: 100.119.46.179 や 100.64.x.x）が自動割り当てされていること。

端末側での疎通テスト (CLI)

端末のターミナルまたはコマンドプロンプトで以下のコマンドを実行し、接続状態を確認します。

Terminal window
# 接続ステータスと自身の仮想IPを確認
aegismesh status


# メッシュ内の他端末またはゲートウェイへの疎通確認
ping 100.64.0.1

次のステップ