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

AegisMesh CLI リファレンス

netbird コマンドラインツール（CLI）は、AegisMesh クライアントデーモンの制御、接続管理、およびトラブルシューティングを行うための標準インターフェースです。

主要サブコマンド一覧

コマンド説明主な用途
netbird upネットワークへ接続トンネル起動・セットアップキー入力
netbird downネットワークから切断一時的な通信切断
netbird status接続状態とピア一覧の表示仮想IP、接続中ピア、ルーティング確認
netbird serviceシステムサービスの管理install, start, stop, uninstall
netbird sshメッシュ内ピアへのSSH接続パスワードレス・暗号化SSHセッション
netbird versionクライアントバージョンの表示バージョン確認 (v0.79.0 等)

netbird up の主要オプション

Terminal window
sudo netbird up [flags]
  • --management-url <url>: 接続先管理サーバーURL（例: https://app.aegismesh.kusa-cloud.com）。
  • --setup-key <key>: 認証用セットアップキー。
  • --exit-node <node-name-or-ip>: 全トラフィックを集約するExit Nodeを指定。
  • --allow-server-ssh: この端末に対するAegisMesh経由のセキュアSSHログインを許可。
  • --dns-labels: ピアの検索ドメインラベルを有効化。

netbird status の出力例

Peers detail:
 Peer:
  NetBird IP: 100.64.0.15
  Public key: p9x2...=
  Status: Connected
  Last status update: 2026-09-29 11:20:05
  FQDN: tokyo-dev-01.aegismesh.internal


Peers (3/3 connected):
 Peer: tokyo-office-gw (100.64.0.1)
  Status: Connected
  Connection type: P2P (Direct WireGuard)
  Direct ICE: 203.0.113.10:51820
  Latency: 4.2ms


 Peer: osaka-db-server (100.64.0.2)
  Status: Connected
  Connection type: Relayed (Relay: relay.aegismesh.kusa-cloud.com)
  Latency: 18.5ms