CLI Niznet

1. Apa itu CLI Niznet#

CLI (command-line interface) Niznet adalah cara mengatur router Niznet dengan mengetik perintah, lewat koneksi SSH dari komputer Anda. CLI berisi pengaturan yang sama dengan WebUI, disusun dalam menu yang sama: Internet, Jaringan Lokal, Wi-Fi, Firewall, VPN, Hotspot, Routing, Monitoring, dan Sistem. Jika Anda sudah tahu letak sebuah pengaturan di WebUI, Anda sudah tahu letaknya di CLI.

CLI cocok untuk Anda yang:

• mengelola banyak router dan ingin bekerja lebih cepat dengan keyboard,
• ingin melihat seluruh konfigurasi dalam bentuk teks,
• perlu menjalankan satu perintah dari script, misalnya untuk pemantauan.

Model yang memiliki CLI

CLI dan WebUI memakai satu konfigurasi yang sama. Perubahan dari CLI langsung terlihat di WebUI, dan sebaliknya.

2. Masuk ke CLI#

Yang Anda perlukan#

• Komputer yang terhubung ke jaringan router (kabel LAN atau Wi-Fi).
• Program SSH. Di Windows 10/11, macOS, dan Linux, perintah ssh sudah tersedia di Terminal / PowerShell. Anda juga bisa memakai PuTTY.
• Alamat IP router:
  • NR642: alamat bawaannya 192.168.45.1.
  • NAP612: mengambil alamat dari DHCP server di jaringan Anda - lihat di daftar klien DHCP router utama (nama host nap612-xxxx). Jika tidak ada DHCP server, misalnya laptop disambung langsung, NAP612 memakai 192.168.112.1 setelah sekitar 15 detik; beri laptop alamat tetap, misalnya 192.168.112.10/24.
  • vNR: mengambil alamat dari DHCP di jaringan tempat ia dipasang; lihat alamatnya di daftar lease DHCP jaringan itu, atau masuk lewat konsol hypervisor. Tanpa DHCP, vNR memakai 169.254.45.1. vNR yang dipasang di VPS memakai alamat VPS itu sendiri.

Masuk dengan akun pemilik#

Masuk dengan akun pemilik router - akun yang sama dengan yang Anda pakai untuk masuk ke WebUI. Nama akun bawaan adalah niznet.

ssh niznet@192.168.45.1

Ganti 192.168.45.1 dengan alamat router Anda, dan niznet dengan nama akun Anda jika sudah Anda ubah.

Catatan: Akun lain yang dibuat di WebUI (menu Sistem → Pengguna) juga dapat masuk ke CLI dengan nama dan kata sandinya sendiri. Akun yang sudah ada sebelum update ke 0.9.0 baru bisa masuk ke CLI setelah kata sandinya diatur ulang sekali di WebUI. Akun dengan peran hanya-baca dapat melihat, tetapi tidak dapat mengubah pengaturan atau me-reboot router.

Pertama kali masuk: ganti kata sandi bawaan#

Router baru (atau router yang baru di-reset) masih memakai login bawaan pabrik: nama niznet, kata sandi niznet. Login ini sama di semua unit dan tercantum di dokumentasi, jadi router meminta Anda menggantinya sebelum melakukan apa pun. Ini juga berlaku jika Anda masuk pertama kali lewat CLI, bukan lewat WebUI.

Yang akan Anda lihat:

1. Pesan bahwa unit masih memakai login bawaan.
2. Ketentuan lisensi, lalu pertanyaan apakah Anda menyetujuinya. Ketik y untuk setuju.
3. Permintaan kata sandi saat ini (niznet), lalu kata sandi baru dua kali. Ketikan tidak ditampilkan di layar - itu normal.

This unit still has the login it shipped with. Every unit has it and it is
published in the documentation, so it is changed before anything else.

...(ketentuan lisensi)...

Do you accept these licence terms (version ...)? [y/N]: y
Current password (the one you logged in with):
New password:
New password again:
The password is changed: SSH and the WebUI take the new one from now on.

Kata sandi baru minimal 12 karakter dan tidak boleh sama dengan kata sandi bawaan. Kata sandi baru langsung berlaku untuk SSH dan WebUI. Jika Anda menjawab tidak, atau menekan Ctrl-C, Anda keluar dan tidak ada yang berubah.

Catatan: Penggantian kata sandi pertama harus dilakukan di terminal biasa. Perintah satu baris dari script (lihat FAQ) ditolak sampai kata sandi bawaan diganti.

Tampilan setelah masuk#

Setelah masuk, router menampilkan logo Niznet, versi sistem, model, dan nama router, lalu prompt:

  Niznet OS 0.9.0
  ...

  Model:     NR642
  Identity:  nr642-1a2b

  Type ? for help, Tab to complete.
  Commit mode: immediate - each change is committed as you type it.

[niznet@nr642-1a2b] >

Prompt menunjukkan siapa Anda dan router mana yang sedang Anda atur: [akun@nama-router] >. Saat Anda berada di dalam sebuah menu, namanya ikut tampil:

[niznet@nr642-1a2b] /internet uplinks>

Di semua contoh di halaman ini, Anda cukup mengetik bagian setelah tanda >.

Pilihan: masuk hanya dengan kunci SSH#

Agar lebih aman, Anda dapat mematikan login SSH dengan kata sandi dan hanya mengizinkan kunci SSH:

1. Tambahkan kunci publik SSH Anda di WebUI, menu Sistem → tab Pengaturan, bagian SSH key (tombol Tambah SSH key). (Menambah kunci belum bisa dilakukan dari CLI di versi 0.9.0.)
2. Pastikan Anda bisa masuk dengan kunci tersebut.
3. Lalu di CLI:

/system settings set ssh-key-only=yes

3. Menu dan cara berpindah#

Menu utama#

Menu CLI mengikuti menu di sidebar WebUI, dengan urutan yang sama.

Tidak ada menu Dashboard: informasi Dashboard ada di perintah show setiap menu, dan informasi sistem di /system resources. Router vNR tidak memiliki menu /wifi.

Berpindah menu#

Contoh:

[niznet@nr642-1a2b] > /internet uplinks
[niznet@nr642-1a2b] /internet uplinks> ..
[niznet@nr642-1a2b] /internet> /
[niznet@nr642-1a2b] >

Bantuan: ? dan Tab#

• ? - tampilkan apa yang bisa diketik di posisi Anda: submenu, perintah yang tersedia di menu itu, pengaturan yang sedang terisi, perintah global, dan mode commit yang aktif. ? langsung dijawab begitu diketik, tanpa Enter.
• Tab - melengkapi nama menu, perintah, nama item, atau nama pengaturan. Ketik beberapa huruf, lalu tekan Tab.
• Panah atas/bawah - memanggil kembali perintah sebelumnya.
• Ctrl-C - membatalkan baris yang sedang diketik (atau menghentikan ping yang sedang berjalan).

4. Perintah dasar#

Hampir semua menu memakai perintah yang sama. Sebuah menu hanya menawarkan perintah yang memang berguna di sana - ketik ? untuk melihat daftarnya.

Nama item di contoh (misalnya wan, no-telnet, cam) hanyalah contoh. Lihat nama yang ada di router Anda dengan show.

Menunjuk sebuah item#

Item dalam daftar bisa ditunjuk dengan tiga cara:

1. Namanya: /firewall rules disable no-telnet

2. Nomornya dari show terakhir di menu itu. Nomor dimulai dari 0:

   [niznet@nr642-1a2b] > /firewall rules show
     0   name=no-telnet direction=input proto=tcp dport=23 action=drop ...
   [niznet@nr642-1a2b] > /firewall rules disable 0

   Salin

   Item yang dinonaktifkan ditandai X di depannya.

3. Pencarian: [find where kunci=nilai], misalnya:

   /firewall rules set [find where dport=23] action=reject

   Salin

Menulis nilai#

• Bentuknya kunci=nilai, misalnya metric=5.
• Nilai yang berisi spasi diberi tanda kutip: location="Floor 3".
• Beberapa nilai dipisah koma, tanpa spasi: upstream=8.8.8.8,1.1.1.1.
• Ya/tidak ditulis yes dan no.
• Pengaturan bertingkat memakai titik: ntp.server=pool.ntp.org, security.passphrase="...".

export: konfigurasi sebagai teks#

export menampilkan konfigurasi dalam bentuk perintah yang dapat ditempel kembali. Di menu teratas (/), export menampilkan seluruh konfigurasi; di dalam sebuah menu, hanya bagian menu itu:

[niznet@nr642-1a2b] > /firewall
[niznet@nr642-1a2b] /firewall> export
/firewall status
set flow-offload=software conntrack-max=16384 mss-clamp=yes reverse-path-filter=yes
/firewall zones
add name=lan interface=br-lan input=reject ...
add name=wan interface=eth1 input=reject ...
...

Anda juga bisa menulis jalur menu di depan export dari menu mana pun. Misalnya /firewall export yang diketik di menu teratas menampilkan bagian firewall saja, sama seperti export di dalam /firewall.

Kata sandi dan kunci rahasia tidak ditampilkan di export. CLI 0.9.0 belum bisa menyimpan export ke file (export file= ditolak); untuk menyimpan konfigurasi ke file, lihat bagian 9.

5. Menyimpan perubahan: commit, review, dan rollback#

Setiap perubahan konfigurasi disimpan sebagai revisi bernomor. Anda bisa melihat siapa mengubah apa dan kapan, dan kembali ke revisi sebelumnya kapan saja.

CLI punya dua mode commit. Mode yang aktif selalu disebutkan saat Anda masuk dan setiap kali Anda mengetik ?.

Mode immediate (bawaan): setiap perubahan langsung berlaku#

Di mode ini, setiap perintah yang mengubah sesuatu langsung di-commit, melalui pemeriksaan yang sama seperti commit biasa. Router menampilkan apa yang berubah (- nilai lama, + nilai baru) dan nomor revisinya:

[niznet@nr642-1a2b] > /internet uplinks set wan metric=5
- /internet uplinks interface=wan metric=10
+ /internet uplinks interface=wan metric=5
committed as revision 14

Jika perubahan ditolak (misalnya nilainya tidak valid), router menjelaskan alasannya dan perubahan itu tetap tertahan:

not committed: ...
the change is staged; fix it and `commit`, or `discard`

Perbaiki lalu ketik commit, atau batalkan dengan discard.

Mode review: kumpulkan dulu, periksa, lalu commit#

Di mode review, perubahan ditampung dulu dan baru berlaku setelah Anda mengetik commit. Cocok untuk perubahan besar yang terdiri dari beberapa langkah. Aktifkan dengan:

/system configuration set commit-mode=review

Mode commit adalah pengaturan untuk seluruh router, bukan hanya untuk sesi Anda. Untuk kembali ke mode immediate:

/system configuration set commit-mode=immediate
commit

(Di mode review, perintah pertama ikut ditampung, jadi perlu commit.)

Perintah di mode review:

Setiap sesi CLI punya tampungannya sendiri, jadi perubahan Anda tidak tercampur dengan perubahan orang lain yang sedang bekerja di WebUI atau sesi lain.

Contoh:

[niznet@nr642-1a2b] > /local-network dns set upstream=8.8.8.8,1.1.1.1
...
staged; `commit` applies it, `compare` shows it
[niznet@nr642-1a2b] > compare
...
[niznet@nr642-1a2b] > commit comment="ganti DNS upstream"
committed as revision 15

commit confirm: jaring pengaman saat mengubah akses jarak jauh#

Saat mengubah sesuatu yang bisa memutus koneksi Anda sendiri ke router - port SSH, alamat yang boleh mengakses router, firewall, atau alamat LAN - gunakan commit confirm=N:

1. Router menerapkan perubahan dan mulai menghitung mundur N menit.
2. Biarkan sesi ini tetap terbuka. Dari jendela terminal baru, coba masuk dengan pengaturan yang baru.
3. Jika berhasil, kembali ke sesi pertama dan ketik confirm (atau tekan Simpan perubahan ini pada pemberitahuan di WebUI).
4. Jika Anda tidak bisa masuk lagi, tidak perlu melakukan apa pun: setelah N menit router kembali sendiri ke konfigurasi sebelumnya.

[niznet@nr642-1a2b] > commit confirm=5
committed as revision 16; it rolls back in 5 minutes unless you `confirm`

Di sesi pertama:

[niznet@nr642-1a2b] > confirm
confirmed: the change stays

confirm hanya diterima dari sesi yang menjalankan commit confirm; dari sesi lain, gunakan tombol Simpan perubahan ini di WebUI. Hanya ada satu hitung mundur pada satu waktu untuk setiap router.

CLI 0.9.0 tidak menolak perubahan port SSH yang dibuat tanpa commit confirm. Di mode immediate, perubahan itu langsung berlaku tanpa hitung mundur. Karena itu, untuk perubahan seperti ini selalu pindah ke mode review dan pakai commit confirm=N (contoh 6 di bagian 8).

Di dalam menu /system firmware, confirm dan rollback adalah perintah firmware (bagian 7). Ketik confirm dan rollback N untuk konfigurasi di luar menu itu.

Riwayat dan rollback (di kedua mode)#

Apa yang dilakukan rollback N:

• Mode immediate: router langsung kembali ke isi revisi N. Rollback ini dicatat sebagai revisi baru, jadi riwayat tidak pernah hilang dan rollback pun bisa di-rollback.

  rolled back to revision 12, as a new revision

• Mode review: isi revisi N (termasuk kata sandi dan kunci yang tersimpan di revisi itu) dimuat ke tampungan Anda dan menggantikan semua perubahan yang sedang ditampung. Belum ada yang berubah sampai Anda commit. Periksa dulu dengan compare, atau batalkan dengan discard.

  revision 12, its secrets included, is your candidate now (it replaced anything staged); `compare` shows it, `commit` applies it, `discard` drops it

Router menyimpan 30 revisi terakhir; revisi yang lebih lama dihapus otomatis.

6. Menyaring keluaran (pipe)#

Setelah show, show history, atau export, Anda bisa menambahkan tanda | dan sebuah penyaring:

Pipe bisa dirangkai, dan dijalankan berurutan:

/firewall rules show where action=drop | match telnet | count

| count menjawab dalam bentuk Count: 3 lines. Pencarian match dan except membedakan huruf besar dan kecil.

7. Perintah operasional#

Diagnostik#

/monitoring diagnostics ping 8.8.8.8 count=4
/monitoring diagnostics traceroute 8.8.8.8
/monitoring diagnostics dns-lookup niznet.com

Status router#

/system resources show
/system identity show
/system identity set hostname=kantor-pusat
/routing table show
/wifi clients show
/vpn ipsec status show
/vpn ipsec status show name=branch

• /system resources show - CPU, memori, dan waktu aktif.
• /system identity - nama router (yang tampil di prompt). Jika belum pernah diatur, router memakai nama bawaannya sendiri.
• /vpn ipsec status show - status langsung setiap site IPsec; dengan name=<site>, detail satu site.

Firmware#

/system firmware status
/system firmware confirm
/system firmware rollback

• status (sama dengan show) - versi firmware yang berjalan dan, jika firmware baru sedang dalam masa uji (trial), statusnya dan sisa waktunya.
• confirm - pertahankan firmware yang sedang dalam masa uji. Konfirmasi dicatat bersama alamat komputer SSH Anda.
• rollback - bertanya dulu, lalu kembali ke firmware sebelumnya atau membatalkan upgrade yang sudah dijadwalkan. Router akan restart.

Instalasi firmware baru dilakukan lewat WebUI (Sistem → Pengaturan → Firmware).

Reboot#

/system reboot

Router bertanya Reboot, yes? [y/N] dan hanya me-reboot jika Anda menjawab y. Reboot ditolak selama firmware baru masih dalam masa uji - konfirmasi atau rollback firmware-nya dulu.

"Belum tersedia di shell ini"#

Beberapa perintah lanjutan belum ada di CLI versi 0.9.0, tetapi sudah tersedia di WebUI. Jika Anda mengetiknya, router menjawab:

/system backup save: not in this shell yet - the WebUI has it

Artinya: perintah ini belum tersedia di CLI - fitur ini ada di WebUI. Router tidak pernah berpura-pura berhasil; tidak ada yang berubah. Daftarnya ada di bagian 9.

8. Contoh tugas dari awal sampai akhir#

Semua contoh di bawah memakai mode immediate (bawaan). Nama, alamat, dan kata sandi hanya contoh - ganti dengan milik Anda.

Contoh 1: Mengganti kata sandi Wi-Fi#

Lihat dulu daftar jaringan Wi-Fi beserta nomornya:

[niznet@nr642-1a2b] > /wifi networks show

Lalu ganti kata sandi jaringan yang Anda inginkan, dengan namanya atau nomornya:

[niznet@nr642-1a2b] > /wifi networks set 0 security.passphrase="KataSandiBaru2026"

Catatan: Jika Anda terhubung ke router lewat Wi-Fi tersebut, koneksi Anda akan terputus. Sambungkan kembali dengan kata sandi baru.

Contoh 2: Memberi alamat IP tetap untuk printer (reservasi DHCP)#

[niznet@nr642-1a2b] > /local-network dhcp leases add name=printer mac=aa:bb:cc:00:11:22 ip=192.168.45.10
[niznet@nr642-1a2b] > /local-network dhcp leases show

Perangkat dengan alamat MAC tersebut selalu mendapat 192.168.45.10. show di menu ini juga menampilkan lease yang sedang aktif.

Contoh 3: Menambah route statis#

Agar jaringan 10.60.0.0/16 dicapai lewat router lain di 192.168.45.3:

[niznet@nr642-1a2b] > /routing static add name=backup destination=10.60.0.0/16 gateway=192.168.45.3
[niznet@nr642-1a2b] > /routing table show

Menonaktifkan sementara tanpa menghapus: /routing static disable backup.

Contoh 4: Memeriksa koneksi internet#

[niznet@nr642-1a2b] > /internet uplinks show
[niznet@nr642-1a2b] > /monitoring diagnostics ping 8.8.8.8 count=4
[niznet@nr642-1a2b] > /monitoring diagnostics dns-lookup niznet.com

/internet uplinks show menampilkan uplink yang dikonfigurasi (prioritas, probe, kuota). Jika ping ke 8.8.8.8 berhasil tetapi dns-lookup gagal, masalahnya ada di DNS - periksa /local-network dns show.

Contoh 5: Membatalkan kesalahan dengan rollback#

Anda baru saja mengubah sesuatu dan jaringan bermasalah. Lihat riwayat:

[niznet@nr642-1a2b] > show history
  REV  WHEN (UTC)          BY
   18  2026-11-07 03:12:40  shell, niznet
   17  2026-11-07 02:58:01  api, niznet  "via web"
   ...

Lihat apa yang berbeda dengan revisi sebelum kesalahan, lalu kembali ke sana:

[niznet@nr642-1a2b] > compare rollback=17
[niznet@nr642-1a2b] > rollback 17
rolled back to revision 17, as a new revision

Contoh 6: Memindahkan port SSH dengan aman#

Mengubah port SSH bisa memutus koneksi Anda sendiri, jadi gunakan mode review dan commit confirm:

[niznet@nr642-1a2b] > /system configuration set commit-mode=review
[niznet@nr642-1a2b] > /system remote-services set ssh port=2222
[niznet@nr642-1a2b] > compare
[niznet@nr642-1a2b] > commit confirm=5
committed as revision 19; it rolls back in 5 minutes unless you `confirm`

Jangan tutup jendela ini. Buka jendela terminal baru di komputer Anda dan coba masuk lewat port baru:

ssh -p 2222 niznet@192.168.45.1

Jika berhasil masuk, kembali ke jendela pertama dan ketik confirm:

[niznet@nr642-1a2b] > confirm
confirmed: the change stays

confirm diketik di sesi yang menjalankan commit confirm. Cara lain: masuk ke WebUI dan tekan Simpan perubahan ini pada pemberitahuan yang muncul. Jika Anda tidak bisa masuk lewat port 2222, tunggu 5 menit: router kembali ke port 22 dengan sendirinya. Setelah selesai, kembalikan ke mode immediate jika Anda mau (lihat bagian 5).

9. Yang masih lewat WebUI (versi 0.9.0)#

CLI 0.9.0 sudah mencakup hampir semua pengaturan. Beberapa tindakan masih hanya ada di WebUI:

Untuk move, router menjawab dengan petunjuk: untuk sementara gunakan sequence= untuk aturan firewall, priority= untuk policy routing, dan order= untuk server RADIUS.

10. Tips dan FAQ#

Apakah CLI dan WebUI bisa dipakai bersamaan? Bisa. Keduanya memakai satu konfigurasi yang sama. Perubahan yang di-commit dari CLI langsung terlihat di WebUI, dan sebaliknya. show history mencatat dari mana setiap perubahan berasal.

Bagaimana cara keluar dari CLI? Ketik quit (atau exit). Di baris kosong, Ctrl-D juga mengakhiri sesi.

Bisakah saya menjalankan satu perintah langsung dari komputer, tanpa masuk? Bisa - berguna untuk script dan pemantauan:

ssh niznet@192.168.45.1 '/system resources show'

Perintah yang ditolak menghasilkan kode keluar bukan nol, sehingga script Anda tahu bahwa perintah gagal. Pertanyaan konfirmasi (misalnya reboot) dianggap "tidak" jika tidak ada jawaban.

Bagaimana cara mengembalikan router ke pengaturan pabrik? Selama Anda masih bisa masuk ke WebUI, gunakan menu Sistem → Pengaturan → Backup & Restore → Reset pabrik… (berlaku untuk NR642, NAP612, dan vNR). Login Anda tetap, kecuali Anda mencentang Kembalikan juga ke login bawaan pabrik; jika dicentang, router kembali ke login bawaan (niznet / niznet) dan meminta Anda menggantinya saat masuk.

Konfigurasi lama Anda tidak hilang dari riwayat: setelah masuk, Anda bisa melihatnya dengan show history dan mengembalikannya dengan rollback N.

Catatan: Setelah reset pabrik, vNR kembali mengambil alamat dari DHCP (atau 169.254.45.1 jika tidak ada DHCP); alamat tetap yang diatur saat instalasi di VPS tidak dipakai lagi. Pastikan Anda bisa membuka konsol hypervisor sebelum me-reset vNR.

Saya lupa kata sandi dan tidak bisa masuk sama sekali. Apa yang harus dilakukan?

• vNR: pasang ulang image vNR, lalu pulihkan pengaturan dari file backup. Tanpa backup, pengaturan hilang. vNR sengaja tidak punya cara reset atau jalan pintas pemulihan lain, agar celah keamanan di hypervisor tidak menjadi jalan masuk ke vNR. Karena itu, simpan backup setelah setup (Sistem → Pengaturan → Backup & Restore).
• NR642 dan NAP612: hubungi dukungan Niznet di info@niznet.com.

Bagaimana jika saya salah mengubah sesuatu? Gunakan rollback (bagian 5). Untuk perubahan berisiko, biasakan memakai commit confirm=N.

Kenapa perintah saya ditolak dengan "is not a command here" atau "has no ..."? Perintah itu tidak tersedia di menu tempat Anda berada - misalnya disable di menu yang item-nya tidak punya saklar aktif/nonaktif. Ketik ? untuk melihat perintah yang tersedia di menu itu.

Saya terbiasa dengan CLI router lain. Apakah mirip? Kemungkinan besar Anda akan cepat terbiasa: menu bertingkat, print/show, add/set/remove, penomoran item, [find where ...], serta commit, compare, dan rollback bekerja seperti yang umum dipakai di CLI router.