Συχνές ερωτήσεις PandaVPN CLI

Το Panda CLI είναι ο πελάτης γραμμής εντολών του Panda και υποστηρίζει την εκτέλεση των παρακάτω μέσω τερματικού:

• Σύνδεση και διαχείριση λογαριασμού
• Ανανέωση κόμβων και σύνδεση σε κόμβους
• Εναλλαγή λειτουργιών PandaVPN / Proxy / WireGuard / Auto
• Ρύθμιση διακομιστή μεσολάβησης συστήματος
• Κανόνες Split rules για διαχωρισμό κίνησης
• Ρύθμιση Split DNS
• Προστασία Kill-switch
• Auto-connect
• Αρχεία καταγραφής και διαγνωστικά

Είναι κατάλληλο για χρήστες εσωτερικών δοκιμών, προγραμματιστές, προχωρημένους χρήστες και σενάρια δοκιμών που απαιτούν λειτουργίες μέσω script.

Το Panda CLI λειτουργεί μέσω της γραμμής εντολών και είναι πιο κατάλληλο για:

• Αυτοματοποιημένες δοκιμές
• Απομακρυσμένη αντιμετώπιση προβλημάτων
• Συνδέσεις μέσω script
• Προβολή λεπτομερών διαγνωστικών πληροφοριών
• Επαλήθευση συμπεριφορών χαμηλού επιπέδου, όπως Kill-switch, DNS, δρομολόγηση και διακομιστής μεσολάβησης συστήματος

Ο πελάτης επιτραπέζιου υπολογιστή είναι πιο κατάλληλος για καθημερινές γραφικές λειτουργίες από απλούς χρήστες.

Σημείωση: Δεν συνιστάται ο παλιός πελάτης επιτραπέζιου υπολογιστή Qt και το CLI να διαχειρίζονται ταυτόχρονα το VPN / τον διακομιστή μεσολάβησης συστήματος, ώστε να αποφεύγεται η αμοιβαία αντικατάσταση ρυθμίσεων.

Ορισμένες δυνατότητες απαιτούν δικαιώματα σε επίπεδο συστήματος, για παράδειγμα:

• Δημιουργία διεπαφών δικτύου TUN / WireGuard
• Τροποποίηση DNS
• Ρύθμιση διακομιστή μεσολάβησης συστήματος
• Εφαρμογή Kill-switch
• Επιδιόρθωση διαδρομών
• Διαχείριση του packet VPN runtime

Επομένως, το CLI εκτελεί αυτές τις λειτουργίες μέσω του daemon / service που αντιστοιχεί στην πλατφόρμα.

Μορφές daemon σε διαφορετικές πλατφόρμες:

Η βασική διαφορά είναι: Στα Windows και macOS η υπηρεσία συνήθως εγκαθίσταται αυτόματα μέσω του πακέτου εγκατάστασης, ενώ στο Linux ο χρήστης συνήθως πρέπει να εκτελέσει χειροκίνητα το sudo panda service install.

Στα Windows, μόνο όταν δεν χρησιμοποιείται πακέτο εγκατάστασης και τα δυαδικά αρχεία τοποθετούνται χειροκίνητα, χρειάζεται εκτέλεση σε PowerShell ως διαχειριστής:

panda service install windows

Στο macOS, αυτό χρειάζεται μόνο κατά την ανάπτυξη και τον εντοπισμό σφαλμάτων, όταν δεν χρησιμοποιείται πακέτο εγκατάστασης .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 επιλέγει κατά προτεραιότητα runtime βάσει του meta.protocol;
• Αν προτείνεται το WireGuard, θα δοκιμαστεί πρώτα το WireGuard;
• Αν αποτύχουν τα μεταδεδομένα WireGuard, η εκχώρηση διεύθυνσης, η εκκίνηση runtime, το handshake ή ο έλεγχος συνδεσιμότητας, θα γίνει fallback στο PandaVPN global που έχει παραχθεί από SS payload;
• Τα SS, OPENVPN και άγνωστα ή ελλιπή πρωτόκολλα θα χρησιμοποιούν το PandaVPN global ως εφεδρική επιλογή;
• Το mode auto δεν δέχεται παράμετρο policy και το runtime που προκύπτει είναι πάντα global.

Συνιστάται στους νέους χρήστες να χρησιμοποιούν:

panda mode auto
panda connect

Το direct-region είναι η προτεινόμενη σύνταξη· τα bypass-region / bypass είναι συμβατά alias.

Για παράδειγμα:

panda mode pandavpn direct-region in

Ισοδυναμεί με το συμβατό 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

Δεν συνιστάται η εμφάνιση μακρών εντολών στην τεκμηρίωση για αρχάριους· είναι κατάλληλες για προχωρημένη τεκμηρίωση split.

Το doctor είναι μια διαγνωστική εντολή μόνο για ανάγνωση, που χρησιμοποιείται για την προβολή της τρέχουσας βασικής κατάστασης του Panda CLI.

panda doctor
panda doctor --json

Σύντομη γραφή:

panda do

Δώστε ιδιαίτερη προσοχή στα:

runtime
kill_switch
selected_node
vpn_dns
dns_lockdown
split_policy
system_proxy_state
vpn_routes
last_error

Το trace χρησιμοποιείται για να δείτε ποιος κανόνας, DNS action και route θα χρησιμοποιηθεί για έναν συγκεκριμένο στόχο.

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

Σημείωση: η πλήρης δυνατότητα trace απαιτεί active PandaVPN packet runtime. Χωρίς συμβατό runtime, μπορεί να γίνει μόνο περιορισμένος έλεγχος ή επιστροφή σε legacy trace.

Συνήθως συμβαίνει επειδή έχει εγκατασταθεί το επίσημο service / LaunchDaemon και έχει εκτελεστεί χειροκίνητα και το εξής:

sudo panda start

Το sudo panda start ξεκινά έναν unmanaged / μη διαχειριζόμενο daemon, ο οποίος μπορεί να διαχειρίζεται ταυτόχρονα με τον επίσημο daemon:

• VPN route
• 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, επανεκκινήστε μετά το επίσημο service:

sudo panda service restart
panda doctor

Στο macOS, αν χρησιμοποιείτε εγκατάσταση .pkg, συνήθως αφήστε το LaunchDaemon / helper να διαχειρίζεται τον daemon και μην χρησιμοποιείτε μακροπρόθεσμα το sudo panda start ως καθημερινό τρόπο εκκίνησης.

Αν θέλετε απλώς να αποσυνδέσετε το VPN, δεν χρειάζεται να τερματίσετε το daemon:

panda disconnect
panda kill-switch off

Αν όντως θέλετε να σταματήσετε το daemon:

sudo panda stop

Επιβεβαίωση:

panda status

Αν εμφανιστεί panda daemon unavailable, σημαίνει ότι το κύριο daemon έχει σταματήσει.

Σημείωση: Το LaunchDaemon / helper που εγκαθίσταται με macOS .pkg μπορεί να διαχειρίζεται από το σύστημα· δεν συνιστάται οι απλοί χρήστες να σταματούν συχνά χειροκίνητα την υπηρεσία.

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

Εκκαθάριση logs:

panda log clear

Προσωρινή ενεργοποίηση debug:

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

Επαναφορά προεπιλογής:

panda log level reset

Το panda repair είναι πιο ολοκληρωμένο και μπορεί να επιδιορθώσει:

• VPN route
• DNS snapshot
• Kill-switch guard
• καταστάσεις σχετικές με system proxy

Το panda proxy repair επιδιορθώνει κυρίως το system proxy drift του τρέχοντος χρήστη.

panda repair
panda proxy repair

Σε Fresh install, η προεπιλογή είναι proxy system-proxy on.
Αν ο χρήστης έχει αποθηκεύσει ρητά το off, αυτή η ρύθμιση θα διατηρηθεί.

Προβολή ή ρύθμιση:

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

Σημείωση: στα mode auto, pandavpn και wireguard, το VPN runtime θα αγνοεί την αποθηκευμένη προτίμηση system proxy· το VPN companion proxy παραμένει διαθέσιμο και χρησιμοποιεί scoped egress.

Το Windows system proxy είναι ρύθμιση HKCU WinINET του τρέχοντος χρήστη και απαιτεί per-user user-agent.
Αν βρίσκεστε σε SSH ή μη διαδραστική συνεδρία, το proxy repair ενδέχεται να μην μπορεί πάντα να εκκινήσει αυτόματα το user-agent.

Συνιστάται:

panda proxy status
panda proxy repair
panda doctor

Αν εξακολουθεί να μην εφαρμόζεται, δοκιμάστε ξανά σε συνεδρία σύνδεσης επιφάνειας εργασίας.

Το Linux Phase 1 υποστηρίζει κυρίως GNOME gsettings.
Περιβάλλοντα όπως KDE / XFCE ενδέχεται να εμφανίζονται ως unsupported.

Αυτό δεν επηρεάζει απαραίτητα το PandaVPN packet runtime, αλλά μπορεί να επηρεάσει την εμπειρία του system proxy mode.

Η σημασία του Kill-switch είναι να επιτρέπεται μόνο η κίνηση μέσω TUN, ενώ κάθε άλλη κανονική κίνηση αποκλείεται.

Το proxy mode είναι standalone τοπική λειτουργία proxy, χωρίς packet VPN / TUN και χωρίς ισοδύναμη προστασία DNS και δρομολόγησης. Επομένως το Kill-switch δεν υποστηρίζει standalone proxy mode.

Όταν χρειάζεστε 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 καλύπτει κυρίως το best-effort connect κατά την εκκίνηση του daemon / service, καθώς και το pending retry όταν κατά την εκκίνηση δεν υπάρχει προσωρινά διαθέσιμο δίκτυο.

Ενεργοποίηση:

panda config auto-connect on

Απενεργοποίηση:

panda config auto-connect off

Δεν είναι ένας γενικός μηχανισμός αυτόματης επανασύνδεσης κατά το runtime.

Τα Split rules χρησιμοποιούνται για να ορίσετε ότι ορισμένα domains, keywords, regex ή IP περνούν από proxy, direct ή block.

Αρχεία κανόνων:

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

Συνηθισμένες εντολές:

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, το pending auto-connect που περιμένει retry δεν θα γίνει wake αυτόματα.

Συνιστάται μετά το login να εκτελέσετε χειροκίνητα:

panda connect

Συνήθως δεν χρειάζεται. Οι αλλαγές στη διαμόρφωση Split DNS γίνονται hot-load.

Συνηθισμένες εντολές:

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

Αν η πλατφόρμα δεν υποστηρίζει ορισμένες πηγές local DNS, το doctor θα εμφανίσει warning.