Rješavanje problema s FreeGuard CLI

Imate problema s FreeGuard CLI? Ovaj vodič pokriva najčešće probleme i njihova rješenja. Za svaki problem, prvo pokušajte pokrenuti freeguard doctor — automatski otkriva većinu problema s konfiguracijom i okruženjem.

Problemi s instalacijom

Pristup odbijen tijekom instalacije

Simptom: Instalacijska skripta ne uspijeva s Permission denied ili EACCES.

Rješenje: Na macOS/Linux, instalacijski program treba pristup za pisanje u /usr/local/bin. Pokrenite s povišenim ovlastima:

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

Na Windowsu otvorite PowerShell kao Administrator prije pokretanja instalacijske naredbe.

Naredba nije pronađena nakon instalacije

Simptom: Pokretanje freeguard vraća command not found ili not recognized.

Doctor izlaz:

✗ CLI binary:     Not in PATH

Rješenje: Binarna datoteka možda nije u PATH-u vaše ljuske. Dodajte je ručno:

# macOS/Linux — add to your shell profile (~/.bashrc, ~/.zshrc)
export PATH="$HOME/.freeguard/bin:$PATH"

# Then reload your shell
source ~/.zshrc  # or ~/.bashrc

Na Windowsu dodajte %USERPROFILE%\.freeguard\bin u sistemsku varijablu okoline PATH i ponovno pokrenite terminal.

curl ne uspijeva ili preuzimanje istječe

Simptom: Instalacijska skripta ne može preuzeti binarnu datoteku.

Rješenje: Ako ste iza korporativnog vatrozida ili u ograničenoj mreži, preuzmite binarnu datoteku ručno sa stranice izdanja na GitHubu i stavite je u ~/.freeguard/bin/. Zatim je učinite izvršnom:

chmod +x ~/.freeguard/bin/freeguard

Problemi s prijavom

Verifikacijski kod nije primljen

Simptom: Nakon pokretanja freeguard login --email [email protected] --send-code, ne stiže e-mail.

Rješenje:

Provjerite mapu za neželjenu poštu/spam — verifikacijski e-mailovi se ponekad filtriraju.
Pričekajte 2 minute prije ponovnog zahtjeva. Postoji ograničenje brzine slanja kodova.
Provjerite je li e-mail adresa ispravna:

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

Pokušajte s drugim pružateljem e-pošte ako problem potraje.

Token istekao

Simptom: Naredbe ne uspijevaju s Authentication expired ili Token invalid.

Doctor izlaz:

✗ Credentials:     Token expired (last refresh: 2026-03-01)

Rješenje: Prijavite se ponovo kako biste osvježili svoje vjerodajnice:

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

Pogrešan e-mail — pretplata nije pronađena

Simptom: Prijava uspijeva, ali freeguard connect kaže No active subscription.

Doctor izlaz:

✓ Credentials:     Logged in (email: u***@example.com)
✗ Subscription:    No active subscription found

Rješenje: Provjerite prijavljujete li se istim e-mailom kojim ste kupili pretplatu. Ako ste koristili drugi e-mail:

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

Problemi s povezivanjem

Istek vremena povezivanja

Simptom: freeguard connect se zamrzava ili vraća Connection timed out.

Doctor izlaz:

✗ Network:         Internet not reachable

Rješenje:

Provjerite osnovnu internetsku vezu (najprije isključite VPN):

freeguard disconnect
ping 8.8.8.8

Pokušajte s drugim čvorom ili državom:

freeguard connect --country SG

Pokušajte s drugim protokolom koji može bolje raditi na vašoj mreži:

freeguard connect --protocol hysteria2

Port 7890 je već u upotrebi

Simptom: freeguard connect ne uspijeva s Port 7890 is already in use.

Doctor izlaz:

✗ Port 7890:       In use by another process (PID: 12345)

Rješenje: Druga proxy aplikacija koristi zadani port. Ili zaustavite drugu aplikaciju ili promijenite FreeGuard proxy port:

freeguard config set proxy.port 8080
freeguard connect

Otkriveno curenje DNS-a

Simptom: DNS upiti zaobilaze VPN tunel.

Rješenje: Prebacite se na sigurnu DNS konfiguraciju:

freeguard config set dns.provider secure
freeguard disconnect
freeguard connect

Možete provjeriti usmjerava li se DNS kroz VPN:

freeguard doctor

Potražite provjeru DNS u izlazu kako biste potvrdili da ispravno radi.

Problemi s dozvolama

TUN način rada zahtijeva sudo

Simptom: freeguard connect --tun ne uspijeva s Permission denied: TUN device.

Doctor izlaz:

✗ TUN permission:  Not available (run with sudo for TUN mode)

Rješenje: TUN način rada stvara virtualno mrežno sučelje, što zahtijeva povišene ovlasti:

# macOS/Linux
sudo freeguard connect --tun

# Windows — run PowerShell as Administrator
freeguard connect --tun

Ako vam ne treba pokrivenost VPN-om na razini sustava, koristite zadani način rada sistemskog proxyja (sudo nije potreban):

freeguard connect

Port ispod 1024 zahtijeva povišene ovlasti

Simptom: Postavljanje proxy porta ispod 1024 ne uspijeva s Permission denied.

Rješenje: Portovi ispod 1024 su ograničeni na većini operativnih sustava. Koristite port iznad 1024:

freeguard config set proxy.port 7890

Ili pokrenite s povišenim ovlastima ako vam konkretno treba niski port:

sudo freeguard connect

Još uvijek zaglavili?

Ako freeguard doctor i gornja rješenja ne riješe vaš problem, pustite AI da ga automatski dijagnosticira.

Posjetite stranicu FreeGuard CLI Agent i opišite svoj problem. Agent može pročitati vaš freeguard doctor --json izlaz i voditi vas korak po korak do rješenja.

Možete pokrenuti i interaktivni čarobnjak za rješavanje problema:

freeguard doctor --json | pbcopy
# Then paste the output into the CLI Agent chat

Često postavljana pitanja

Zašto FreeGuard CLI kaže “connection refused”?

To obično znači da je VPN server privremeno nedostupan. Pokušajte freeguard connect --server auto za automatski odabir najboljeg dostupnog servera ili provjerite postavke vatrozida.

Kako provjeriti radi li moja VPN veza?

Pokrenite freeguard status da vidite stanje veze, trenutni server i protokol. Također možete pokrenuti curl ifconfig.me da provjerite je li se vaša IP adresa promijenila.

FreeGuard CLI se ne pokreće nakon ažuriranja sustava. Što učiniti?

Pokrenite freeguard update za najnoviju verziju. Ako to ne uspije, ponovno instalirajte instalacijskom skriptom: curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sh.

Kako prijaviti grešku ili dobiti pomoć?

Pokrenite freeguard debug za prikupljanje dijagnostičkih informacija, zatim kontaktirajte podršku putem web stranice ili e-maila. Uključite debug izlaz za brže rješavanje.

Zadnje ažuriranje: ožujak 2026.