FreeGuard CLI 빠른 시작

FreeGuard CLI는 한 번의 명령으로 연결되는 명령줄 VPN 클라이언트입니다. macOS, Linux 또는 Windows에 설치한 다음, 이메일로 로그인하고 freeguard connect를 실행하면 5분 이내에 인터넷을 보호할 수 있습니다.

설치

macOS 및 Linux

단일 명령으로 설치:

curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sh

또는 macOS에서 Homebrew 사용:

brew install freeguardvpn/tap/freeguard

설치 후 정상적으로 작동하는지 확인:

freeguard version

예상 출력:

FreeGuard CLI v1.0.0
Core: mihomo v1.19.21
OS: darwin/arm64

Windows

관리자 권한으로 PowerShell을 열고 다음을 실행:

irm https://downloadcli.freeguardvpn.com/cli/install.ps1 | iex

설치 후 터미널을 다시 시작하고 freeguard version을 실행하여 확인합니다.

연결

한 번의 명령으로 가장 빠른 사용 가능한 서버에 연결:

freeguard connect

예시 출력:

✓ 미국 - 뉴욕(us-new-01)에 연결됨
  Protocol: anytls | 지연 시간: 42ms
  Proxy: 127.0.0.1:7890 (HTTP/SOCKS5)

특정 국가에 연결하려면:

freeguard connect --country JP

특정 노드에 연결하려면:

freeguard connect jp-tok-01

확인

연결이 활성화되어 있는지 확인:

freeguard status

예시 출력:

FreeGuard VPN Status
────────────────────
Status:     ● Connected
Node:       United States - New York (us-new-01)
Protocol:   anytls
Latency:    42ms
Upload:     1.2 MB/s
Download:   15.8 MB/s
Duration:   2h 15m
Mode:       System Proxy (HTTP/SOCKS5)

기계 판독 가능한 출력을 얻으려면(스크립팅 또는 AI 에이전트에 유용):

freeguard status --json

{
  "connected": true,
  "node": {"id": "us-new-01", "name": "United States - New York", "country": "US"},
  "protocol": "anytls",
  "latency_ms": 42,
  "traffic": {"upload_bps": 1258291, "download_bps": 16569754},
  "duration_seconds": 8100,
  "mode": "system_proxy",
  "proxy_port": {"mixed": 7890}
}

다음 단계

CLI 명령 참조 — 모든 명령, 플래그, 출력 형식의 전체 목록.
CLI 문제 해결 — 일반적인 설치, 로그인, 연결 문제에 대한 해결 방법.
FreeGuard CLI Agent — AI가 문제를 자동으로 진단하고 해결하도록 하세요.
터미널에서 freeguard --help를 실행하여 사용 가능한 모든 명령을 살펴보세요.

자주 묻는 질문

내 시스템에 FreeGuard CLI를 어떻게 설치하나요?

macOS 또는 Linux에서 curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sh를 실행하세요. macOS에서는 brew install freeguard를 사용할 수도 있습니다. 설치 프로그램이 OS와 아키텍처를 자동으로 감지합니다.

GUI 없이 FreeGuard CLI를 사용할 수 있나요?

네. FreeGuard CLI는 완전한 헤드리스 방식으로 동작하며, 그래픽 인터페이스 없이 터미널에서만 실행됩니다. 따라서 서버, 컨테이너, 원격 SSH 세션에 이상적입니다.

CLI로 VPN 프로토콜을 어떻게 전환하나요?

freeguard connect --protocol <name>를 사용하세요. 지원되는 프로토콜에는 Hysteria2, Anytls, Trojan이 포함됩니다. CLI는 네트워크에서 가장 빠른 사용 가능한 프로토콜을 기본값으로 사용합니다.

FreeGuard CLI는 Raspberry Pi 같은 ARM 장치에서 작동하나요?

네. CLI는 arm64 및 armv7 아키텍처를 지원합니다. 설치 스크립트가 플랫폼을 자동으로 감지하고 올바른 바이너리를 다운로드합니다.

최종 업데이트: March 2026