Pi CLI

Pi-cli

PI-CLI adalah program baris perintah yang digunakan untuk melihat data dari instance pi-hole secara langsung di terminal Anda.

Fitur

• Tampilan langsung
  • Seperti yang ditunjukkan di atas, pi-cli dapat menghasilkan tampilan pembaruan langsung dari data pi-hole Anda
  • Pembaruan hingga minimal 1s, menyediakan data kueri yang pada dasarnya. Dukungan untuk interval yang lebih kecil mungkin datang di masa depan.
  • Perbarui parameter termasuk jumlah kueri yang dicatat dalam tabel 'kueri terbaru' dan tonton UI memperbarui secara otomatis dan menarik data yang benar untuk Anda. Gunakan tombol panah Anda untuk menggulir dan menavigasi meja.
• Satu perintah off
  • Tidak ingin tampilan langsung? Gunakan salah satu sub-perintah Pi-cli untuk mengatakan dengan tepat data apa yang Anda inginkan, dan itu akan memberikannya kepada Anda. Tidak diperlukan UI mewah.
• Analisis Basis Data
  • Pi-CLI memiliki kemampuan yang baru ditambahkan untuk dapat menganalisis database pihole-FTL.db menggunakan penyimpanan data jangka panjang untuk pi-hole. Ini dapat mengekstrak dan menganalisis data semua waktu, termasuk data klien, kueri dan domain AD.
• Konfigurasikan dan lupa dengan cepat
  • Jalankan satu perintah pengaturan, dan Pi-Cli akan menyimpan dan mengingat semua detail Anda untuk waktu berikutnya.
• Ringan
  • Bahkan ketika mencatat 1000 dari kueri DNS, memori dan penggunaan CPU tetap minim.
• Aman
  • Pi-CLI menggunakan perpustakaan keyring OS cross-platform untuk memastikan kunci API pi-hole Anda disimpan dengan aman dan mudah diambil di masa depan. Kunci API Anda tidak pernah disimpan di Plaintext kecuali Anda secara eksplisit memberi tahu Pi-Cli untuk tidak menggunakan keyring Anda.

Penggunaan

~$ picli [global options] command [command options] [arguments...]

Untuk bantuan, jalankan ~$ picli h

Untuk bantuan perintah, jalankan ~$ picli <command> h

Untuk bantuan sub -perintah, jalankan ~$ picli <command> -h

Perintah

   setup, s     Configure Pi-CLI
   config, c    Interact with stored configuration settings
   run, r       Run a one off command without booting the live view
   database, d  Analytics options to run on a Pi-Hole's FTL database
   help, h      Shows a list of commands or help for one command

Perintah config

Kelola data konfigurasi yang disimpan

   delete, d  Delete stored config data (config file and API key)
   view, v    View config stored config data (config file and API key)
   help, h    Shows a list of commands or help for one command

Perintah run

Jalankan satu perintah tanpa tampilan langsung

   summary, s          Extract a basic summary of data from the Pi-Hole
   top-forwarded, tf   Extract the current top 10 forwarded DNS queries
   top-blocked, tb     Extract the current top 10 blocked DNS queries
   latest-queries, lq  Extract the latest queries
   enable, e           Enable the Pi-Hole
   disable, d          Disable the Pi-Hole
   help, h             Shows a list of commands or help for one command

Perintah database

Perintah ini dijalankan terhadap file database FTL Pi-hole dan menyediakan metrik data sepanjang waktu

   client-summary, cs  Summary of all Pi-Hole clients
   top-queries, tq     Returns the top (all time) queries
   help, h             Shows a list of commands or help for one command

FAQ

• Di mana saya mendapatkan kunci API saya?

  • Arahkan ke antarmuka web pi-hole Anda, lalu pengaturan. Klik pada tab API/Web Interface dan tekan 'Tampilkan Token API'.

• Binari yang telah dikompilasi sebelumnya?

  • Lihat rilis

• Bagaimana cara mengkompilasi diri saya sendiri?

  • Dengan make! Ada Makefile di Direktori CMD/Utama yang dapat digunakan untuk kompilasi pada Windows, Mac dan Linux.

  Target kompilasi adalah: win , mac dan linux

---

Jika Anda menganggap Pi-Cli berguna, silakan pertimbangkan untuk menyumbang ke proyek pi-hole

Atau, jangan ragu untuk mengirimkan kode untuk membuat pi-cli lebih bermanfaat!