Soluzzjoni tal-Problemi ta’ FreeGuard CLI

Qed tiltaqa’ ma’ problemi b’FreeGuard CLI? Din il-gwida tkopri l-problemi l-aktar komuni u s-soluzzjonijiet tagħhom. Għal kull problema, ipprova l-ewwel tħaddem freeguard doctor — jawtomatikament jiskopri l-biċċa l-kbira tal-problemi ta’ konfigurazzjoni u ambjent.

Problemi ta’ Installazzjoni

Permess miċħud waqt l-installazzjoni

Sintomu: L-iskript ta’ installazzjoni jfalli b’Permission denied jew EACCES.

Soluzzjoni: Fuq macOS/Linux, l-installer jeħtieġ aċċess għall-kitba f’/usr/local/bin. Ħaddmu b’privileġġi elevati:

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

Fuq Windows, kun ċert li tiftaħ PowerShell bħala Amministratur qabel ma tħaddem il-kmand ta’ installazzjoni.

Kmand ma nstabx wara l-installazzjoni

Sintomu: Meta tħaddem freeguard jirritorna command not found jew not recognized.

Output Doctor:

✗ CLI binary:     Not in PATH

Soluzzjoni: Il-fajl binarju jista’ ma jkunx fil-PATH tal-qoxra tiegħek. Żidu manwalment:

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

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

Fuq Windows, żid %USERPROFILE%\.freeguard\bin mal-varjabbli ambjentali PATH tas-sistema u erġa’ ibda t-terminal.

curl jfalli jew id-download jiskadi

Sintomu: L-iskript ta’ installazzjoni ma jistax iniżżel il-fajl binarju.

Soluzzjoni: Jekk qiegħed wara firewall korporattiv jew f’netwerk ristrett, niżżel il-fajl binarju manwalment mill-paġna tar-Rilaxxi GitHub u poġġih f’~/.freeguard/bin/. Imbagħad agħmlu eżegwibbli:

chmod +x ~/.freeguard/bin/freeguard

Problemi ta’ Login

Kodiċi ta’ verifika ma wasalx

Sintomu: Wara li tħaddem freeguard login --email [email protected] --send-code, l-ebda email ma jasal.

Soluzzjoni:

1. Iċċekkja l-folder ta’ spam/junk — l-emails ta’ verifika xi kultant jiġu ffiltrati.
2. Stenna 2 minuti qabel titlob mill-ġdid. Hemm limitu tar-rata fuq il-bagħt ta’ kodiċi.
3. Ivverifika li l-indirizz email huwa korrett:

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

4. Ipprova fornitur ta’ email differenti jekk il-problema tibqa’.

Token skadut

Sintomu: Il-kmandi jfallu b’Authentication expired jew Token invalid.

Output Doctor:

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

Soluzzjoni: Idħol mill-ġdid biex taġġorna l-kredenzjali tiegħek:

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

Email ħażin — abbonament ma nstabx

Sintomu: Il-login jirnexxilu imma freeguard connect jgħid No active subscription.

Output Doctor:

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

Soluzzjoni: Kun ċert li qed tidħol bl-istess email li użajt biex tixtri l-abbonament. Jekk użajt email differenti:

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

Problemi ta’ Konnessjoni

Konnessjoni tiskadi

Sintomu: freeguard connect jeħel jew jirritorna Connection timed out.

Output Doctor:

✗ Network:         Internet not reachable

Soluzzjoni:

1. Iċċekkja l-konnessjoni bażika tal-internet tiegħek (aqta’ l-VPN l-ewwel):

freeguard disconnect
ping 8.8.8.8

2. Ipprova nodu jew pajjiż differenti:

freeguard connect --country SG

3. Ipprova protokoll differenti li jista’ jaħdem aħjar fuq in-netwerk tiegħek:

freeguard connect --protocol hysteria2

Port 7890 diġà qed jintuża

Sintomu: freeguard connect jfalli b’Port 7890 is already in use.

Output Doctor:

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

Soluzzjoni: Applikazzjoni proxy oħra qed tuża l-port default. Jew waqqaf l-applikazzjoni l-oħra, jew ibdel il-port proxy ta’ FreeGuard:

freeguard config set proxy.port 8080
freeguard connect

Tnixxija ta’ DNS misjuba

Sintomu: Il-queries DNS jevitaw it-tunnel VPN.

Soluzzjoni: Aqleb għal konfigurazzjoni DNS sigura:

freeguard config set dns.provider secure
freeguard disconnect
freeguard connect

Tista’ tivverifika li d-DNS qed jiġi dirett permezz tal-VPN:

freeguard doctor

Fittex iċ-ċekkjar ta’ DNS fl-output biex tikkonferma li qed jaħdem sew.

Problemi ta’ Permess

Il-modalità TUN teħtieġ sudo

Sintomu: freeguard connect --tun jfalli b’Permission denied: TUN device.

Output Doctor:

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

Soluzzjoni: Il-modalità TUN toħloq interface tan-netwerk virtwali, li teħtieġ privileġġi elevati:

# macOS/Linux
sudo freeguard connect --tun

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

Jekk m’għandekx bżonn kopertura VPN tas-sistema kollha, uża l-modalità proxy tas-sistema default (sudo mhux meħtieġ):

freeguard connect

Port taħt 1024 jeħtieġ privileġġi elevati

Sintomu: L-issettjar ta’ port proxy taħt 1024 jfalli b’Permission denied.

Soluzzjoni: Il-ports taħt 1024 huma ristretti fuq il-biċċa l-kbira tas-sistemi operattivi. Uża port fuq 1024:

freeguard config set proxy.port 7890

Jew ħaddmu b’privileġġi elevati jekk speċifikament teħtieġ port baxx:

sudo freeguard connect

Għadek mgħarraq?

Jekk freeguard doctor u s-soluzzjonijiet ta’ hawn fuq ma jsolvux il-problema tiegħek, ħalli l-AI jiddijanjostikaha awtomatikament.

Żur il-paġna FreeGuard CLI Agent u iddeskrivi l-problema tiegħek. L-aġent jista’ jaqra l-output ta’ freeguard doctor --json u jmexxik pass pass lejn soluzzjoni.

Tista’ wkoll tħaddem il-wizard interattiv ta’ soluzzjoni tal-problemi:

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

Mistoqsijiet Frekwenti

Għaliex FreeGuard CLI jgħid “connection refused”?

Dan normalment ifisser li s-server VPN temporanjament mhux disponibbli. Ipprova freeguard connect --server auto biex awtomatikament tagħżel l-aħjar server disponibbli, jew iċċekkja s-settings tal-firewall tiegħek.

Kif niċċekkja jekk il-konnessjoni VPN tiegħi qed taħdem?

Ħaddem freeguard status biex tara l-istat tal-konnessjoni, is-server kurrenti, u l-protokoll. Tista’ wkoll tħaddem curl ifconfig.me biex tivverifika li l-indirizz IP tiegħek inbidel.

FreeGuard CLI ma jibdiex wara aġġornament tas-sistema. X’għandi nagħmel?

Ħaddem freeguard update biex tikseb l-aħħar verżjoni. Jekk dan jfalli, erġa’ installa bl-iskript ta’ installazzjoni: curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sh.

Kif nirrapporta bug jew nikseb għajnuna?

Ħaddem freeguard debug biex tiġbor informazzjoni dijanjostika, imbagħad ikkuntattja s-support permezz tal-websajt jew email.Inkludi l-output tad-debug għal riżoluzzjoni aktar mgħaġġla.

Aġġornat l-aħħar: Marzu 2026