Utatuzi wa Matatizo ya FreeGuard CLI

Una matatizo na FreeGuard CLI? Mwongozo huu unashughulikia matatizo ya kawaida zaidi na masuluhisho yake. Kwa kila tatizo, jaribu kwanza kuendesha freeguard doctor — inagundua kiotomatiki matatizo mengi ya usanidi na mazingira.

Matatizo ya Usakinishaji

Ruhusa imekataliwa wakati wa usakinishaji

Dalili: Skripti ya usakinishaji inashindwa na Permission denied au EACCES.

Suluhisho: Kwenye macOS/Linux, kisakinishi kinahitaji ufikiaji wa kuandika kwenye /usr/local/bin. Endesha kwa mamlaka ya juu:

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

Kwenye Windows, hakikisha unafungua PowerShell kama Msimamizi kabla ya kuendesha amri ya usakinishaji.

Amri haipatikani baada ya usakinishaji

Dalili: Kuendesha freeguard kunarudisha command not found au not recognized.

Matokeo ya Doctor:

✗ CLI binary:     Not in PATH

Suluhisho: Faili ya binary huenda haiko kwenye PATH ya shell yako. Iongeze kwa mkono:

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

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

Kwenye Windows, ongeza %USERPROFILE%\.freeguard\bin kwenye kigezo cha mazingira cha PATH ya mfumo na uanzishe upya terminal.

curl inashindwa au upakuaji unaisha muda

Dalili: Skripti ya usakinishaji haiwezi kupakua faili ya binary.

Suluhisho: Ikiwa uko nyuma ya firewall ya shirika au kwenye mtandao uliozuiliwa, pakua faili ya binary kwa mkono kutoka ukurasa wa Matoleo ya GitHub na uiweke kwenye ~/.freeguard/bin/. Kisha ifanye iweze kutekelezwa:

chmod +x ~/.freeguard/bin/freeguard

Matatizo ya Kuingia

Nambari ya uthibitisho haikupokelewa

Dalili: Baada ya kuendesha freeguard login --email [email protected] --send-code, hakuna barua pepe inayofika.

Suluhisho:

Angalia folda yako ya barua taka/spam — barua pepe za uthibitisho wakati mwingine huchujwa.
Subiri dakika 2 kabla ya kuomba tena. Kuna kikomo cha kasi ya kutuma nambari.
Thibitisha kuwa anwani ya barua pepe ni sahihi:

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

Jaribu mtoa huduma tofauti wa barua pepe ikiwa tatizo linaendelea.

Tokeni imeisha muda

Dalili: Amri zinashindwa na Authentication expired au Token invalid.

Matokeo ya Doctor:

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

Suluhisho: Ingia tena ili kusasisha stakabadhi zako:

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

Barua pepe isiyosahihi — usajili haujapatikana

Dalili: Kuingia kunafanikiwa lakini freeguard connect inasema No active subscription.

Matokeo ya Doctor:

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

Suluhisho: Hakikisha unaingia na barua pepe sawa uliyotumia kununua usajili wako. Ikiwa ulitumia barua pepe tofauti:

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

Matatizo ya Muunganisho

Muunganisho umeisha muda

Dalili: freeguard connect inasimama au kurudisha Connection timed out.

Matokeo ya Doctor:

✗ Network:         Internet not reachable

Suluhisho:

Angalia muunganisho wako wa msingi wa intaneti (kata VPN kwanza):

freeguard disconnect
ping 8.8.8.8

Jaribu nodi au nchi tofauti:

freeguard connect --country SG

Jaribu itifaki tofauti ambayo inaweza kufanya kazi vizuri zaidi kwenye mtandao wako:

freeguard connect --protocol hysteria2

Bandari 7890 tayari inatumika

Dalili: freeguard connect inashindwa na Port 7890 is already in use.

Matokeo ya Doctor:

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

Suluhisho: Programu nyingine ya proxy inatumia bandari ya chaguo-msingi. Ama simamisha programu nyingine, au ubadilishe bandari ya proxy ya FreeGuard:

freeguard config set proxy.port 8080
freeguard connect

Uvujaji wa DNS umegunduliwa

Dalili: Maombi ya DNS yanapita njia ya mkato ya handaki la VPN.

Suluhisho: Badili kwa usanidi wa DNS salama:

freeguard config set dns.provider secure
freeguard disconnect
freeguard connect

Unaweza kuthibitisha kuwa DNS inaelekezwa kupitia VPN:

freeguard doctor

Tafuta ukaguzi wa DNS kwenye matokeo ili kuthibitisha kuwa inafanya kazi vizuri.

Matatizo ya Ruhusa

Hali ya TUN inahitaji sudo

Dalili: freeguard connect --tun inashindwa na Permission denied: TUN device.

Matokeo ya Doctor:

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

Suluhisho: Hali ya TUN inaunda kiolesura cha mtandao pepe, ambacho kinahitaji mamlaka ya juu:

# macOS/Linux
sudo freeguard connect --tun

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

Ikiwa huhitaji chanjo ya VPN ya mfumo mzima, tumia hali ya proxy ya mfumo ya chaguo-msingi (sudo haihitajiki):

freeguard connect

Bandari chini ya 1024 inahitaji mamlaka ya juu

Dalili: Kuweka bandari ya proxy chini ya 1024 kunashindwa na Permission denied.

Suluhisho: Bandari chini ya 1024 zimezuiliwa kwenye mifumo mingi ya uendeshaji. Tumia bandari juu ya 1024:

freeguard config set proxy.port 7890

Au endesha kwa mamlaka ya juu ikiwa unahitaji hasa bandari ya chini:

sudo freeguard connect

Bado umekwama?

Ikiwa freeguard doctor na masuluhisho hapo juu hayatatui tatizo lako, acha AI igundue kiotomatiki.

Tembelea ukurasa wa FreeGuard CLI Agent na ueleze tatizo lako. Wakala anaweza kusoma matokeo ya freeguard doctor --json na kukuongoza hatua kwa hatua kuelekea suluhisho.

Unaweza pia kuendesha mchawi wa utatuzi wa matatizo wa maingiliano:

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

Maswali Yanayoulizwa Mara kwa Mara

Kwa nini FreeGuard CLI inasema “connection refused”?

Hii kwa kawaida inamaanisha kuwa seva ya VPN haipatikani kwa muda. Jaribu freeguard connect --server auto ili kuchagua kiotomatiki seva bora inayopatikana, au angalia mipangilio yako ya firewall.

Ninajuaje kama muunganisho wangu wa VPN unafanya kazi?

Endesha freeguard status kuona hali ya muunganisho, seva ya sasa, na itifaki. Unaweza pia kuendesha curl ifconfig.me kuthibitisha kuwa anwani yako ya IP imebadilika.

FreeGuard CLI haianzishi baada ya sasisho la mfumo. Nifanye nini?

Endesha freeguard update kupata toleo la hivi karibuni. Ikiwa hilo halishindikani, sakinisha upya na skripti ya usakinishaji: curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sh.

Ninawezaje kuripoti hitilafu au kupata msaada?

Endesha freeguard debug kukusanya taarifa za uchunguzi, kisha wasiliana na msaada kupitia tovuti au barua pepe. Jumuisha matokeo ya debug kwa utatuzi wa haraka zaidi.

Ilisasishwa mwisho: Machi 2026