Szybki start FreeGuard CLI

FreeGuard CLI to klient VPN w wierszu poleceń, który łączy się jednym poleceniem. Zainstaluj go na macOS, Linux lub Windows, zaloguj się za pomocą adresu e-mail i uruchom freeguard connect, aby zabezpieczyć swoje połączenie internetowe w mniej niż 5 minut.

Instalacja

macOS i Linux

Zainstaluj jednym poleceniem:

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

Albo użyj Homebrew na macOS:

brew install freeguardvpn/tap/freeguard

Po instalacji sprawdź, czy wszystko działa:

freeguard version

Oczekiwany wynik:

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

Windows

Otwórz PowerShell jako Administrator i uruchom:

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

Po instalacji uruchom ponownie terminal i uruchom freeguard version, aby potwierdzić.

Logowanie

FreeGuard CLI używa weryfikacji opartej na e-mailu — rejestracja konta nie jest wymagana.

freeguard login --email [email protected] --send-code

Na swój adres e-mail otrzymasz 6-cyfrowy kod weryfikacyjny. Wprowadź go:

freeguard login --email [email protected] --code 123456

Przykładowy wynik:

✓ Zalogowano pomyślnie!
✓ Znaleziono 1 aktywną subskrypcję (Pro Plan, wygasa 2026-12-01)
✓ Konfiguracja wygenerowana: ~/.freeguard/profiles/default.yaml

Jeśli masz konto FreeGuard, możesz również zalogować się przez przeglądarkę:

freeguard login --account

Spowoduje to otwarcie przeglądarki w celu uwierzytelnienia OAuth i automatyczne zwrócenie tokenu.

Połącz

Połącz się z najszybszym dostępnym serwerem jednym poleceniem:

freeguard connect

Przykładowy wynik:

✓ Połączono z United States - New York (us-new-01)
  Protocol: anytls | Latency: 42ms
  Proxy: 127.0.0.1:7890 (HTTP/SOCKS5)

Aby połączyć się z konkretnym krajem:

freeguard connect --country JP

Aby połączyć się z konkretnym węzłem:

freeguard connect jp-tok-01

Weryfikacja

Sprawdź, czy połączenie jest aktywne:

freeguard status

Przykładowy wynik:

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)

Aby uzyskać wynik w formacie czytelnym maszynowo (przydatny do skryptów lub agentów 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}
}

Następne kroki

• Dokumentacja poleceń CLI — Pełna lista wszystkich poleceń, flag i formatów wyjściowych.
• Rozwiązywanie problemów z CLI — Rozwiązania typowych problemów z instalacją, logowaniem i połączeniem.
• Agent FreeGuard CLI — Pozwól AI automatycznie diagnozować i naprawiać problemy.
• Uruchom freeguard --help, aby zobaczyć wszystkie dostępne polecenia w terminalu.

Najczęściej zadawane pytania

Jak zainstalować FreeGuard CLI w moim systemie?

Uruchom curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sh na macOS lub Linux. Na macOS możesz też użyć brew install freeguard. Instalator automatycznie wykrywa system operacyjny i architekturę.

Czy mogę używać FreeGuard CLI bez GUI?

Tak. FreeGuard CLI działa całkowicie bez interfejsu graficznego — uruchamia się wyłącznie w terminalu i nie wymaga GUI. Dzięki temu świetnie nadaje się do serwerów, kontenerów i zdalnych sesji SSH.

Jak przełączać protokoły VPN za pomocą CLI?

Użyj freeguard connect --protocol <name>. Obsługiwane protokoły to Hysteria2, Anytls i Trojan. Domyślnie CLI wybiera najszybszy dostępny protokół dla Twojej sieci.

Czy FreeGuard CLI działa na urządzeniach ARM, takich jak Raspberry Pi?

Tak. CLI obsługuje architektury arm64 i armv7. Skrypt instalacyjny automatycznie wykrywa platformę i pobiera odpowiedni plik binarny.

Ostatnia aktualizacja: marzec 2026