리눅스 nmcli

NetworkManager를 명령행에서 제어하여 네트워크 장치와 연결(connection) 설정을 조회·변경한다.

RHEL/Rocky Linux 7 이후 네트워크 설정의 표준 도구이며, ifconfig·route 대신 사용한다.
경로 : /usr/bin/nmcli
패키지 : NetworkManager
연결 설정 파일(Rocky Linux 8) : /etc/sysconfig/network-scripts/ifcfg-연결이름
텍스트 메뉴 방식 도구로 nmtui가 있다.

사용법

문법

$ nmcli [옵션] 객체 {명령 | help}

객체 : general, networking, radio, connection, device 등
객체와 명령은 앞글자만 줄여 쓸 수 있다. (예: nmcli connection show → nmcli con show → nmcli c s)

옵션

-t, --terse : 스크립트 처리에 알맞은 간결한 형식으로 출력한다.
-p, --pretty : 사람이 읽기 쉬운 형식으로 출력한다.
-f, --fields 필드 : 출력할 필드를 지정한다. (예: -f NAME,DEVICE)
-g, --get-values 필드 : 지정한 필드의 값만 출력한다.
-a, --ask : 필요한 값(비밀번호 등)을 대화형으로 묻는다.

하위 명령

general

nmcli general status : NetworkManager의 전체 상태를 출력한다.
nmcli general hostname [이름] : 호스트 이름을 조회하거나 설정한다.

device

nmcli device status : 장치(인터페이스) 목록과 상태를 출력한다.
nmcli device show [장치] : 장치의 IP 주소, 게이트웨이, DNS 등 상세 정보를 출력한다.
nmcli device connect 장치 / nmcli device disconnect 장치 : 장치를 연결하거나 끊는다.
nmcli device reapply 장치 : 연결을 끊지 않고 변경된 설정을 장치에 다시 적용한다.

connection

nmcli connection show [--active] [연결이름] : 연결 프로필 목록(--active는 활성 연결만)이나 특정 연결의 전체 속성을 출력한다.
nmcli connection add type 유형 con-name 연결이름 ifname 장치 [속성 값 ...] : 새 연결 프로필을 만든다. 유형은 ethernet, wifi, bond, bridge, vlan 등이다.
nmcli connection modify 연결이름 속성 값 [속성 값 ...] : 연결 프로필의 속성을 변경한다. 속성 앞에 +를 붙이면 값을 추가하고, -를 붙이면 값을 제거한다.
nmcli connection up 연결이름 : 연결을 활성화한다. modify로 바꾼 설정은 up을 다시 실행해야 적용된다.
nmcli connection down 연결이름 : 연결을 비활성화한다.
nmcli connection delete 연결이름 : 연결 프로필을 삭제한다.
nmcli connection reload : 설정 파일을 직접 수정한 경우 디스크의 프로필을 다시 읽어 들인다.

networking

nmcli networking on / off : 전체 네트워킹을 켜거나 끈다.

주요 연결 속성

ipv4.method : IPv4 주소 할당 방식. auto(DHCP), manual(고정 IP), disabled, link-local, shared가 있다.
ipv4.addresses : IP 주소와 프리픽스 길이. (예: 192.168.10.10/24)
ipv4.gateway : 기본 게이트웨이 주소
ipv4.dns : DNS 서버 주소. 여러 개는 쉼표나 공백으로 구분한다.
ipv4.dns-search : DNS 검색 도메인
connection.autoconnect : 부팅 시 자동 연결 여부(yes/no)
ifcfg 파일과의 대응 : ipv4.method manual → BOOTPROTO=none, ipv4.addresses → IPADDR·PREFIX, ipv4.gateway → GATEWAY, ipv4.dns → DNS1·DNS2, connection.autoconnect → ONBOOT

예제

# 전체 연결 프로필과 장치 상태를 확인한다.
$ nmcli connection show
$ nmcli device status

# 기존 연결 ens160을 고정 IP로 변경하고 적용한다.
# nmcli connection modify ens160 ipv4.method manual ipv4.addresses 192.168.10.10/24 ipv4.gateway 192.168.10.1 ipv4.dns 8.8.8.8
# nmcli connection up ens160

# 기존 DNS 설정을 유지한 채 DNS 서버를 하나 더 추가한다.
# nmcli connection modify ens160 +ipv4.dns 1.1.1.1

# 새 이더넷 연결 프로필을 만든다.
# nmcli connection add type ethernet con-name office ifname ens224 ipv4.method manual ipv4.addresses 10.0.0.5/24 ipv4.gateway 10.0.0.1

# 연결을 DHCP 방식으로 되돌린다.
# nmcli connection modify ens160 ipv4.method auto ipv4.addresses "" ipv4.gateway ""

# 특정 연결의 IPv4 관련 속성만 출력한다.
$ nmcli -f ipv4 connection show ens160

시험 포인트

고정 IP 설정은 connection modify로 ipv4.method manual, ipv4.addresses, ipv4.gateway, ipv4.dns를 지정한 뒤 connection up으로 적용하는 흐름이 출제된다.
modify만 하고 up(또는 device reapply)을 하지 않으면 변경 사항이 즉시 반영되지 않는다.
속성 이름 앞의 +, - 기호로 값을 추가·제거할 수 있다.

같이 보기

리눅스 네트워크 설정
ip 명령어 : 네트워크 인터페이스, 주소, 라우팅 정보를 조회·설정한다.
ifconfig 명령어
route 명령어
hostnamectl 명령어 : 호스트 이름을 조회·설정한다.
리눅스 resolv.conf
ss 명령어 : 소켓 상태를 출력한다.

참고 문헌