PandaVPN CLI FAQs

Panda CLI, Panda का कमांड-लाइन क्लाइंट है और टर्मिनल के माध्यम से निम्न कार्यों का समर्थन करता है:

• लॉगिन और खाता प्रबंधन
• नोड रीफ़्रेश और नोड कनेक्शन
• PandaVPN / Proxy / WireGuard / Auto मोड के बीच स्विच करना
• सिस्टम प्रॉक्सी कॉन्फ़िगरेशन
• ट्रैफ़िक विभाजन के लिए Split rules
• Split DNS कॉन्फ़िगरेशन
• Kill-switch सुरक्षा
• Auto-connect
• लॉग और डायग्नोस्टिक्स

यह आंतरिक बीटा उपयोगकर्ताओं, डेवलपर्स, उन्नत उपयोगकर्ताओं और ऐसे परीक्षण परिदृश्यों के लिए उपयुक्त है जिनमें स्क्रिप्टेड ऑपरेशन की आवश्यकता होती है।

Panda CLI कमांड लाइन के माध्यम से संचालित होता है और इनके लिए अधिक उपयुक्त है:

• स्वचालित परीक्षण
• दूरस्थ समस्या-निवारण
• स्क्रिप्टेड कनेक्शन
• विस्तृत डायग्नोस्टिक जानकारी देखना
• Kill-switch, DNS, रूटिंग और सिस्टम प्रॉक्सी जैसे लो-लेवल व्यवहारों का सत्यापन

डेस्कटॉप क्लाइंट सामान्य उपयोगकर्ताओं के दैनिक ग्राफ़िकल संचालन के लिए अधिक उपयुक्त है।

ध्यान दें: पुराने Qt डेस्कटॉप क्लाइंट और CLI को एक ही समय में VPN / सिस्टम प्रॉक्सी प्रबंधित करने की अनुशंसा नहीं की जाती, ताकि वे एक-दूसरे की कॉन्फ़िगरेशन को ओवरराइट न करें।

कुछ क्षमताओं के लिए सिस्टम-स्तरीय अनुमतियों की आवश्यकता होती है, जैसे:

• TUN / WireGuard नेटवर्क इंटरफ़ेस बनाना
• DNS संशोधित करना
• सिस्टम प्रॉक्सी सेट करना
• Kill-switch लागू करना
• रूट्स की मरम्मत करना
• packet VPN runtime प्रबंधित करना

इसलिए CLI ये ऑपरेशन प्लेटफ़ॉर्म के अनुरूप daemon / service के माध्यम से करता है।

विभिन्न प्लेटफ़ॉर्म पर daemon के रूप:

मुख्य अंतर यह है: Windows और macOS में service आमतौर पर इंस्टॉलर के माध्यम से अपने-आप इंस्टॉल हो जाती है, जबकि Linux में उपयोगकर्ता को आमतौर पर sudo panda service install मैन्युअल रूप से चलाना पड़ता है।

Windows में, केवल तब जब आप इंस्टॉलर का उपयोग नहीं कर रहे हों और binary को मैन्युअल रूप से रख रहे हों, आपको administrator PowerShell में यह चलाना होगा:

panda service install windows

macOS में, यह केवल development और debugging के दौरान, .pkg इंस्टॉलर का उपयोग न करने पर, या daemon के अपने-आप शुरू न होने पर आवश्यक है:

sudo panda start

Linux में अनुशंसित है:

sudo panda service install
panda service status

हाँ, ये समान हैं। मुख्य अंतर डाउनलोड किए जाने वाले इंस्टॉलेशन पैकेज की आर्किटेक्चर में है।

इंस्टॉलेशन चरण, कमांड और सर्विस प्रबंधन का तरीका समान है। इंस्टॉलर अपने आप प्रिविलेज बढ़ाएगा और Windows Service को रजिस्टर करेगा।

मुख्य रूप से समर्थन करता है:

सामान्य सेटिंग्स:

panda mode auto
panda mode pandavpn global
panda mode proxy global
panda mode wireguard

वर्तमान में उपयोगकर्ता दस्तावेज़ों में openvpn को मुख्य मोड के रूप में दिखाने की अनुशंसा नहीं की जाती है।

सुझाव:

ध्यान दें: mode proxy और Kill-switch एक साथ उपयोग नहीं किए जा सकते।

mode auto नए संस्करण का डिफ़ॉल्ट मोड है।

इसका व्यवहार है:

• API node / smart connect meta.protocol के आधार पर runtime को प्राथमिकता से चुनता है;
• यदि WireGuard सुझाया गया है, तो यह पहले WireGuard आज़माएगा;
• यदि WireGuard metadata, address allocation, runtime startup, handshake या connectivity probing विफल हो जाए, तो यह SS payload से संकलित PandaVPN global पर वापस जाएगा;
• SS, OPENVPN, अज्ञात या अनुपस्थित प्रोटोकॉल fallback के रूप में PandaVPN global का उपयोग करेंगे;
• mode auto policy पैरामीटर स्वीकार नहीं करता, और resolved runtime हमेशा global होता है।

नए उपयोगकर्ताओं के लिए अनुशंसित:

panda mode auto
panda connect

direct-region अनुशंसित syntax है; bypass-region / bypass compatibility aliases हैं।

उदाहरण:

panda mode pandavpn direct-region in

यह compatibility alias के बराबर है:

panda mode pandavpn bypass-region in

नया संस्करण अधिक पूर्ण split profile सिंटैक्स का समर्थन करता है:

panda mode pandavpn split default direct proxy-region <cc>
panda mode pandavpn split default proxy direct-region <cc>

सामान्य token:

उदाहरण:

panda mode pandavpn split default direct proxy-region us custom-rules
panda mode pandavpn split default proxy direct-region in direct-lan custom-rules

शुरुआती दस्तावेज़ों में long commands दिखाने की अनुशंसा नहीं की जाती; ये advanced split documentation के लिए अधिक उपयुक्त हैं।

doctor एक read-only diagnostic command है, जिसका उपयोग Panda CLI की current key status देखने के लिए किया जाता है।

panda doctor
panda doctor --json

Short form:

panda do

इन पर खास ध्यान दें:

runtime
kill_switch
selected_node
vpn_dns
dns_lockdown
split_policy
system_proxy_state
vpn_routes
last_error

trace का उपयोग यह देखने के लिए किया जाता है कि कोई target कौन सा rule, DNS action और route इस्तेमाल करेगा।

panda trace example.com:443
panda trace 8.8.8.8:53 --json

ध्यान दें: full trace capability के लिए active PandaVPN packet runtime चाहिए। compatible runtime न होने पर केवल limited validation हो सकती है या legacy trace पर fallback होगा।

आमतौर पर ऐसा इसलिए होता है क्योंकि official service / LaunchDaemon इंस्टॉल है, और साथ में manually यह भी चलाया गया है:

sudo panda start

sudo panda start एक unmanaged / management से बाहर daemon शुरू करता है, जो official daemon के साथ-साथ ये चीज़ें manage कर सकता है:

• VPN routes
• DNS
• TUN
• system proxy
• Kill-switch

हैंडलिंग का सिद्धांत है: सिर्फ़ एक daemon रखें।

macOS / Linux पर सामान्य समाधान:

panda disconnect
panda kill-switch off
sudo panda stop
panda repair
panda doctor

Linux पर अगर आप systemd service इस्तेमाल कर रहे हैं, तो इसके बाद official service restart करें:

sudo panda service restart
panda doctor

macOS पर अगर .pkg से install किया है, तो आमतौर पर LaunchDaemon / helper को daemon manage करने दें, और sudo panda start को लंबे समय तक daily startup method के रूप में इस्तेमाल न करें।

यदि आप केवल VPN disconnect करना चाहते हैं, तो daemon से exit करने की ज़रूरत नहीं है:

panda disconnect
panda kill-switch off

यदि आप सच में daemon रोकना चाहते हैं:

sudo panda stop

पुष्टि करें:

panda status

यदि panda daemon unavailable दिखाई देता है, तो इसका मतलब है कि main daemon बंद हो गया है।

ध्यान दें: macOS .pkg द्वारा installed LaunchDaemon / helper को system manage कर सकता है; सामान्य users को service बार-बार manually stop करने की सलाह नहीं दी जाती।

panda log
panda log --lines 200
panda log --all

Logs साफ़ करें:

panda log clear

अस्थायी रूप से debug चालू करें:

panda log level debug dns,tcp --ttl 10m

Default restore करें:

panda log level reset

panda repair अधिक व्यापक है और यह इन्हें ठीक कर सकता है:

• VPN route
• DNS snapshot
• Kill-switch guard
• system proxy से संबंधित state

panda proxy repair मुख्य रूप से वर्तमान उपयोगकर्ता के system proxy drift को ठीक करता है।

panda repair
panda proxy repair

Fresh install में default proxy system-proxy on होता है।
अगर user ने स्पष्ट रूप से off save किया है, तो वही configuration रखी जाएगी।

देखें या सेट करें:

panda proxy system-proxy on
panda proxy system-proxy off
panda proxy system-proxy lock-on

ध्यान दें: mode auto, pandavpn, और wireguard में VPN runtime persisted system proxy preference को ignore करता है; VPN companion proxy फिर भी available रहता है और scoped egress से चलता है।

Windows system proxy वर्तमान उपयोगकर्ता की HKCU WinINET setting है और इसके लिए per-user user-agent चाहिए।
यदि आप SSH या non-interactive session में हैं, तो proxy repair हमेशा user-agent को अपने आप शुरू नहीं कर पाएगा।

अनुशंसित:

panda proxy status
panda proxy repair
panda doctor

यदि यह अभी भी प्रभावी नहीं होता, तो desktop login session में फिर से प्रयास करें।

Linux Phase 1 मुख्य रूप से GNOME gsettings को support करता है।
KDE / XFCE जैसे environments unsupported दिख सकते हैं।

यह जरूरी नहीं कि PandaVPN packet runtime को प्रभावित करे, लेकिन system proxy mode experience को प्रभावित कर सकता है।

Kill-switch का अर्थ है कि केवल TUN से गुजरने वाले traffic की अनुमति होगी, बाकी सामान्य traffic ब्लॉक हो जाएगा।

proxy mode एक standalone local proxy mode है। इसमें packet VPN / TUN नहीं होता, और DNS तथा routing की समान सुरक्षा भी नहीं मिलती। इसलिए Kill-switch standalone proxy mode को support नहीं करता।

जब Kill-switch चाहिए, तो उपयोग करें:

panda mode auto
panda kill-switch on

या:

panda mode pandavpn global
panda kill-switch on

या:

panda mode wireguard
panda kill-switch on

नहीं।

Auto-connect मुख्य रूप से daemon / service शुरू होने पर best-effort connect और startup के समय network अस्थायी रूप से उपलब्ध न होने पर pending retry को कवर करता है।

चालू करें:

panda config auto-connect on

बंद करें:

panda config auto-connect off

यह कोई सामान्य runtime automatic reconnect mechanism नहीं है।

Split rules का उपयोग यह तय करने के लिए किया जाता है कि कुछ domains, keywords, regex या IP proxy, direct या block से जाएँ।

Rule files:

split/rules/proxy.txt
split/rules/direct.txt
split/rules/block.txt

आम commands:

panda split rules list
panda split rules add proxy suffix:github.com
panda split rules add direct ip-cidr:10.0.0.0/8
panda split rules add block keyword:adservice

वर्तमान ज्ञात सीमा: login के बाद retry का इंतज़ार कर रहा pending auto-connect अपने आप wake नहीं होगा।

login के बाद manually चलाने की सलाह है:

panda connect

आमतौर पर नहीं। Split DNS configuration changes hot-loaded होते हैं।

आम commands:

panda split dns status
panda split dns local set 223.5.5.5 114.114.114.114
panda split dns policy tunnel-only
panda split dns fake-ip on

यदि platform कुछ local DNS sources को support नहीं करता, तो doctor warning दिखाएगा।