Source: https://swgbar.com/ko/cli/
Language: ko

# SWG bar CLI 가이드

macOS 터미널에서 swgbar 명령줄 도구를 사용하여 HTTPS 검사 상태를 확인하고, 도메인 및 인증서 세부 정보를 조회하며, SWG 바이패스를 관리합니다.

SWG bar · 업데이트 2026년 10월 31일

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

## CLI 설정하기

[SWG bar를 설치](<https://swgbar.com/ko/install/>)한 후 실행 파일은 앱 번들 내에 위치합니다. 직접 실행하거나 셸 프로필(`~/.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 가이드](<https://swgbar.com/ko/mcp/>)를 참조하고, 인증서 및 연결 판단 기준은 [작동 원리](<https://swgbar.com/ko/how-it-works/>)를 읽어보세요.

## 관련 가이드

*   [Mac에서 SWG를 우회하는 방법](<https://swgbar.com/ko/guides/how-to-bypass-swg/>)
*   [Mac에서 HTTPS 검사를 확인하는 방법](<https://swgbar.com/ko/guides/detect-https-inspection/>)
*   [SWG 우회와 TLS 검사 예외의 차이](<https://swgbar.com/ko/guides/swg-bypass-vs-tls-exception/>)
*   [SWG bar의 HTTPS 검사 원리](<https://swgbar.com/ko/how-it-works/>)
*   [Mac에 SWG bar 설치하기](<https://swgbar.com/ko/install/>)
*   [SWG bar Chrome 확장 프로그램 연결하기](<https://swgbar.com/ko/chrome-extension/>)
*   [SWG bar MCP 가이드](<https://swgbar.com/ko/mcp/>)
*   [SWG bar 릴리스 정보](<https://swgbar.com/ko/releases/>)
*   [SWG bar 소개](<https://swgbar.com/ko/about/>)