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

macOS インストールガイド

AegisMesh の macOS 版クライアントは、Apple Silicon（M1 / M2 / M3 / M4）および Intel Mac の両方にネイティブ対応しています。

システム要件

  • 対応OS: macOS Monterey (12.0) 以降 (Ventura, Sonoma, Sequoia 検証済み)
  • アーキテクチャ: Universal / Apple Silicon (arm64) / Intel (x86_64)
  • 権限: ネットワーク拡張機能の有効化に管理者（sudo）権限が必要

1. アプリケーションのインストール

  1. 公式ダウンロードページ から、お使いのMacに合わせたパッケージをダウンロードします。
    • Apple Silicon (M1〜M4): aegismesh_darwin_arm64
    • Intel Mac: aegismesh_darwin_amd64
  2. ダウンロードしたバイナリを実行権限付きで配置するか、GUIインストーラーを実行します。

2. CLI による導入とバックグラウンド常駐

Terminal から直接セットアップを行い、システム起動時に自動常駐（LaunchDaemon）させる手順です。

Terminal window
# 1. バイナリをシステムパスへ配置
sudo cp aegismesh_darwin_arm64 /usr/local/bin/netbird
sudo chmod +x /usr/local/bin/netbird


# 2. システムサービス (LaunchDaemon) として登録・起動
sudo netbird service install
sudo netbird service start


# 3. 管理サーバーへ接続
sudo netbird up --management-url https://app.aegismesh.kusa-cloud.com --setup-key <YOUR-SETUP-KEY>

3. macOS セキュリティ許可について

初回起動時、macOS の「システム設定」から以下の許可が求められます。

  1. 「“AegisMesh” がネットワーク機能を追加することを求めています」:
    • 「許可」 をクリックします。（WireGuard トンネルデバイスの作成に必要です）
  2. 「バックグラウンド項目の追加」:
    • macOS 13 (Ventura) 以降の場合、「バックグラウンドでの実行を許可」トグルが ON になっていることを確認してください。

4. 接続状態の確認と停止

Terminal window
# 接続状態と割り当てIPの確認
netbird status


# 接続の切断
sudo netbird down