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

Cetakan membantu penyampaian informasi.

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

~]$ nmcli help

Untuk menampilkan daftar tindakan yang tersedia terkait dengan objek yang ditentukan:

~]$ nmcli object help

Misalnya,

~]$ nmcli c help

Sumber daya tambahan

Pilihan Singkat Contoh nmcli

Bagian ini menyajikan contoh-contoh singkat dari perintah nmcli.

Persyaratan

[Getting-started-with-nmcli]

Contoh 4. 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
Contoh 5. Melihat status pencatatan NetworkManager
~]$ 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
Contoh 6. Menampilkan semua koneksi
~]$ nmcli connection show
  NAME       UUID                                  TYPE      DEVICE
Profile 1  db1060e9-c164-476f-b2b5-caec62dc1b05  ethernet    ens3
ens3       aaf6eb56-73e5-4746-9037-eed42caa8a65  ethernet    --
Contoh 7. Menampilkan hanya koneksi yang saat ini aktif
~]$ nmcli connection show --active
  NAME       UUID                                  TYPE      DEVICE
Profile 1  db1060e9-c164-476f-b2b5-caec62dc1b05  ethernet     ens3
Contoh 8. Menampilkan hanya perangkat yang dikenali oleh NetworkManager dan statusnya
~]$ nmcli device status
DEVICE  TYPE      STATE      CONNECTION
ens3    ethernet  connected  Profile 1
lo      loopback  unmanaged  --

Anda juga dapat menggunakan singkatan berikut dari perintah nmcli:

Tabel 1. Singkatan dari beberapa perintah nmcli
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-contoh lainnya, lihat halaman manual [citetitle]_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 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 halaman manual 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 halaman manual [citetitle]_nmcli(1).

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