PandaVPN CLI FAQs

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

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

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

PandaVPN CLI स्वचालित परीक्षण, दूरस्थ समस्या निवारण और स्क्रिप्ट के माध्यम से किए जाने वाले कनेक्शन के लिए अधिक उपयुक्त है।

Panda Desktop और PandaVPN CLI एक ही PandaVPN daemon के लिए दो नियंत्रण इंटरफ़ेस हैं और एक ही कनेक्शन स्थिति साझा करते हैं, इसलिए इन्हें साथ में उपयोग किया जा सकता है।

Panda-Qt या पुराने Linux AppImage जैसे पुराने डेस्कटॉप ऐप्स को PandaVPN CLI के साथ एक ही समय पर न चलाएँ, क्योंकि इससे नेटवर्क कॉन्फ़िगरेशन में टकराव हो सकता है।

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

• 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 को रजिस्टर करेगा।

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

इंस्टॉलेशन चरण समान हैं। .pkg से इंस्टॉल करने के बाद LaunchDaemon / helper आमतौर पर अपने-आप इंस्टॉल और शुरू हो जाता है।

वैश्विक उपयोगकर्ताओं के लिए, हम डिफ़ॉल्ट रूप से mode auto उपयोग करने की सलाह देते हैं:

panda login
panda node refresh
panda mode auto
panda connect
panda doctor

यदि नई इंस्टॉलेशन में पहले से ही mode auto डिफ़ॉल्ट है, तो आप सरल संस्करण भी उपयोग कर सकते हैं:

panda login
panda node refresh
panda connect
panda doctor

संबंधित शॉर्टहैंड संस्करण:

panda login
panda no re
panda conn
panda do

आधिकारिक डाउनलोड पेज और शुरुआती गाइड में पहले पूर्ण कमांड दिखाना बेहतर है; शॉर्टहैंड को उन्नत दस्तावेज़ों या इंटरैक्टिव मोड के विवरण में दिखाया जा सकता है।

gfwlist split rules का एक विशिष्ट स्रोत है और वैश्विक उपयोगकर्ताओं के लिए default mode के रूप में उपयुक्त नहीं है।

वैश्विक उपयोगकर्ताओं के लिए default recommendation है:

panda mode auto

या PandaVPN global mode को स्थायी रूप से उपयोग करें:

panda mode pandavpn global

gfwlist को advanced split-routing documentation में रखा जा सकता है, लेकिन इसे official website की first screen, download page Hero या beginner quick start में दिखाने की सलाह नहीं दी जाती।

पहले disconnect करने और Kill-switch बंद करने की सलाह है:

panda disconnect
panda kill-switch off

अगर manual upgrade या Linux service upgrade है, तो daemon को भी stop करने की सलाह है:

sudo panda stop

macOS और Windows पर installer से upgrade करते समय, installer आमतौर पर service installation और restart अपने आप handle करता है। upgrade पूरा होने के बाद यह चलाने की सलाह है:

panda version
panda doctor
panda connect

Linux manual upgrade के बाद सलाह है:

sudo panda service install
sudo panda service restart
panda version
panda doctor

panda connect us

इसका मतलब bare group selector है; यह VIP / SVIP / FREE tab को fix नहीं करता, API उपयुक्त tab चुनता है।

panda connect svip us

इसका मतलब SVIP tab के अंतर्गत us को fixed रूप से इस्तेमाल करना है।

colon form equivalent है और scripts के लिए उपयुक्त है:

panda connect svip:us

favorite tab अभी flat favorite channel list है और connect fav us जैसे favorite group smart connect का समर्थन नहीं करता; favorite के लिए उपयोग करें:

panda connect fav

या:

panda connect --node <NODE_ID>

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

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

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 के लिए अधिक उपयुक्त हैं।

सभी nodes देखें:

panda node list

Refresh करने के बाद फिर देखें:

panda node refresh
panda node list

Short form:

panda no re
panda no list

किसी region या group को देखें:

panda node list us
panda node list jp
panda node list de

Node groups देखें:

panda node group

किसी group की details देखें:

panda node group show us

पहले node खोजें:

panda node list us

फिर कनेक्ट करें:

panda connect --node 1822

आप नाम से भी कनेक्ट कर सकते हैं:

panda connect --node "US Node"

शॉर्टहैंड:

panda no list us
panda conn --node 1822

panda connect पिछले target का उपयोग करता है।
अगर कोई previous target नहीं है, तो यह global smart connect की कोशिश करता है।

Smart connect के लिए चाहिए:

• आप logged in हों;
• node directory cached हो;
• जरूरत होने पर पहले panda node refresh चलाएँ।

Short form:

panda conn

सामान्य कारण:

• आप अभी logged in नहीं हैं;
• node directory refresh नहीं हुई है;
• current account में कोई available node नहीं है;
• network उपलब्ध नहीं है;
• daemon चल नहीं रहा है;
• current mode target node के साथ compatible नहीं है;
• mode auto में recommended protocol start नहीं हुआ और fallback भी fail हो गया।

जाँच के लिए सुझाव:

panda account
panda node refresh
panda node list
panda mode
panda doctor
panda log --lines 200

panda status

संरचित आउटपुट:

panda status --json

शॉर्टहैंड:

panda stat

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

no-tunnel IPv6 scenario में awdl0 / llw0 block हो सकते हैं, जिससे AirDrop / Continuity अस्थायी रूप से उपलब्ध नहीं हो सकते।
आमतौर पर disconnect के बाद यह ठीक हो जाता है।

यदि समस्या फिर भी बनी रहे, तो अनुशंसित:

panda disconnect
panda kill-switch off
panda repair
panda doctor

Supported versions में इसे configure किया जा सकता है:

panda config tcp-fast-open auto
panda config tcp-fast-open on
panda config tcp-fast-open off

नोट:

• Default के लिए auto recommended है;
• बदलाव के बाद hot reconnect नहीं होगा;
• नए TCP socket पर effect के लिए reconnect करना होगा;
• जो nodes TFO support नहीं करते, उनमें connection latency की noticeable regression नहीं दिखनी चाहिए।

अगर current version में यह config item नहीं है, तो panda config --help या actual CLI help को मानें।

Privacy mode को अधिक सख्त सुरक्षा मोड के रूप में समझा जा सकता है, और इसे इसके बराबर मानने की अनुशंसा है:

panda mode pandavpn global
panda kill-switch on

या डिफ़ॉल्ट automatic protocol selection के तहत:

panda mode auto
panda kill-switch on

Privacy mode में ये सीमाएँ अनुशंसित हैं:

• proxy mode समर्थित नहीं है;
• split mode समर्थित नहीं है;
• केवल VPN global semantics की अनुमति है;
• Kill-switch सक्षम होना चाहिए;
• सामान्य egress ब्लॉक किया जाता है।

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 दिखाएगा।

नए versions में, Windows Kill-switch को daemon-held dynamic session से persistent WFP filters में upgrade किया गया है।
इसका मतलब है कि daemon के abnormal exit के बाद भी guard बना रह सकता है।

लेकिन persistent WFP, boot-time filter के बराबर नहीं है; बहुत early startup window अभी भी आगे के hardening scope में है।

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

हाँ।

mode auto + kill-switch on की अनुमति है, लेकिन अंतिम path को PandaVPN / WireGuard में resolve होना चाहिए और standalone proxy पर नहीं गिरना चाहिए। कनेक्शन के दौरान यदि WireGuard से PandaVPN पर fallback होता है, तो guard active भी बना रहना चाहिए, और कोई fail-open window नहीं आनी चाहिए।

अनुशंसित:

panda mode auto
panda kill-switch on
panda connect
panda doctor

अनुशंसित नहीं है।

Kill-switch enhanced privacy protection विकल्प है, और इसे shortest usable path में रखना उपयुक्त नहीं है। कारण:

• disconnect Kill-switch को बंद नहीं करता;
• इसे चालू करने के बाद सामान्य network ब्लॉक हो सकता है;
• इसमें LAN access, DNS lockdown, firewall और platform permission differences भी शामिल हैं;
• नए users गलती से समझ सकते हैं कि network खराब हो गया है।

नए users को पहले यह पूरा करने की सलाह दी जाती है:

panda login
panda node refresh
panda mode auto
panda connect
panda doctor

connection सामान्य रूप से काम कर रहा है यह पुष्टि करने के बाद, जरूरत के अनुसार चालू करें:

panda kill-switch on
panda doctor

नहीं।

यह अपेक्षित व्यवहार है। Kill-switch एक persistent safety switch है, और disconnect केवल मौजूदा runtime को disconnect करता है; यह Kill-switch को अपने आप बंद नहीं करता।

सामान्य नेटवर्क एक्सेस बहाल करने के लिए, यह चलाएँ:

panda kill-switch off

Strict mode में Kill-switch सामान्य LAN / WAN traffic को ब्लॉक कर देता है।
allow-lan को support करने वाले version limited LAN access चालू कर सकते हैं:

panda kill-switch allow-lan on

LAN allow को बंद करें:

panda kill-switch allow-lan off

ध्यान दें: allow-lan private network / link-local / ULA unicast और v1 discovery की अनुमति देता है, लेकिन LAN DNS अभी भी ब्लॉक रहना चाहिए ताकि Panda DNS lockdown bypass न हो।