Linux インストールガイド

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

1. Debian / Ubuntu (x86_64 & ARM64)

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

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

# 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 に対応しています。

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

# 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向けの手順です。

# 1. バイナリをダウンロードして配置
sudo curl -L -o /usr/local/bin/netbird "https://aegismesh.kusa-cloud.com/api/download/linux-amd64"
sudo chmod +x /usr/local/bin/netbird

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

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

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

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

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

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