Konfigurasi jaringan IP menggunakan nmcli

Richard Gregory, Peter Boy (pboy) Versi F36 onwards Last review: 2023-08-28
Cara mengonfigurasi jaringan menggunakan utilitas baris perintah nmcli (NetworkManager Command Line Interface).

Memulai dengan nmcli

Perintah baris perintah nmcli (NetworkManager Command Line Interface) digunakan untuk mengontrol NetworkManager dan melaporkan status jaringan. Perintah ini dapat digunakan sebagai pengganti nm-applet atau klien grafis lainnya. nmcli digunakan untuk membuat, menampilkan, mengedit, menghapus, mengaktifkan, dan menonaktifkan koneksi jaringan, serta mengontrol dan menampilkan status perangkat jaringan.

Utilitas nmcli dapat digunakan oleh baik pengguna maupun skrip untuk mengontrol NetworkManager:

  • Untuk server, mesin tanpa antarmuka grafis, dan terminal, nmcli dapat digunakan untuk mengontrol NetworkManager secara langsung tanpa antarmuka grafis, termasuk membuat, mengedit, memulai, dan menghentikan koneksi jaringan, serta melihat status jaringan.

  • Untuk skrip, nmcli mendukung format output ringkas yang lebih cocok untuk pemrosesan skrip. Ini adalah cara untuk mengintegrasikan konfigurasi jaringan daripada mengelola koneksi jaringan secara manual.

Format dasar perintah nmcli adalah sebagai berikut:

$ nmcli [OPTIONS] OBJECT { COMMAND | help }

di mana OBJECT dapat berupa salah satu opsi berikut: general, networking, radio, connection, device, agent, dan monitor. Anda dapat menggunakan prefiks apa pun dari opsi-opsi ini dalam perintah Anda. Misalnya, nmcli con help, nmcli c help, nmcli connection help menghasilkan output yang sama.

Beberapa opsi berguna yang dapat digunakan untuk memulai adalah:

-t, terse

Mode ini dapat digunakan untuk pemrosesan skrip komputer, seperti yang dapat Anda lihat, outputnya ringkas dan hanya menampilkan nilai-nilai.

Contoh 1. Menampilkan output yang ringkas
$ nmcli -t device
ens3:ethernet:connected:Profile 1
lo:loopback:unmanaged:
-f, field

Opsi ini menentukan bidang-bidang mana yang dapat ditampilkan dalam output. Misalnya, NAME, UUID, TYPE, AUTOCONNECT, ACTIVE, DEVICE, STATE. Anda dapat menggunakan satu atau lebih bidang. Jika ingin menggunakan lebih dari satu bidang, jangan gunakan spasi setelah koma untuk memisahkan bidang-bidang tersebut.

Contoh 2. Menentukan Bidang dalam Output
$ nmcli -f DEVICE,TYPE device
DEVICE  TYPE
ens3    ethernet
lo      loopback

atau bahkan lebih baik untuk pemrograman:

$ nmcli -t -f DEVICE,TYPE device
ens3:ethernet
lo:loopback
-p, pretty

Opsi ini menyebabkan nmcli menghasilkan output yang mudah dibaca oleh manusia. Misalnya, nilai-nilai dirapikan dan header dicetak.

Contoh 3. Menampilkan output dalam mode tampilan yang rapi
$ nmcli -p device
=====================
  Status of devices
=====================
DEVICE  TYPE      STATE      CONNECTION
--------------------------------------------------------------
ens3    ethernet  connected  Profile 1
lo      loopback  unmanaged  --
-h, help

Mencetak informasi bantuan.

Alat nmcli memiliki bantuan kontekstual bawaan. Untuk menampilkan opsi dan nama object yang tersedia:

$ nmcli help

Untuk menampilkan aksi yang tersedia terkait object tertentu:

$ nmcli _object_ help

Sebagai contoh,

$ nmcli c help

Sumber daya tambahan

Pilihan Singkat Contoh nmcli

Bagian ini menyajikan contoh-contoh singkat dari perintah nmcli.

Prasyarat

[Getting-started-with-nmcli]

Memeriksa status keseluruhan NetworkManager ====
$ nmcli general status
STATE      CONNECTIVITY  WIFI-HW  WIFI     WWAN-HW  WWAN
connected  full          enabled  enabled  enabled  enabled

Dalam mode ringkas:

$ nmcli -t -f STATE general connected
$ nmcli general logging
  LEVEL  DOMAINS
  INFO   PLATFORM,RFKILL,ETHER,WIFI,BT,MB,DHCP4,DHCP6,PPP,WIFI_SCAN,IP4,IP6,A
UTOIP4,DNS,VPN,SHARING,SUPPLICANT,AGENTS,SETTINGS,SUSPEND,CORE,DEVICE,OLPC,
WIMAX,INFINIBAND,FIREWALL,ADSL,BOND,VLAN,BRIDGE,DBUS_PROPS,TEAM,CONCHECK,DC
B,DISPATCH
$ nmcli connection show
  NAME       UUID                                  TYPE      DEVICE
Profile 1  db1060e9-c164-476f-b2b5-caec62dc1b05  ethernet    ens3
ens3       aaf6eb56-73e5-4746-9037-eed42caa8a65  ethernet    --
$ nmcli connection show --active
  NAME       UUID                                  TYPE      DEVICE
Profile 1  db1060e9-c164-476f-b2b5-caec62dc1b05  ethernet     ens3
$ nmcli device status
DEVICE  TYPE      STATE      CONNECTION
ens3    ethernet  connected  Profile 1
lo      loopback  unmanaged  --

Anda juga dapat menggunakan singkatan berikut untuk perintah nmcli:

Tabel 1. Abbreviations of some nmcli commands

[options="header"]

nmcli command

abbreviation

nmcli general status

nmcli g

nmcli general logging

nmcli g log

nmcli connection show

nmcli con show

nmcli connection show --active

nmcli con show -a

nmcli device status

nmcli dev

Sumber daya tambahan

  • Untuk contoh lainnya, lihat man page *nmcli-examples*(5).

== Opsi nmcli

Berikut adalah beberapa opsi properti penting untuk perintah nmcli:

connection.type

Jenis koneksi. Nilai yang diizinkan adalah: adsl, bond, bond-slave, bridge, bridge-slave, bluetooth, cdma, ethernet, gsm, infiniband, olpc-mesh, team, team-slave, vlan, wifi, wimax. Setiap jenis koneksi memiliki opsi perintah khusus. Misalnya:

  • Koneksi gsm memerlukan nama titik akses yang ditentukan dalam apn.

    $ nmcli c add connection.type gsm apn pass:quotes[_access_point_name_]

  • Perangkat wifi memerlukan identifikasi set layanan yang ditentukan dalam ssid.

    $ nmcli c add connection.type wifi ssid _My identifier_

Anda dapat melihat daftar TYPE_SPECIFIC_OPTIONS di man page *nmcli*(1).

connection.interface-name

Nama perangkat yang relevan untuk koneksi.

$ nmcli con add connection.interface-name _eth0_ type _ethernet_
connection.id

Nama yang digunakan untuk profil koneksi. Jika Anda tidak menentukan nama koneksi, nama akan dihasilkan sebagai berikut:

_connection.type -connection.interface-name_

connection.id adalah nama dari profil koneksi dan tidak boleh disamakan dengan nama antarmuka yang mengacu pada perangkat (wlan0, ens3, em1). Namun, pengguna dapat memberi nama koneksi sesuai dengan antarmuka, tetapi keduanya bukanlah hal yang sama. Bisa ada beberapa profil koneksi yang tersedia untuk sebuah perangkat. Hal ini sangat berguna untuk perangkat mobile atau saat mengganti kabel jaringan bolak-balik antara perangkat yang berbeda. Daripada mengedit konfigurasi, buat profil yang berbeda dan terapkan ke antarmuka sesuai kebutuhan. Opsi id juga merujuk pada nama profil koneksi.

Opsi-opsi terpenting untuk perintah nmcli seperti show, up, down adalah:

id

String identifikasi yang diberikan oleh pengguna untuk profil koneksi. ID dapat digunakan dalam perintah nmcli connection untuk mengidentifikasi koneksi. Kolom NAME dalam output perintah selalu menunjuk ke ID koneksi. Hal ini merujuk pada nama profil koneksi yang sama dengan yang digunakan oleh con-name.

uuid

String identifikasi unik yang diberikan oleh sistem kepada profil koneksi. uuid dapat digunakan dalam perintah nmcli connection untuk mengidentifikasi koneksi.

Sumber daya tambahan

  • Lihat daftar lengkapnya di man page *nmcli*(1).

Want to help? Learn how to contribute to Fedora Docs ›