FreeGuard VPN
AcasăNoduri VPNTarife
Depanare FreeGuard CLI
Ai probleme cu FreeGuard CLI? Acest ghid acoperă cele mai frecvente probleme și soluțiile lor. Pentru fiecare problemă, încearcă mai întâi să rulezi `freeguard doctor` — detectează automat majoritatea problemelor de configurare și mediu.
Cuprins

Depanare FreeGuard CLI

Ai probleme cu FreeGuard CLI? Acest ghid acoperă cele mai frecvente probleme și soluțiile lor. Pentru fiecare problemă, încearcă mai întâi să rulezi freeguard doctor — detectează automat majoritatea problemelor de configurare și mediu.

Probleme de instalare

Permisiune refuzată în timpul instalării

Simptom: Scriptul de instalare eșuează cu Permission denied sau EACCES.

Soluție: Pe macOS/Linux, instalatorul are nevoie de acces de scriere la /usr/local/bin. Rulează cu privilegii ridicate:

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

Pe Windows, asigură-te că deschizi PowerShell ca Administrator înainte de a rula comanda de instalare.

Comanda nu a fost găsită după instalare

Simptom: Rularea freeguard returnează command not found sau not recognized.

Ieșire Doctor:

✗ CLI binary:     Not in PATH

Soluție: Fișierul binar s-ar putea să nu fie în PATH-ul shell-ului tău. Adaugă-l manual:

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

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

Pe Windows, adaugă %USERPROFILE%\.freeguard\bin la variabila de mediu PATH a sistemului și repornește terminalul.

curl eșuează sau descărcarea expiră

Simptom: Scriptul de instalare nu poate descărca fișierul binar.

Soluție: Dacă ești în spatele unui firewall corporativ sau într-o rețea restricționată, descarcă fișierul binar manual de pe pagina de Release-uri GitHub și pune-l în ~/.freeguard/bin/. Apoi fă-l executabil:

chmod +x ~/.freeguard/bin/freeguard

Probleme de autentificare

Codul de verificare nu a fost primit

Simptom: După rularea freeguard login --email [email protected] --send-code, nu sosește niciun e-mail.

Soluție:

  1. Verifică folderul de spam/junk — e-mailurile de verificare sunt uneori filtrate.
  2. Așteaptă 2 minute înainte de a solicita din nou. Există o limită de rată pentru trimiterea codurilor.
  3. Verifică dacă adresa de e-mail este corectă:
freeguard login --email [email protected] --send-code
  1. Încearcă un furnizor de e-mail diferit dacă problema persistă.

Token expirat

Simptom: Comenzile eșuează cu Authentication expired sau Token invalid.

Ieșire Doctor:

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

Soluție: Autentifică-te din nou pentru a reîmprospăta credențialele:

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

E-mail greșit — abonament negăsit

Simptom: Autentificarea reușește, dar freeguard connect spune No active subscription.

Ieșire Doctor:

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

Soluție: Asigură-te că te autentifici cu același e-mail pe care l-ai folosit pentru a cumpăra abonamentul. Dacă ai folosit un e-mail diferit:

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

Probleme de conexiune

Expirarea conexiunii

Simptom: freeguard connect se blochează sau returnează Connection timed out.

Ieșire Doctor:

✗ Network:         Internet not reachable

Soluție:

  1. Verifică conexiunea de bază la internet (deconectează VPN-ul mai întâi):
freeguard disconnect
ping 8.8.8.8
  1. Încearcă un nod sau o țară diferită:
freeguard connect --country SG
  1. Încearcă un protocol diferit care ar putea funcționa mai bine în rețeaua ta:
freeguard connect --protocol hysteria2

Portul 7890 este deja în uz

Simptom: freeguard connect eșuează cu Port 7890 is already in use.

Ieșire Doctor:

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

Soluție: O altă aplicație proxy folosește portul implicit. Oprește cealaltă aplicație sau schimbă portul proxy al FreeGuard:

freeguard config set proxy.port 8080
freeguard connect

Scurgere DNS detectată

Simptom: Interogările DNS ocolesc tunelul VPN.

Soluție: Comută la o configurare DNS sigură:

freeguard config set dns.provider secure
freeguard disconnect
freeguard connect

Poți verifica dacă DNS-ul este rutat prin VPN:

freeguard doctor

Caută verificarea DNS în ieșire pentru a confirma că funcționează corect.

Probleme de permisiuni

Modul TUN necesită sudo

Simptom: freeguard connect --tun eșuează cu Permission denied: TUN device.

Ieșire Doctor:

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

Soluție: Modul TUN creează o interfață de rețea virtuală, care necesită privilegii ridicate:

# macOS/Linux
sudo freeguard connect --tun

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

Dacă nu ai nevoie de acoperire VPN la nivel de sistem, folosește modul proxy de sistem implicit (sudo nu este necesar):

freeguard connect

Port sub 1024 necesită privilegii ridicate

Simptom: Setarea unui port proxy sub 1024 eșuează cu Permission denied.

Soluție: Porturile sub 1024 sunt restricționate pe majoritatea sistemelor de operare. Folosește un port peste 1024:

freeguard config set proxy.port 7890

Sau rulează cu privilegii ridicate dacă ai nevoie în mod specific de un port mic:

sudo freeguard connect

Încă blocat?

Dacă freeguard doctor și soluțiile de mai sus nu rezolvă problema ta, lasă AI-ul să o diagnosticheze automat.

Vizitează pagina FreeGuard CLI Agent și descrie problema ta. Agentul poate citi ieșirea freeguard doctor --json și te poate ghida pas cu pas către o soluție.

Poți rula și asistentul interactiv de depanare:

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

Întrebări frecvente

De ce spune FreeGuard CLI “connection refused”?

Acest lucru înseamnă de obicei că serverul VPN este temporar indisponibil. Încearcă freeguard connect --server auto pentru a selecta automat cel mai bun server disponibil sau verifică setările firewall-ului.

Cum verific dacă conexiunea mea VPN funcționează?

Rulează freeguard status pentru a vedea starea conexiunii, serverul actual și protocolul. Poți rula și curl ifconfig.me pentru a verifica dacă adresa IP s-a schimbat.

FreeGuard CLI nu pornește după o actualizare de sistem. Ce fac?

Rulează freeguard update pentru a obține cea mai recentă versiune. Dacă eșuează, reinstalează cu scriptul de instalare: curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sh.

Cum raportez un bug sau obțin ajutor?

Rulează freeguard debug pentru a colecta informații de diagnosticare, apoi contactează suportul prin site-ul web sau e-mail. Include ieșirea de debug pentru o rezolvare mai rapidă.

Ultima actualizare: martie 2026