nmcli エヌエムシーエルアイ

英語表記nmcli

日本語表記NetworkManager操作

別名NetworkManager CLI

正式名称NetworkManager command line tool

危険度注意

What does it mean?

NetworkManagerの接続プロファイルとデバイス状態をコマンドラインから管理します。

Command Quest

nmcli を今日の道具にする

NetworkManagerの接続プロファイルとデバイス状態...

$ nmcli [オプション] オブジェクト コマンド
関連用語16
次のコマンド0
FAQ2
参照1

概要

NetworkManagerの接続プロファイルとデバイス状態をコマンドラインから管理します。

基本構文

nmcli [オプション] オブジェクト コマンド

詳細解説

nmcliは、NetworkManagerをコマンドラインから操作するためのコマンドです。接続プロファイルの表示、作成、編集、有効化、無効化、Wi-Fi一覧、デバイス状態の確認まで一通り扱えます。

デスクトップだけでなく、サーバーやヘッドレス環境でも使われ、対話的にも自動化にも向きます。

ただし、NetworkManagerが管理している環境でこそ意味がある道具であり、systemd-networkdなど別方式の環境では前提が異なります。

このコマンドを使う場面

NetworkManager環境で接続状態確認、接続作成、Wi-Fi確認、接続有効化を行う時に使います。

まず安全に試す方法

1. nmcli device status
2. nmcli connection show
3. nmcli general status

3分ミッション

少しでも手を動かすと定着しやすくなります。終わった項目にチェックを入れてください。

  1. device statusとconnection showの違いを理解します。

  2. 管理方式の違いが結果に与える影響を整理します。

オプション

  • device status
    デバイス状態を表示します。
    nmcli device status
  • connection show
    接続プロファイル一覧を表示します。
    nmcli connection show
  • connection up 接続名
    指定接続を有効化します。
    nmcli connection up demo
  • connection add 設定
    新しい接続プロファイルを作成します。
    nmcli connection add type ethernet ifname eth0 con-name demo

実行結果サンプル

  • nmcli device status
    DEVICE  TYPE      STATE      CONNECTION
    eth0    ethernet  connected  Wired connection 1

戻り値コード

  • 0 正常終了。状態表示または設定変更に成功しました。
  • >0 NetworkManager未使用、権限不足、指定不正などで処理できませんでした。

使用例

  • nmcli device status
  • nmcli connection show
  • nmcli device wifi list
  • nmcli connection up "Wired connection 1"

よくあるエラー

  • nmcliで変更したのに反映されない
    原因: 対象環境がNetworkManager管理ではありません。
    対処: 管理方式を確認し、別の設定手段を検討します。
  • 遠隔作業中に接続を切ってしまう
    原因: 有効化や再設定で管理経路へ影響しました。
    対処: 状態確認から始め、戻し手順を準備します。

導入・互換性情報

NetworkManager前提です。別のネットワーク管理方式では同じ結果になりません。

注意点 / セキュリティリスク

危険度は中程度です。接続有効化や変更は通信断を招くことがあります。

FAQ

  • Q. ipコマンドだけでは駄目ですか。
    A. 一時的な状態確認や変更はできますが、永続的な接続管理ではnmcliが便利です。
  • Q. Wi-Fiも扱えますか。
    A. はい。device wifi listやconnection操作で扱えます。

関連用語

  • NIC
  • MAC address
  • DHCP
  • MTU
  • VLAN
  • bridge
  • bond
  • VPN
  • WireGuard
  • OpenVPN
  • DHCP server
  • PXE
  • netboot
  • Wi-Fi
  • antenna
  • RF

参照リンク

関連記事