Pemecahan Masalah FreeGuard CLI
Mengalami masalah dengan FreeGuard CLI? Panduan ini mencakup masalah paling umum dan solusinya. Untuk setiap masalah, coba jalankan freeguard doctor terlebih dahulu — secara otomatis mendeteksi sebagian besar masalah konfigurasi dan lingkungan.
Masalah Instalasi
Izin ditolak saat instalasi
Gejala: Skrip instalasi gagal dengan Permission denied atau EACCES.
Solusi: Di macOS/Linux, penginstal memerlukan akses tulis ke /usr/local/bin. Jalankan dengan hak akses tinggi:
curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sudo sh
Di Windows, pastikan Anda membuka PowerShell sebagai Administrator sebelum menjalankan perintah instalasi.
Perintah tidak ditemukan setelah instalasi
Gejala: Menjalankan freeguard mengembalikan command not found atau not recognized.
Output Doctor:
✗ CLI binary: Not in PATH
Solusi: File biner mungkin tidak ada di 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
Di Windows, tambahkan %USERPROFILE%\.freeguard\bin ke variabel lingkungan PATH sistem Anda dan mulai ulang terminal.
curl gagal atau unduhan timeout
Gejala: Skrip instalasi tidak dapat mengunduh file biner.
Solusi: Jika Anda berada di belakang firewall perusahaan atau di jaringan terbatas, unduh file biner secara manual dari halaman Rilis GitHub dan letakkan di ~/.freeguard/bin/. Kemudian buat agar dapat dieksekusi:
chmod +x ~/.freeguard/bin/freeguard
Masalah Login
Kode verifikasi tidak diterima
Gejala: Setelah menjalankan freeguard login --email [email protected] --send-code, tidak ada email yang masuk.
Solusi:
- Periksa folder spam/sampah Anda — email verifikasi terkadang terfilter.
- Tunggu 2 menit sebelum meminta lagi. Ada batas laju pengiriman kode.
- Pastikan alamat email sudah benar:
freeguard login --email [email protected] --send-code
- Coba penyedia email yang berbeda jika masalah berlanjut.
Token kedaluwarsa
Gejala: Perintah gagal dengan Authentication expired atau Token invalid.
Output Doctor:
✗ Credentials: Token expired (last refresh: 2026-03-01)
Solusi: Login lagi untuk memperbarui kredensial Anda:
freeguard logout
freeguard login --email [email protected] --send-code
Email salah — langganan tidak ditemukan
Gejala: Login berhasil tetapi freeguard connect mengatakan No active subscription.
Output Doctor:
✓ Credentials: Logged in (email: u***@example.com)
✗ Subscription: No active subscription found
Solusi: Pastikan Anda login dengan email yang sama yang digunakan untuk membeli langganan. Jika Anda menggunakan email yang berbeda:
freeguard logout
freeguard login --email [email protected] --send-code
Masalah Koneksi
Koneksi timeout
Gejala: freeguard connect hang atau mengembalikan Connection timed out.
Output Doctor:
✗ Network: Internet not reachable
Solusi:
- Periksa koneksi internet dasar Anda (putuskan VPN terlebih dahulu):
freeguard disconnect
ping 8.8.8.8
- Coba node atau negara yang berbeda:
freeguard connect --country SG
- Coba protokol yang berbeda yang mungkin bekerja lebih baik di jaringan 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)
Solusi: Aplikasi proxy lain menggunakan port default. Hentikan aplikasi lain tersebut, atau ubah port proxy FreeGuard:
freeguard config set proxy.port 8080
freeguard connect
Kebocoran DNS terdeteksi
Gejala: Kueri DNS melewati tunnel VPN.
Solusi: Beralih ke konfigurasi DNS yang aman:
freeguard config set dns.provider secure
freeguard disconnect
freeguard connect
Anda dapat memverifikasi bahwa DNS dialihkan melalui VPN:
freeguard doctor
Cari pemeriksaan DNS di output untuk mengonfirmasi bahwa semuanya berfungsi dengan benar.
Masalah Izin
Mode 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)
Solusi: Mode TUN membuat antarmuka jaringan virtual, yang memerlukan hak akses tinggi:
# macOS/Linux
sudo freeguard connect --tun
# Windows — run PowerShell as Administrator
freeguard connect --tun
Jika Anda tidak memerlukan cakupan VPN di seluruh sistem, gunakan mode proxy sistem default (tidak perlu sudo):
freeguard connect
Port di bawah 1024 memerlukan hak akses tinggi
Gejala: Mengatur port proxy di bawah 1024 gagal dengan Permission denied.
Solusi: Port di bawah 1024 dibatasi di sebagian besar sistem operasi. Gunakan port di atas 1024:
freeguard config set proxy.port 7890
Atau jalankan dengan hak akses tinggi jika Anda secara khusus memerlukan port rendah:
sudo freeguard connect
Masih mengalami masalah?
Jika freeguard doctor dan solusi di atas tidak menyelesaikan masalah Anda, biarkan AI mendiagnosisnya secara otomatis.
Kunjungi halaman FreeGuard CLI Agent dan jelaskan masalah Anda. Agent dapat membaca output freeguard doctor --json Anda dan memandu Anda langkah demi langkah menuju solusi.
Anda juga dapat menjalankan wizard pemecahan masalah interaktif:
freeguard doctor --json | pbcopy
# Then paste the output into the CLI Agent chat
Pertanyaan yang Sering Diajukan
Mengapa FreeGuard CLI mengatakan “connection refused”?
Ini biasanya berarti server VPN untuk sementara tidak tersedia. Coba freeguard connect --server auto untuk memilih server terbaik yang tersedia secara otomatis, atau periksa pengaturan firewall Anda.
Bagaimana cara memeriksa apakah koneksi VPN saya berfungsi?
Jalankan freeguard status untuk melihat status koneksi, server saat ini, dan protokol. Anda juga dapat menjalankan curl ifconfig.me untuk memverifikasi bahwa alamat IP Anda telah berubah.
FreeGuard CLI tidak bisa dimulai setelah pembaruan sistem. Apa yang harus dilakukan?
Jalankan freeguard update untuk mendapatkan versi terbaru. Jika gagal, instal ulang dengan skrip instalasi: curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sh.
Bagaimana cara melaporkan bug atau mendapatkan bantuan?
Jalankan freeguard debug untuk mengumpulkan informasi diagnostik, lalu hubungi dukungan melalui situs web atau email. Sertakan output debug untuk penyelesaian yang lebih cepat.
Terakhir diperbarui: Maret 2026