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-এ, আপনার সিস্টেম PATH এনভায়রনমেন্ট ভেরিয়েবলে %USERPROFILE%\.freeguard\bin যোগ করুন এবং টার্মিনাল রিস্টার্ট করুন।
curl ব্যর্থ হয় বা ডাউনলোড টাইম আউট হয়
লক্ষণ: ইনস্টল স্ক্রিপ্ট বাইনারি ডাউনলোড করতে পারে না।
সমাধান: আপনি যদি কর্পোরেট ফায়ারওয়ালের পিছনে থাকেন বা সীমাবদ্ধ নেটওয়ার্কে থাকেন, তাহলে GitHub Releases পৃষ্ঠা থেকে ম্যানুয়ালি বাইনারি ডাউনলোড করুন এবং ~/.freeguard/bin/-এ রাখুন। তারপর এটি এক্সিকিউটেবল করুন:
chmod +x ~/.freeguard/bin/freeguard
লগইন সমস্যা
যাচাইকরণ কোড পাওয়া যায়নি
লক্ষণ: freeguard login --email [email protected] --send-code চালানোর পর কোনো ইমেল আসে না।
সমাধান:
- আপনার স্প্যাম/জাঙ্ক ফোল্ডার পরীক্ষা করুন — যাচাইকরণ ইমেল কখনো কখনো ফিল্টার হয়ে যায়।
- আবার অনুরোধ করার আগে ২ মিনিট অপেক্ষা করুন। কোড পাঠানোর একটি রেট লিমিট আছে।
- ইমেল ঠিকানা সঠিক কিনা যাচাই করুন:
freeguard login --email [email protected] --send-code
- সমস্যা চলতে থাকলে একটি ভিন্ন ইমেল প্রদানকারী ব্যবহার করে দেখুন।
টোকেন মেয়াদোত্তীর্ণ
লক্ষণ: কমান্ড 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
সমাধান:
- আপনার মূল ইন্টারনেট সংযোগ পরীক্ষা করুন (প্রথমে VPN সংযোগ বিচ্ছিন্ন করুন):
freeguard disconnect
ping 8.8.8.8
- একটি ভিন্ন নোড বা দেশ চেষ্টা করুন:
freeguard connect --country SG
- আপনার নেটওয়ার্কে আরও ভালো কাজ করতে পারে এমন একটি ভিন্ন প্রোটোকল চেষ্টা করুন:
freeguard connect --protocol hysteria2
পোর্ট 7890 ইতিমধ্যে ব্যবহৃত
লক্ষণ: freeguard connect Port 7890 is already in use দিয়ে ব্যর্থ হয়।
Doctor আউটপুট:
✗ Port 7890: In use by another process (PID: 12345)
সমাধান: অন্য একটি proxy অ্যাপ্লিকেশন ডিফল্ট পোর্ট ব্যবহার করছে। হয় অন্য অ্যাপ্লিকেশন বন্ধ করুন, অথবা FreeGuard proxy পোর্ট পরিবর্তন করুন:
freeguard config set proxy.port 8080
freeguard connect
DNS লিক সনাক্ত হয়েছে
লক্ষণ: DNS কোয়েরি VPN টানেল বাইপাস করছে।
সমাধান: একটি নিরাপদ 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-এর নিচে পোর্টের জন্য উন্নত সুবিধা প্রয়োজন
লক্ষণ: 1024-এর নিচে proxy পোর্ট সেট করলে 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 চালান। আপনার IP ঠিকানা পরিবর্তিত হয়েছে কিনা যাচাই করতে curl ifconfig.me-ও চালাতে পারেন।
সিস্টেম আপডেটের পরে FreeGuard CLI চালু হচ্ছে না। কী করব?
সর্বশেষ সংস্করণ পেতে freeguard update চালান। যদি তা ব্যর্থ হয়, ইনস্টল স্ক্রিপ্ট দিয়ে পুনরায় ইনস্টল করুন: curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sh।
কীভাবে বাগ রিপোর্ট করব বা সাহায্য পাব?
ডায়াগনস্টিক তথ্য সংগ্রহ করতে freeguard debug চালান, তারপর ওয়েবসাইট বা ইমেলের মাধ্যমে সাপোর্টে যোগাযোগ করুন। দ্রুত সমাধানের জন্য ডিবাগ আউটপুট অন্তর্ভুক্ত করুন।
সর্বশেষ আপডেট: মার্চ ২০২৬