Panduan SWG bar CLI

SWG bar menyertakan alat baris perintah bawaan (swgbar) di dalam /Applications/SWGBar.app. Alat ini menyediakan kemampuan pemantauan dan inspeksi langsung yang sama dengan aplikasi bilah menu macOS, memungkinkan Anda memeriksa sertifikat TLS, mengevaluasi intersepsi HTTPS, dan mengelola aturan bypass SWG langsung dari Terminal atau skrip otomatisasi.

Menyiapkan CLI

Setelah menginstal SWG bar, file biner berada di dalam paket aplikasi. Anda dapat menjalankannya secara langsung, menambahkan alias ke konfigurasi shell Anda (~/.zshrc atau ~/.bashrc), atau membuat tautan simbolis di PATH Anda:

# Opsi 1: Jalankan langsung dari paket aplikasi
/Applications/SWGBar.app/Contents/MacOS/swgbar --help

# Opsi 2: Tambahkan alias ke profil shell Anda (~/.zshrc atau ~/.bashrc)
alias swgbar="/Applications/SWGBar.app/Contents/MacOS/swgbar"

# Opsi 3: Buat tautan simbolis di /usr/local/bin (disarankan untuk akses global)
sudo ln -s /Applications/SWGBar.app/Contents/MacOS/swgbar /usr/local/bin/swgbar

# Verifikasi penginstalan dan versi CLI
swgbar version

Tambahkan --json ke perintah apa pun untuk menerima output JSON terstruktur, sangat cocok untuk pemrosesan menggunakan jq atau integrasi otomatisasi.

Memeriksa metrik ringkasan, domain, dan sertifikat

Lihat data telemetri langsung dan bukti sertifikat yang sama seperti di aplikasi bilah menu:

# Lihat persentase inspeksi HTTPS keseluruhan, rincian status, dan sertifikat intersepsi utama
swgbar overview

# Cantumkan domain yang diamati dengan filter opsional dan penomoran halaman (paginasi)
swgbar domains list
swgbar domains list --status confirmed --page 1 --page-size 20
swgbar domains list --search <keyword> --bypass active

# Lihat bukti koneksi TLS dan sertifikat terperinci untuk domain tertentu
swgbar domains detail <domain>

# Cantumkan kluster sertifikat dan periksa detail nama sertifikat tertentu
swgbar certificates list
swgbar certificates list --status suspected
swgbar certificates detail "<certificate-name>"

Memeriksa domain dan mengelola bypass SWG

Lakukan evaluasi TLS secara langsung untuk nama host apa pun atau kelola aturan bypass SWG tingkat domain:

# Periksa domain secara langsung untuk mengevaluasi kepercayaan sertifikat dan inspeksi TLS
swgbar probe <domain>

# Periksa status bypass SWG saat ini dan aturan aktif
swgbar bypass status

# Aktifkan, alihkan, nonaktifkan, atau hapus aturan bypass untuk domain tertentu
swgbar bypass enable <domain>
swgbar bypass toggle <domain>
swgbar bypass disable <domain>
swgbar bypass clear

Ekstensi peramban dan preferensi aplikasi

Periksa konektivitas ekstensi peramban, jeda atau lanjutkan pemantauan latar belakang, dan atur preferensi aplikasi:

# Periksa status koneksi ekstensi pendamping Chrome
swgbar plugins status
swgbar plugins check

# Periksa, jeda, atau lanjutkan pemantauan latar belakang
swgbar monitoring status
swgbar monitoring pause
swgbar monitoring resume

# Kelola aktivasi lisensi, periksa pembaruan, serta ubah bahasa atau tampilan
swgbar license status
swgbar updates check
swgbar language get
swgbar language set <en|zh-Hans|zh-Hant|ja|ko>
swgbar appearance get
swgbar appearance set <system|light|dark>

Perintah umum

Perintah	Deskripsi
swgbar overview	Menampilkan persentase inspeksi HTTPS, statistik status, dan sertifikat intersepsi utama
swgbar domains list	Menampilkan domain yang diamati dengan filter --search, --status, --bypass, --page, dan --page-size
swgbar domains detail <domain>	Menampilkan metadata koneksi, bukti rantai sertifikat, dan status bypass untuk domain tertentu
swgbar certificates list	Menampilkan kluster sertifikat dengan filter --search dan --status
swgbar certificates detail "<certificate-name>"	Menampilkan penerbit, masa berlaku, sidik jari SHA-256, dan domain terkait
swgbar bypass <status|enable|disable|toggle|clear>	Memeriksa atau mengelola aturan bypass SWG tingkat domain
swgbar probe <domain>	Melakukan pemeriksaan TLS langsung dan evaluasi sertifikat untuk suatu domain
swgbar plugins <status|check>	Memverifikasi konektivitas dengan ekstensi pendamping peramban
swgbar monitoring <status|pause|resume>	Memeriksa, menjeda, atau melanjutkan pemantauan jaringan latar belakang
swgbar license <status|activate|deactivate>	Melihat atau mengelola status aktivasi lisensi
swgbar updates check	Memeriksa ketersediaan pembaruan perangkat lunak
swgbar language <get|set>	Melihat atau mengatur bahasa tampilan (en, zh-Hans, zh-Hant, ja, ko)
swgbar appearance <get|set>	Melihat atau mengatur tema tampilan (system, light, dark)

Untuk mengintegrasikan SWG bar dengan klien AI desktop, lihat panduan MCP. Untuk mempelajari bagaimana bukti sertifikat dievaluasi, baca cara kerja SWG bar.