SWG bar CLI 가이드

SWG bar는 /Applications/SWGBar.app 내에 기본 명령줄 인터페이스(swgbar)를 포함하고 있습니다. Mac 메뉴 막대 앱과 동일한 실시간 모니터링 및 검사 기능을 제공하므로 터미널이나 자동화 스크립트에서 직접 TLS 인증서를 검사하고, HTTPS 감청 여부를 확인하며, 도메인별 SWG 바이패스를 관리할 수 있습니다.

CLI 설정하기

SWG bar를 설치한 후 실행 파일은 앱 번들 내에 위치합니다. 직접 실행하거나 셸 프로필(~/.zshrc 또는 ~/.bashrc)에 별칭(alias)을 추가할 수 있으며, PATH에 심볼릭 링크를 생성하여 사용할 수도 있습니다:

# 방법 1: 앱 번들 내의 바이너리 직접 실행
/Applications/SWGBar.app/Contents/MacOS/swgbar --help

# 방법 2: 셸 프로필(~/.zshrc 또는 ~/.bashrc)에 별칭 추가
alias swgbar="/Applications/SWGBar.app/Contents/MacOS/swgbar"

# 방법 3: /usr/local/bin에 심볼릭 링크 생성 (시스템 전체 사용 권장)
sudo ln -s /Applications/SWGBar.app/Contents/MacOS/swgbar /usr/local/bin/swgbar

# CLI 설치 및 버전 확인
swgbar version

구조화된 JSON 출력이 필요한 경우 모든 명령어 뒤에 --json을 추가하세요. jq 파이프라인이나 사용자 맞춤형 자동화 스크립트 작성에 적합합니다.

개요 지표, 도메인 및 인증서 확인

overview, domains, certificates 명령어를 사용하여 메뉴 막대 앱과 동일한 실시간 데이터를 확인할 수 있습니다:

# 전체 HTTPS 검사 비율, 상태별 분석 및 주요 중간자 인증서 확인
swgbar overview

# 관찰된 도메인 목록 표시 및 필터링(confirmed, suspected, public, intranet)
swgbar domains list
swgbar domains list --status confirmed --page 1 --page-size 20
swgbar domains list --search <keyword> --bypass active

# 목록에서 특정 도메인의 연결 및 인증서 증거 세부 정보 확인
swgbar domains detail <domain>

# 인증서 클러스터 목록 확인 및 지정한 인증서 이름의 세부 정보 확인
swgbar certificates list
swgbar certificates list --status suspected
swgbar certificates detail "<certificate-name>"

도메인 실시간 검사 및 SWG 바이패스 관리

원하는 도메인을 실시간으로 TLS 검사하거나 개별 도메인의 SWG 바이패스 규칙을 관리할 수 있습니다:

# 지정한 도메인을 즉시 검사하여 인증서 신뢰 및 TLS 검사 여부 확인
swgbar probe <domain>

# 현재 SWG 도메인 바이패스 상태 및 활성 규칙 확인
swgbar bypass status

# 도메인 바이패스 활성화, 전환, 비활성화 또는 전체 삭제
swgbar bypass enable <domain>
swgbar bypass toggle <domain>
swgbar bypass disable <domain>
swgbar bypass clear

브라우저 확장 프로그램 및 앱 설정

브라우저 확장 프로그램의 연결 상태를 확인하고, 백그라운드 모니터링을 일시 중지하거나 재개하며, 앱 환경설정을 관리할 수 있습니다:

# Chrome 확장 프로그램 컴패니언 연결 상태 확인
swgbar plugins status
swgbar plugins check

# 백그라운드 모니터링 상태 확인, 일시 중지 및 재개
swgbar monitoring status
swgbar monitoring pause
swgbar monitoring resume

# 라이선스 상태 확인, 업데이트 확인, 언어 및 화면 모드 전환
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>

주요 명령어 목록

명령어	설명
swgbar overview	전체 HTTPS 검사 비율, 상태별 통계 및 주요 중간자 인증서 표시
swgbar domains list	도메인 목록 표시(--search, --status, --bypass, --page, --page-size 필터 및 페이지네이션 지원)
swgbar domains detail <domain>	지정한 도메인의 연결 메타데이터, 인증서 체인 증거 및 바이패스 상태 표시
swgbar certificates list	인증서 클러스터 목록 표시(--search 및 --status 필터 지원)
swgbar certificates detail "<certificate-name>"	지정한 인증서의 발급자 정보, 유효 기간, SHA-256 지문 및 관련 도메인 표시
swgbar bypass <status|enable|disable|toggle|clear>	도메인별 SWG 바이패스 규칙 확인 및 관리
swgbar probe <domain>	지정한 도메인을 실시간으로 즉시 TLS 검사 및 인증서 평가
swgbar plugins <status|check>	브라우저 확장 프로그램 컴패니언 연결 상태 확인
swgbar monitoring <status|pause|resume>	백그라운드 네트워크 모니터링 상태 확인, 일시 중지 및 재개
swgbar license <status|activate|deactivate>	라이선스 활성화 상태 확인 및 관리
swgbar updates check	소프트웨어 최신 업데이트 확인
swgbar language <get|set>	표시 언어 확인 및 전환(en, zh-Hans, zh-Hant, ja, ko)
swgbar appearance <get|set>	화면 테마 모드 확인 및 전환(system, light, dark)

AI 데스크톱 클라이언트에서 SWG bar를 사용하는 방법은 MCP 가이드를 참조하고, 인증서 및 연결 판단 기준은 작동 원리를 읽어보세요.