Pi CLI

pi-cli

Pi-CLI是一個命令行程序，用於直接從終端中的PI-HOLE實例查看數據。

特徵

• 實時視圖
  • 如上所示，PI-CLI可以生成您的PI-HOL數據的實時更新視圖
  • 更新至至少1s，提供實質上的實時查詢數據。將來可能會支持較小的間隔。
  • 更新參數，包括“最新查詢”表中的已記錄查詢數量，並觀看UI自動更新並為您提取正確的數據。使用箭頭鍵滾動並導航表。
• 一個關閉命令
  • 不想現場視圖？使用Pi-Cli的一個子命令之一，準確地告訴您您想要的數據，並將其提供給您。不需要花式UI。
• 數據庫分析
  • Pi-CLI具有新添加的能力，能夠分析pihole-FTL.db數據庫使用長期數據存儲用於PI孔。它可以提取和分析所有時間數據，包括客戶端，查詢和廣告域數據。
• 快速配置並忘記
  • 運行一個設置命令，Pi-CLI將存儲並記住您的所有詳細信息。
• 輕的
  • 即使記錄1000次DNS查詢，內存和CPU的使用仍然很少。
• 安全的
  • Pi-CLI使用跨平台OS鍵環庫來確保您的Pi-hole API密鑰既可以牢固地存儲又易於檢索。除非您明確地告訴Pi-Cli不使用鑰匙扣，否則您的API密鑰永遠不會以明文存儲。

用法

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

為了幫助，運行~$ picli h

在命令幫助下，運行~$ picli <command> h

對於子命令的幫助，運行~$ picli <command> -h

命令

   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

config命令

管理存儲的配置數據

   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

run命令

運行一個沒有實時視圖的單個命令

   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

database命令

這些命令是針對Pi-hole的FTL數據庫文件運行的，並提供了所有時間數據指標

   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

常問問題

• 我在哪裡獲取我的API鍵？

  • 導航到您的Pi-Hole的Web界面，然後設置設置。單擊“ API/Web接口”選項卡，然後按“顯示API令牌”。

• 預編譯二進製文件？

  • 請參閱版本

• 我如何編譯自己？

  • 用製作！ CMD/主目錄中有一個Makefile ，可用於Windows，Mac和Linux上的編譯。

  彙編目標是： win ， mac和linux

---

如果您發現Pi-CLI有用，請考慮向Pi-Hole項目捐款

或者，隨時提交代碼以使Pi-CLI更有用！