FreeGuard for Linux: Command-Line VPN with Rules and GeoIP Routing

FreeGuard for Linux is a command-line client for servers and developers: custom routing rules, GeoIP region routing, JSON output and a systemd user service. Install it with one command on x86_64 or arm64.

FreeGuard برای لینوکس یک کلاینت خط فرمان است که برای سرورها و توسعه‌دهندگان ساخته شده است: ترافیک را با قوانین خودتان یا بر اساس منطقه با GeoIP مسیریابی کنید، با خروجی JSON آن را اسکریپت‌نویسی کنید و آن را به‌عنوان سرویس کاربری systemd اجرا کنید. آن را با یک فرمان روی x86_64 یا arm64 نصب کنید.

FreeGuard در لینوکس یک کلاینت خط فرمان است

یک باینری Go واحد که هستهٔ mihomo را برایتان راه‌اندازی می‌کند. برای استفاده از یک برنامهٔ گرافیکی، از FreeGuard برای Windows یا Mac استفاده کنید.

رابط خط فرمان freeguard ورود، انتخاب سرور، اتصال، قواعد مسیریابی و اجرای خودکار را از ترمینال مدیریت می‌کند. این یک باینری واحد Go برای Linux با معماری‌های x86_64 و arm64 است که هستهٔ mihomo را برای شما راه‌اندازی می‌کند؛ بنابراین، علاوه بر لپ‌تاپ‌های توسعه‌دهندگان، برای سرورها، کانتینرها و نصب‌های حداقلی هم مناسب است.

برنامه دسکتاپ لینوکس وجود ندارد. اگر رابط گرافیکی می‌خواهید، از برنامه FreeGuard برای ویندوز یا مک استفاده کنید.

مسیریابی ترافیک به روش دلخواه شما: قوانین و مسیریابی منطقه‌ای GeoIP

قوانین مسیریابی خودتان را بنویسید یا ترافیک یک منطقه را مستقیم ارسال کنید، سپس پس از اتصال، خلاصهٔ مسیریابی را بررسی کنید.

  • حالت قواعد به‌طور پیش‌فرض: قواعد مسیریابی تعیین می‌کنند کدام ترافیک از طریق VPN عبور کند و کدام مستقیم برود، و freeguard connect خلاصه‌ای ساده از مسیریابی چاپ می‌کند
  • قواعد سفارشی: freeguard rule add DOMAIN example.com DIRECT یک قاعده اضافه می‌کند؛ rule list، rule remove و rule import (از یک URL یا فایل) بقیه را مدیریت می‌کنند
  • مسیریابی منطقه‌ای GeoIP: freeguard config set geoip_region CN ترافیک یک منطقه، مانند CN یا JP، را مستقیم ارسال می‌کند و بقیه ترافیک از VPN عبور می‌کند
  • حالت TUN: freeguard connect --tun تمام ترافیک دستگاه را رهگیری می‌کند؛ بدون آن، FreeGuard یک پراکسی محلی ارائه می‌دهد که برنامه‌های شما می‌توانند از آن استفاده کنند

نصب FreeGuard روی لینوکس

سه روش نصب پشتیبانی‌شده: اسکریپت نصب ما، Homebrew یا GitHub Releases. مخازن رسمی apt، dnf یا pacman وجود ندارند.

اسکریپت نصب (توصیه‌شده):

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

نصب با Homebrew:

brew install planetlinkinc/tap/freeguardvpn

باینری مستقیم: نسخهٔ متناسب با معماری خود را از انتشارهای GitHub دانلود کنید.

ما بسته‌های .deb، .rpm یا Arch را از طریق مخازن توزیع‌ها منتشر نمی‌کنیم، بنابراین apt install freeguard، dnf install freeguard یا pacman -S freeguard وجود ندارد.

قابلیت‌های بیشتر CLI

  • پروتکل‌ها: anytls، hysteria2 و trojan؛ برای هر اتصال یکی را انتخاب کنید، برای مثال freeguard connect la2 anytls
  • انتخاب سرور: با نام مستعار freeguard connect la2 یا hk1، برای بهترین سرور آمریکا freeguard connect US، یا فقط freeguard connect برای استفادهٔ دوباره از آخرین سرور یا انتخاب بهترین سرور
  • راه‌اندازی خودکار: دستور freeguard autostart enable یک سرویس systemd کاربر در مسیر ~/.config/systemd/user/freeguard.service نصب می‌کند (نیازی به دیمن ریشه نیست)
  • عیب‌یابی: freeguard doctor محیط شما را بررسی می‌کند
  • وضعیت و پایش: freeguard status و freeguard monitor جزئیات زندهٔ اتصال را نشان می‌دهند
  • اسکریپت‌نویسی: برای دریافت خروجی قابل‌خواندن توسط اسکریپت‌ها و عامل‌های هوش مصنوعی، --json را به یک فرمان اضافه کنید

نحوه شروع کار

  1. مرحله ۱: دستور curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sh را اجرا کنید
  2. مرحله ۲: دستور freeguard init را اجرا کنید و با حساب FreeGuard خود وارد شوید
  3. مرحله ۳: دستور freeguard connect را اجرا کنید (یا freeguard connect la2 را برای سرور مشخصی اجرا کنید)

پرسش‌های متداول

آیا FreeGuard برنامه‌ای با رابط کاربری گرافیکی برای لینوکس دارد؟

خیر. FreeGuard برای لینوکس، کلاینت خط فرمان freeguard است. اگر رابط گرافیکی می‌خواهید، از برنامهٔ ویندوز یا مک استفاده کنید.

چطور فقط بخشی از ترافیک را در لینوکس از طریق VPN مسیریابی کنم؟

از قوانین مسیریابی یا مسیریابی بر اساس منطقهٔ GeoIP استفاده کنید. freeguard rule add دامنه‌ها یا محدوده‌های IP مشخصی را مستقیم یا از طریق VPN ارسال می‌کند، و freeguard config set geoip_region CN ترافیک یک منطقه را مستقیم ارسال می‌کند، در حالی که بقیهٔ ترافیک همچنان از VPN عبور می‌کند.

آیا رابط خط فرمان لینوکس رایگان است؟

نصب آن رایگان است. برای اتصال به اشتراک FreeGuard نیاز دارید؛ دستور freeguard subscribe list را اجرا کنید تا طرح‌ها را ببینید.

آیا می‌توانم FreeGuard را از مدیر بستهٔ توزیع خودم نصب کنم؟

از مخازن رسمی توزیع‌ها نمی‌توانید نصب کنید. از اسکریپت نصب ما (install.sh)، Homebrew یا یک فایل باینری از GitHub Releases استفاده کنید. ما بسته‌ای برای apt، dnf، pacman یا AUR منتشر نمی‌کنیم.

آیا CLI روی سرورهای بدون رابط گرافیکی و Docker کار می‌کند؟

بله. CLI یک فایل باینری مستقل Go است و هیچ وابستگی‌ای به رابط گرافیکی ندارد. این ابزار از طریق SSH، داخل کانتینرها و روی ایمیج‌های پایهٔ حداقلی اجرا می‌شود، به‌شرطی که کانتینر قابلیت‌های شبکهٔ لازم برای ایجاد یک دستگاه TUN را داشته باشد.

آیا می‌توانم FreeGuard را هنگام راه‌اندازی سیستم به‌طور خودکار اجرا کنم؟

بله. freeguard autostart enable یک سرویس کاربر systemd را در ~/.config/systemd/user/freeguard.service نصب می‌کند. این سرویس به‌عنوان کاربر شما اجرا می‌شود، نه به‌عنوان یک دیمون root.

چه معماری‌ها و توزیع‌هایی پشتیبانی می‌شوند؟

لینوکس با معماری‌های x86_64 و arm64. CLI یک باینری Go است که هستهٔ mihomo را برایتان راه‌اندازی می‌کند؛ بنابراین هر توزیع مدرنی با هسته‌ای نسبتاً جدید باید کار کند؛ ما عمدتاً روی اوبونتو و دبیان آزمایش می‌کنیم.

آیا CLI لینوکس از همان پروتکل‌های برنامه‌های دسکتاپ استفاده می‌کند؟

بله. anytls، hysteria2 و trojan همگی در CLI و روی همان هستهٔ mihomo که برنامه‌های Windows و Mac استفاده می‌کنند، کار می‌کنند.

چگونه CLI را حذف نصب کنم؟

اگر از اسکریپت نصب استفاده کردید، فایل اجرایی freeguard را از /usr/local/bin (یا ~/.local/bin) حذف کنید و ~/.freeguard را پاک کنید. با Homebrew، دستور brew uninstall freeguardvpn را اجرا کنید. اگر اجرای خودکار را فعال کرده‌اید، ابتدا دستور freeguard autostart disable را اجرا کنید.

آخرین تأیید: 2026-05-22