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

Linux インストールガイド

AegisMesh は、主要な Linux ディストリビューション向けにネイティブな .deb パッケージおよび .rpm パッケージを公式提供しています。

1. Debian / Ubuntu (x86_64 & ARM64)

Ubuntu 20.04 / 22.04 / 24.04 および Debian 11 / 12 に対応しています。

パッケージのダウンロードとインストール

Terminal window
# 1. 最新 .deb パッケージのダウンロード (x86_64 の例)
curl -L -o aegismesh_amd64.deb "https://aegismesh.kusa-cloud.com/api/download/linux-deb"


# ARM64 (Raspberry Pi 4/5 等) の場合
# curl -L -o aegismesh_arm64.deb "https://aegismesh.kusa-cloud.com/api/download/linux-deb-arm64"


# 2. dpkg によるインストール
sudo dpkg -i aegismesh_amd64.deb


# 依存パッケージのエラーが出た場合の修復
sudo apt-get install -f -y

2. RHEL / Rocky Linux / Fedora (x86_64 & AArch64)

RHEL 8 / 9、Rocky Linux 8 / 9、AlmaLinux、および Fedora に対応しています。

パッケージのダウンロードとインストール

Terminal window
# 1. 最新 .rpm パッケージのダウンロード (x86_64 の例)
curl -L -o aegismesh_x86_64.rpm "https://aegismesh.kusa-cloud.com/api/download/linux-rpm"


# ARM64 (aarch64) の場合
# curl -L -o aegismesh_aarch64.rpm "https://aegismesh.kusa-cloud.com/api/download/linux-rpm-arm64"


# 2. rpm / dnf によるインストール
sudo dnf install -y ./aegismesh_x86_64.rpm
# または
# sudo rpm -ivh aegismesh_x86_64.rpm

3. スタンドアロン CLI バイナリによる導入

パッケージマネージャーを使用しない最小環境や組み込みLinux向けの手順です。

Terminal window
# 1. バイナリをダウンロードして配置
sudo curl -L -o /usr/local/bin/aegismesh "https://aegismesh.kusa-cloud.com/downloads/latest/aegismesh_linux_amd64"
sudo chmod +x /usr/local/bin/aegismesh


# 2. systemd サービスへの自動登録
sudo aegismesh service install
sudo aegismesh service start

4. ネットワークへの接続と運用コマンド

Terminal window
# セットアップキーを用いて接続
sudo aegismesh up --management-url https://app.aegismesh.kusa-cloud.com --setup-key <YOUR-SETUP-KEY>


# 接続状況・インターフェース (wt0) の確認
aegismesh status


# 詳細な診断情報の出力
aegismesh status --detail


# サービス自動起動状態の確認 (systemd)
systemctl status aegismesh

5. UTM ルート CA 証明書の自動登録（SSL インスペクション環境）

AegisMesh クライアントデーモン（aegismesh サービス）が稼働している Linux 端末では、管理画面から配布された UTM ルート証明書（POST /api/certificates）を自動検知し、OS のトラストアンカーストアへサイレント登録します：

  • Ubuntu / Debian: /usr/local/share/ca-certificates/aegismesh/ に配置後、update-ca-certificates を自動実行。
  • RHEL / Rocky / CentOS: /etc/pki/ca-trust/source/anchors/ に配置後、update-ca-trust extract を自動実行。
  • Mozilla Firefox: システムポリシー（/etc/firefox/policies/policies.json）を自動構成し、ブラウザでも即時信頼。