ข้ามไปที่เนื้อหา

การติดตั้ง PS Banshee

วิธีการติดตั้ง

ติดตั้ง ps-banshee ด้วย pipx หรือ pip

การติดตั้ง

PS Banshee ต้องใช้ Python 3.10 หรือเวอร์ชันที่ใหม่กว่า (สูงสุดถึง 3.13)

แนะนำ: pipx (สภาพแวดล้อมแบบแยกส่วน)

เพื่อติดตั้งในระดับ global ให้รัน:

pipx install ps-banshee

การติดตั้ง pipx

หากยังไม่ได้ติดตั้ง pipx ให้ดูที่ คู่มือการติดตั้ง

ทางเลือก: pip (สภาพแวดล้อมปัจจุบัน)

เพื่อติดตั้งในสภาพแวดล้อมปัจจุบัน ให้รัน:

pip install ps-banshee

การอ้างอิง (Dependencies)

Python dependencies ที่จำเป็นทั้งหมดจะถูกจัดการโดยอัตโนมัติโดย pip เพื่อใช้คำสั่ง pcap ให้แน่ใจว่ามีสิ่งต่อไปนี้:

  • tshark 3.0.0 หรือเวอร์ชันที่ใหม่กว่า

การอนุญาตสิทธิ์

PS Banshee อ่าน API key ของ Recorded Future จากตัวแปรสภาพแวดล้อม RF_TOKEN (แนะนำ) หรือจาก flag -k / --api-key ที่ระบุในแต่ละคำสั่ง

ตัวเลือกที่ 1: ตั้งค่า RF_TOKEN (แนะนำ)

เฉพาะ shell ปัจจุบันเท่านั้น:

export RF_TOKEN=<your_api_key>

บันทึกอย่างถาวรสำหรับ shell ในอนาคต (zsh — ปรับเป็น ~/.bashrc สำหรับ bash) เปิด shell ใหม่หลังจากรันคำสั่งนี้ (หรือรัน source ~/.zshrc เพื่อใช้งานใน shell ปัจจุบัน):

echo 'export RF_TOKEN=<your_api_key>' >> ~/.zshrc

เฉพาะ session ปัจจุบันเท่านั้น:

$env:RF_TOKEN = '<your_api_key>'

บันทึกอย่างถาวรสำหรับ session ในอนาคต (เปิด PowerShell ใหม่หลังจากรันคำสั่งนี้):

setx RF_TOKEN <your_api_key>

เฉพาะ session ปัจจุบันเท่านั้น:

set RF_TOKEN=<your_api_key>

บันทึกอย่างถาวรสำหรับ session ในอนาคต (เปิด Command Prompt ใหม่หลังจากรันคำสั่งนี้):

setx RF_TOKEN <your_api_key>

ตัวเลือกที่ 2: ระบุด้วย -k ในแต่ละคำสั่ง

banshee -k <your_api_key> <command> <sub-command> <arguments>

วิธีนี้ใช้งานได้บนทุกแพลตฟอร์ม แต่มีความยุ่งยากมากกว่า และ key อาจถูกบันทึกไว้ใน shell history

การอัปเกรด PS Banshee

เพื่ออัปเกรด PS Banshee เป็นเวอร์ชันที่ใหม่กว่า ให้ติดตั้งใหม่โดยใช้ไฟล์ wheel ที่อัปเดตแล้ว

การอัปเกรดจาก v1.0.0 หรือเวอร์ชันก่อนหน้า

หากกำลังอัปเกรดจาก v1.0.0 หรือเวอร์ชันที่เก่ากว่า จะต้องถอนการติดตั้งแพ็กเกจที่มีอยู่ก่อนจึงจะติดตั้งเวอร์ชันใหม่ได้

หากติดตั้งด้วย pipx:

pipx uninstall banshee 
pipx install ps-banshee

หากติดตั้งด้วย pip:

pip uninstall banshee
pip install ps-banshee

หากติดตั้งด้วย pipx:

pipx install --force ps-banshee

หากติดตั้งด้วย pip:

pip install --upgrade ps-banshee

การเติมคำสั่งอัตโนมัติใน Shell

หลังจากติดตั้ง PS Banshee แล้ว ให้เปิดใช้งานการเติมคำสั่งอัตโนมัติด้วย:

banshee --install-completion

รีสตาร์ท shell เพื่อให้การติดตั้งเสร็จสมบูรณ์ หลังจากนั้นสามารถใช้ TAB เพื่อเติมคำสั่งอัตโนมัติได้

การถอนการติดตั้ง

เพื่อลบ PS Banshee ออกจากระบบ ให้ใช้คำสั่งที่เหมาะสมตามวิธีการติดตั้งที่ใช้

หากติดตั้งด้วย pipx:

pipx uninstall ps-banshee

หากติดตั้งด้วย pip:

pip uninstall ps-banshee

ขั้นตอนถัดไป

ดูที่ ขั้นตอนเริ่มต้น เพื่อเริ่มใช้งาน PS Banshee