การแก้ไขปัญหา FreeGuard CLI

พบปัญหากับ FreeGuard CLI หรือไม่? คู่มือนี้ครอบคลุมปัญหาที่พบบ่อยที่สุดและวิธีแก้ไข สำหรับทุกปัญหา ให้ลองรัน freeguard doctor ก่อน — มันจะตรวจจับปัญหาด้านการกำหนดค่าและสภาพแวดล้อมส่วนใหญ่โดยอัตโนมัติ

ปัญหาการติดตั้ง

ถูกปฏิเสธสิทธิ์ระหว่างการติดตั้ง

อาการ: สคริปต์การติดตั้งล้มเหลวด้วย Permission denied หรือ EACCES

วิธีแก้ไข: บน macOS/Linux ตัวติดตั้งต้องการสิทธิ์การเขียนไปยัง /usr/local/bin รันด้วยสิทธิ์ระดับสูง:

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

บน Windows ให้แน่ใจว่าเปิด PowerShell ในฐานะผู้ดูแลระบบก่อนรันคำสั่งติดตั้ง

ไม่พบคำสั่งหลังการติดตั้ง

อาการ: การรัน freeguard คืนค่า command not found หรือ not recognized

ผลลัพธ์ Doctor:

✗ CLI binary:     Not in PATH

วิธีแก้ไข: ไฟล์ไบนารีอาจไม่อยู่ใน PATH ของเชลล์คุณ เพิ่มด้วยตนเอง:

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

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

บน Windows ให้เพิ่ม %USERPROFILE%\.freeguard\bin ลงในตัวแปรสภาพแวดล้อม PATH ของระบบและรีสตาร์ทเทอร์มินัล

curl ล้มเหลวหรือการดาวน์โหลดหมดเวลา

อาการ: สคริปต์การติดตั้งไม่สามารถดาวน์โหลดไฟล์ไบนารี

วิธีแก้ไข: หากคุณอยู่หลังไฟร์วอลล์ขององค์กรหรือในเครือข่ายที่ถูกจำกัด ให้ดาวน์โหลดไฟล์ไบนารีด้วยตนเองจากหน้า Releases บน GitHub และวางใน ~/.freeguard/bin/ จากนั้นทำให้มันสามารถเรียกใช้งานได้:

chmod +x ~/.freeguard/bin/freeguard

ปัญหาการเข้าสู่ระบบ

ไม่ได้รับรหัสยืนยัน

อาการ: หลังจากรัน freeguard login --email [email protected] --send-code ไม่มีอีเมลเข้ามา

วิธีแก้ไข:

1. ตรวจสอบโฟลเดอร์สแปม/อีเมลขยะ — อีเมลยืนยันบางครั้งถูกกรอง
2. รอ 2 นาทีก่อนขอใหม่ มีขีดจำกัดอัตราการส่งรหัส
3. ตรวจสอบว่าที่อยู่อีเมลถูกต้อง:

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

4. ลองใช้ผู้ให้บริการอีเมลอื่นหากปัญหายังคงอยู่

โทเค็นหมดอายุ

อาการ: คำสั่งล้มเหลวด้วย Authentication expired หรือ Token invalid

ผลลัพธ์ Doctor:

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

วิธีแก้ไข: เข้าสู่ระบบอีกครั้งเพื่อรีเฟรชข้อมูลรับรอง:

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

อีเมลผิด — ไม่พบการสมัครสมาชิก

อาการ: เข้าสู่ระบบสำเร็จแต่ freeguard connect แจ้ง No active subscription

ผลลัพธ์ Doctor:

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

วิธีแก้ไข: ตรวจสอบว่าคุณเข้าสู่ระบบด้วยอีเมลเดียวกันกับที่ใช้ซื้อการสมัครสมาชิก หากคุณใช้อีเมลอื่น:

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

ปัญหาการเชื่อมต่อ

การเชื่อมต่อหมดเวลา

อาการ: freeguard connect ค้างหรือคืนค่า Connection timed out

ผลลัพธ์ Doctor:

✗ Network:         Internet not reachable

วิธีแก้ไข:

1. ตรวจสอบการเชื่อมต่ออินเทอร์เน็ตพื้นฐาน (ตัดการเชื่อมต่อ VPN ก่อน):

freeguard disconnect
ping 8.8.8.8

2. ลองโหนดหรือประเทศอื่น:

freeguard connect --country SG

3. ลองโปรโตคอลอื่นที่อาจทำงานได้ดีกว่าในเครือข่ายของคุณ:

freeguard connect --protocol hysteria2

พอร์ต 7890 ถูกใช้งานอยู่แล้ว

อาการ: freeguard connect ล้มเหลวด้วย Port 7890 is already in use

ผลลัพธ์ Doctor:

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

วิธีแก้ไข: แอปพลิเคชัน proxy อื่นกำลังใช้พอร์ตเริ่มต้น หยุดแอปพลิเคชันอื่นหรือเปลี่ยนพอร์ต proxy ของ FreeGuard:

freeguard config set proxy.port 8080
freeguard connect

ตรวจพบการรั่วไหลของ DNS

อาการ: คิวรี DNS ข้าม VPN tunnel

วิธีแก้ไข: สลับไปใช้การกำหนดค่า DNS ที่ปลอดภัย:

freeguard config set dns.provider secure
freeguard disconnect
freeguard connect

คุณสามารถตรวจสอบว่า DNS ถูกส่งผ่าน VPN:

freeguard doctor

มองหาการตรวจสอบ DNS ในผลลัพธ์เพื่อยืนยันว่าทำงานถูกต้อง

ปัญหาสิทธิ์การเข้าถึง

โหมด TUN ต้องการ sudo

อาการ: freeguard connect --tun ล้มเหลวด้วย Permission denied: TUN device

ผลลัพธ์ Doctor:

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

วิธีแก้ไข: โหมด TUN สร้างอินเทอร์เฟซเครือข่ายเสมือนซึ่งต้องการสิทธิ์ระดับสูง:

# macOS/Linux
sudo freeguard connect --tun

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

หากคุณไม่ต้องการ VPN ครอบคลุมทั้งระบบ ให้ใช้โหมด proxy ระบบเริ่มต้น (ไม่ต้องใช้ sudo):

freeguard connect

พอร์ตต่ำกว่า 1024 ต้องการสิทธิ์ระดับสูง

อาการ: การตั้งค่าพอร์ต proxy ต่ำกว่า 1024 ล้มเหลวด้วย Permission denied

วิธีแก้ไข: พอร์ตต่ำกว่า 1024 ถูกจำกัดในระบบปฏิบัติการส่วนใหญ่ ใช้พอร์ตสูงกว่า 1024:

freeguard config set proxy.port 7890

หรือรันด้วยสิทธิ์ระดับสูงหากคุณต้องการพอร์ตต่ำโดยเฉพาะ:

sudo freeguard connect

ยังแก้ไม่ได้?

หาก freeguard doctor และวิธีแก้ไขข้างต้นไม่สามารถแก้ปัญหาของคุณได้ ให้ AI วินิจฉัยโดยอัตโนมัติ

เยี่ยมชมหน้า FreeGuard CLI Agent และอธิบายปัญหาของคุณ ตัวแทนสามารถอ่านผลลัพธ์ freeguard doctor --json และแนะนำคุณทีละขั้นตอนสู่การแก้ไข

คุณยังสามารถรันตัวช่วยแก้ไขปัญหาแบบโต้ตอบ:

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

คำถามที่พบบ่อย

ทำไม FreeGuard CLI ถึงแจ้ง “connection refused”?

โดยปกติหมายความว่าเซิร์ฟเวอร์ VPN ไม่พร้อมใช้งานชั่วคราว ลอง freeguard connect --server auto เพื่อเลือกเซิร์ฟเวอร์ที่ดีที่สุดโดยอัตโนมัติ หรือตรวจสอบการตั้งค่าไฟร์วอลล์

ฉันจะตรวจสอบได้อย่างไรว่าการเชื่อมต่อ VPN ใช้งานได้?

รัน freeguard status เพื่อดูสถานะการเชื่อมต่อ เซิร์ฟเวอร์ปัจจุบัน และโปรโตคอล คุณยังสามารถรัน curl ifconfig.me เพื่อตรวจสอบว่า IP ของคุณเปลี่ยนแล้ว

FreeGuard CLI ไม่เริ่มทำงานหลังอัปเดตระบบ ควรทำอย่างไร?

รัน freeguard update เพื่อรับเวอร์ชันล่าสุด หากล้มเหลว ให้ติดตั้งใหม่ด้วยสคริปต์ติดตั้ง: curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sh

ฉันจะรายงานข้อผิดพลาดหรือขอความช่วยเหลือได้อย่างไร?

รัน freeguard debug เพื่อรวบรวมข้อมูลการวินิจฉัย จากนั้นติดต่อฝ่ายสนับสนุนผ่านเว็บไซต์หรืออีเมล แนบผลลัพธ์ debug เพื่อการแก้ไขที่รวดเร็วยิ่งขึ้น

อัปเดตล่าสุด: มีนาคม 2026