クイックスタートガイド

本ガイドでは、AegisMeshの管理コンソールへアクセスし、クライアントPCを接続してセキュアなメッシュネットワークを開通させるまでの最短手順を説明します。

全体の流れ

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: セットアップキー (Setup Key) を発行
    User->>Client: アプリをダウンロード & インストール
    User->>Client: セットアップキーを入力 (または SSO ログイン)
    Client->>Console: 端末登録 & 暗号鍵交換
    Console-->>Client: ピア一覧 & ルーティング情報配信
    Client-->>Peer: WireGuard P2P 暗号化トンネル確立 (完了!)

Step 1: 管理コンソールへのアクセス＆セットアップキーの発行

ブラウザで管理コンソール（https://app.aegismesh.kusa-cloud.com）にアクセスし、管理者アカウントでログインします。
左メニューの 「Setup Keys（セットアップキー）」 を開きます。
「Add Key（キーの作成）」 ボタンをクリックします。
- Name: 識別名（例: PC初期設定用キー）
- Type: Reusable（複数台で使用）または One-Off（1回限り）
- Expires In: 有効期限（例: 7日）
- Auto-assigned Groups: 所属させるグループ（デフォルト: All）
表示されたセットアップキー文字列（例: A1B2C3D4-E5F6-...）をコピーして安全に控えます。

Step 2: クライアントアプリのダウンロード＆インストール

お使いの端末に合わせて、ダウンロードページからインストーラーを取得します。

Windows: .exe インストーラー (x64 / ARM64) を実行し、ウィザードに従ってインストールします。
macOS: Apple Silicon または Intel 版をダウンロードし、Applicationsフォルダへ配置します。
Linux: .deb（Ubuntu/Debian）または .rpm（RHEL/Rocky/Fedora）をパッケージマネージャーでインストールします。

# Ubuntu / Debian の例
sudo dpkg -i aegismesh_amd64.deb

# RHEL / Rocky Linux の例
sudo rpm -ivh aegismesh_x86_64.rpm

Step 3: ネットワークへの接続

GUI アプリの場合

インストールした AegisMesh アプリを起動します。
「Connect」 をクリックし、Step 1 で取得した セットアップキー を入力します。
数秒で接続が完了し、タスクトレイのアイコンが緑色（Connected）に変わります。

CLI（コマンドライン）の場合

サーバー環境やヘッドレスマシンの場合は、CLIコマンドで直接接続できます。

# 管理サーバーを指定してセットアップキーで接続
sudo netbird up --management-url https://app.aegismesh.kusa-cloud.com --setup-key <YOUR-SETUP-KEY>

Step 4: 接続状態と通信の確認

接続が完了すると、端末に AegisMesh 専用の仮想IPアドレス（例: 100.64.0.5）が自動割り当てされます。

# 接続ステータスと自身のIPを確認
netbird status

# 他のピア（接続端末）への疎通確認
ping 100.64.0.1

管理コンソールの 「Peers」 画面にも、接続された端末がオンライン（Connected）として即座に表示されます。これで、最初のセキュアメッシュネットワークが開通しました！