FreeGuard VPN
Laman UtamaNod VPNPenetapan Harga
Penyelesaian Masalah FreeGuard CLI
Menghadapi masalah dengan FreeGuard CLI? Panduan ini merangkumi masalah yang paling biasa dan penyelesaiannya. Untuk setiap masalah, cuba jalankan `freeguard doctor` dahulu — ia mengesan kebanyakan masalah konfigurasi dan persekitaran secara automatik.
Kandungan

Penyelesaian Masalah FreeGuard CLI

Menghadapi masalah dengan FreeGuard CLI? Panduan ini merangkumi masalah yang paling biasa dan penyelesaiannya. Untuk setiap masalah, cuba jalankan freeguard doctor dahulu — ia mengesan kebanyakan masalah konfigurasi dan persekitaran secara automatik.

Masalah Pemasangan

Kebenaran ditolak semasa pemasangan

Gejala: Skrip pemasangan gagal dengan Permission denied atau EACCES.

Penyelesaian: Pada macOS/Linux, pemasang memerlukan akses tulis ke /usr/local/bin. Jalankan dengan keistimewaan tinggi:

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

Pada Windows, pastikan anda membuka PowerShell sebagai Pentadbir sebelum menjalankan arahan pemasangan.

Arahan tidak ditemui selepas pemasangan

Gejala: Menjalankan freeguard mengembalikan command not found atau not recognized.

Output Doctor:

✗ CLI binary:     Not in PATH

Penyelesaian: Fail binari mungkin tidak berada dalam PATH shell anda. Tambahkan secara manual:

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

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

Pada Windows, tambahkan %USERPROFILE%\.freeguard\bin ke pemboleh ubah persekitaran PATH sistem anda dan mulakan semula terminal.

curl gagal atau muat turun tamat masa

Gejala: Skrip pemasangan tidak dapat memuat turun fail binari.

Penyelesaian: Jika anda berada di belakang tembok api korporat atau dalam rangkaian terhad, muat turun fail binari secara manual dari halaman Keluaran GitHub dan letakkan di ~/.freeguard/bin/. Kemudian jadikan ia boleh dilaksanakan:

chmod +x ~/.freeguard/bin/freeguard

Masalah Log Masuk

Kod pengesahan tidak diterima

Gejala: Selepas menjalankan freeguard login --email [email protected] --send-code, tiada e-mel yang tiba.

Penyelesaian:

  1. Periksa folder spam/sampah anda — e-mel pengesahan kadangkala ditapis.
  2. Tunggu 2 minit sebelum meminta semula. Terdapat had kadar penghantaran kod.
  3. Sahkan alamat e-mel adalah betul:
freeguard login --email [email protected] --send-code
  1. Cuba pembekal e-mel yang berbeza jika masalah berterusan.

Token tamat tempoh

Gejala: Arahan gagal dengan Authentication expired atau Token invalid.

Output Doctor:

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

Penyelesaian: Log masuk semula untuk memuat semula kelayakan anda:

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

E-mel salah — langganan tidak ditemui

Gejala: Log masuk berjaya tetapi freeguard connect mengatakan No active subscription.

Output Doctor:

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

Penyelesaian: Pastikan anda log masuk dengan e-mel yang sama yang digunakan untuk membeli langganan. Jika anda menggunakan e-mel yang berbeza:

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

Masalah Sambungan

Sambungan tamat masa

Gejala: freeguard connect tergantung atau mengembalikan Connection timed out.

Output Doctor:

✗ Network:         Internet not reachable

Penyelesaian:

  1. Periksa sambungan internet asas anda (putuskan sambungan VPN dahulu):
freeguard disconnect
ping 8.8.8.8
  1. Cuba nod atau negara yang berbeza:
freeguard connect --country SG
  1. Cuba protokol yang berbeza yang mungkin berfungsi lebih baik pada rangkaian anda:
freeguard connect --protocol hysteria2

Port 7890 sudah digunakan

Gejala: freeguard connect gagal dengan Port 7890 is already in use.

Output Doctor:

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

Penyelesaian: Aplikasi proxy lain menggunakan port lalai. Sama ada hentikan aplikasi lain tersebut, atau tukar port proxy FreeGuard:

freeguard config set proxy.port 8080
freeguard connect

Kebocoran DNS dikesan

Gejala: Pertanyaan DNS memintas terowong VPN.

Penyelesaian: Tukar kepada konfigurasi DNS yang selamat:

freeguard config set dns.provider secure
freeguard disconnect
freeguard connect

Anda boleh mengesahkan bahawa DNS dialihkan melalui VPN:

freeguard doctor

Cari semakan DNS dalam output untuk mengesahkan ia berfungsi dengan betul.

Masalah Kebenaran

Mod TUN memerlukan sudo

Gejala: freeguard connect --tun gagal dengan Permission denied: TUN device.

Output Doctor:

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

Penyelesaian: Mod TUN mencipta antara muka rangkaian maya, yang memerlukan keistimewaan tinggi:

# macOS/Linux
sudo freeguard connect --tun

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

Jika anda tidak memerlukan liputan VPN seluruh sistem, gunakan mod proxy sistem lalai (sudo tidak diperlukan):

freeguard connect

Port di bawah 1024 memerlukan keistimewaan tinggi

Gejala: Menetapkan port proxy di bawah 1024 gagal dengan Permission denied.

Penyelesaian: Port di bawah 1024 dihadkan pada kebanyakan sistem pengendalian. Gunakan port di atas 1024:

freeguard config set proxy.port 7890

Atau jalankan dengan keistimewaan tinggi jika anda secara khusus memerlukan port rendah:

sudo freeguard connect

Masih menghadapi masalah?

Jika freeguard doctor dan penyelesaian di atas tidak menyelesaikan masalah anda, biarkan AI mendiagnosisnya secara automatik.

Layari halaman FreeGuard CLI Agent dan huraikan masalah anda. Ejen boleh membaca output freeguard doctor --json anda dan membimbing anda langkah demi langkah ke arah penyelesaian.

Anda juga boleh menjalankan wizard penyelesaian masalah interaktif:

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

Soalan Lazim

Mengapa FreeGuard CLI mengatakan “connection refused”?

Ini biasanya bermakna pelayan VPN tidak tersedia buat sementara waktu. Cuba freeguard connect --server auto untuk memilih pelayan terbaik yang tersedia secara automatik, atau periksa tetapan tembok api anda.

Bagaimana untuk memeriksa sama ada sambungan VPN saya berfungsi?

Jalankan freeguard status untuk melihat status sambungan, pelayan semasa, dan protokol. Anda juga boleh menjalankan curl ifconfig.me untuk mengesahkan alamat IP anda telah berubah.

FreeGuard CLI tidak bermula selepas kemas kini sistem. Apa yang perlu dilakukan?

Jalankan freeguard update untuk mendapatkan versi terkini. Jika gagal, pasang semula dengan skrip pemasangan: curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sh.

Bagaimana untuk melaporkan pepijat atau mendapatkan bantuan?

Jalankan freeguard debug untuk mengumpul maklumat diagnostik, kemudian hubungi sokongan melalui laman web atau e-mel. Sertakan output debug untuk penyelesaian yang lebih cepat.

Kemas kini terakhir: Mac 2026