FreeGuard VPN
Trang chủCác nút VPNGiá cả
Khắc phục sự cố FreeGuard CLI
Bạn đang gặp vấn đề với FreeGuard CLI? Hướng dẫn này bao gồm các vấn đề phổ biến nhất và cách giải quyết. Đối với mọi vấn đề, hãy thử chạy `freeguard doctor` trước — nó tự động phát hiện hầu hết các vấn đề về cấu hình và môi trường.
Mục lục

Khắc phục sự cố FreeGuard CLI

Bạn đang gặp vấn đề với FreeGuard CLI? Hướng dẫn này bao gồm các vấn đề phổ biến nhất và cách giải quyết. Đối với mọi vấn đề, hãy thử chạy freeguard doctor trước — nó tự động phát hiện hầu hết các vấn đề về cấu hình và môi trường.

Vấn đề cài đặt

Bị từ chối quyền khi cài đặt

Triệu chứng: Script cài đặt thất bại với Permission denied hoặc EACCES.

Giải pháp: Trên macOS/Linux, trình cài đặt cần quyền ghi vào /usr/local/bin. Chạy với quyền nâng cao:

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

Trên Windows, hãy đảm bảo mở PowerShell với quyền Quản trị viên trước khi chạy lệnh cài đặt.

Không tìm thấy lệnh sau khi cài đặt

Triệu chứng: Chạy freeguard trả về command not found hoặc not recognized.

Kết quả Doctor:

✗ CLI binary:     Not in PATH

Giải pháp: File nhị phân có thể không nằm trong PATH của shell. Thêm thủ công:

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

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

Trên Windows, thêm %USERPROFILE%\.freeguard\bin vào biến môi trường PATH hệ thống và khởi động lại terminal.

curl thất bại hoặc tải xuống hết thời gian

Triệu chứng: Script cài đặt không thể tải xuống file nhị phân.

Giải pháp: Nếu bạn đang ở sau tường lửa doanh nghiệp hoặc trong mạng bị hạn chế, hãy tải file nhị phân thủ công từ trang Releases trên GitHub và đặt vào ~/.freeguard/bin/. Sau đó làm cho nó có thể thực thi:

chmod +x ~/.freeguard/bin/freeguard

Vấn đề đăng nhập

Không nhận được mã xác minh

Triệu chứng: Sau khi chạy freeguard login --email [email protected] --send-code, không có email nào đến.

Giải pháp:

  1. Kiểm tra thư mục spam/rác — email xác minh đôi khi bị lọc.
  2. Đợi 2 phút trước khi yêu cầu lại. Có giới hạn tốc độ gửi mã.
  3. Xác nhận địa chỉ email chính xác:
freeguard login --email [email protected] --send-code
  1. Thử nhà cung cấp email khác nếu vấn đề vẫn tiếp tục.

Token hết hạn

Triệu chứng: Các lệnh thất bại với Authentication expired hoặc Token invalid.

Kết quả Doctor:

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

Giải pháp: Đăng nhập lại để làm mới thông tin xác thực:

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

Email sai — không tìm thấy gói đăng ký

Triệu chứng: Đăng nhập thành công nhưng freeguard connect báo No active subscription.

Kết quả Doctor:

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

Giải pháp: Đảm bảo bạn đăng nhập bằng email đã dùng để mua gói đăng ký. Nếu bạn đã dùng email khác:

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

Vấn đề kết nối

Kết nối hết thời gian

Triệu chứng: freeguard connect bị treo hoặc trả về Connection timed out.

Kết quả Doctor:

✗ Network:         Internet not reachable

Giải pháp:

  1. Kiểm tra kết nối internet cơ bản (ngắt VPN trước):
freeguard disconnect
ping 8.8.8.8
  1. Thử node hoặc quốc gia khác:
freeguard connect --country SG
  1. Thử giao thức khác có thể hoạt động tốt hơn trên mạng của bạn:
freeguard connect --protocol hysteria2

Cổng 7890 đã được sử dụng

Triệu chứng: freeguard connect thất bại với Port 7890 is already in use.

Kết quả Doctor:

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

Giải pháp: Một ứng dụng proxy khác đang sử dụng cổng mặc định. Dừng ứng dụng kia hoặc thay đổi cổng proxy của FreeGuard:

freeguard config set proxy.port 8080
freeguard connect

Phát hiện rò rỉ DNS

Triệu chứng: Truy vấn DNS bỏ qua đường hầm VPN.

Giải pháp: Chuyển sang cấu hình DNS an toàn:

freeguard config set dns.provider secure
freeguard disconnect
freeguard connect

Bạn có thể xác minh DNS đang được định tuyến qua VPN:

freeguard doctor

Tìm kiểm tra DNS trong kết quả để xác nhận hoạt động đúng.

Vấn đề quyền truy cập

Chế độ TUN yêu cầu sudo

Triệu chứng: freeguard connect --tun thất bại với Permission denied: TUN device.

Kết quả Doctor:

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

Giải pháp: Chế độ TUN tạo giao diện mạng ảo, yêu cầu quyền nâng cao:

# macOS/Linux
sudo freeguard connect --tun

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

Nếu bạn không cần VPN bao phủ toàn hệ thống, hãy sử dụng chế độ proxy hệ thống mặc định (không cần sudo):

freeguard connect

Cổng dưới 1024 yêu cầu quyền nâng cao

Triệu chứng: Đặt cổng proxy dưới 1024 thất bại với Permission denied.

Giải pháp: Các cổng dưới 1024 bị hạn chế trên hầu hết hệ điều hành. Sử dụng cổng trên 1024:

freeguard config set proxy.port 7890

Hoặc chạy với quyền nâng cao nếu bạn cần cổng thấp:

sudo freeguard connect

Vẫn bị kẹt?

Nếu freeguard doctor và các giải pháp trên không giải quyết được vấn đề, hãy để AI tự động chẩn đoán.

Truy cập trang FreeGuard CLI Agent và mô tả vấn đề của bạn. Agent có thể đọc kết quả freeguard doctor --json và hướng dẫn bạn từng bước đến giải pháp.

Bạn cũng có thể chạy trình hướng dẫn khắc phục sự cố tương tác:

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

Câu hỏi thường gặp

Tại sao FreeGuard CLI báo “connection refused”?

Điều này thường có nghĩa là máy chủ VPN tạm thời không khả dụng. Thử freeguard connect --server auto để tự động chọn máy chủ tốt nhất, hoặc kiểm tra cài đặt tường lửa.

Làm cách nào để kiểm tra kết nối VPN có hoạt động không?

Chạy freeguard status để xem trạng thái kết nối, máy chủ hiện tại và giao thức. Bạn cũng có thể chạy curl ifconfig.me để xác minh địa chỉ IP đã thay đổi.

FreeGuard CLI không khởi động sau khi cập nhật hệ thống. Phải làm gì?

Chạy freeguard update để lấy phiên bản mới nhất. Nếu thất bại, cài đặt lại bằng script cài đặt: curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sh.

Làm cách nào để báo lỗi hoặc nhận hỗ trợ?

Chạy freeguard debug để thu thập thông tin chẩn đoán, sau đó liên hệ hỗ trợ qua trang web hoặc email. Đính kèm kết quả debug để giải quyết nhanh hơn.

Cập nhật lần cuối: Tháng 3 năm 2026