Ofte stillede spørgsmål om PandaVPN CLI

Panda CLI er Pandas kommandolinjeklient og understøtter følgende via terminalen:

• Login og kontoadministration
• Opdatering af noder og forbindelse til noder
• Skift mellem PandaVPN / Proxy / WireGuard / Auto-tilstande
• Konfiguration af systemproxy
• Split rules-regler til trafikopdeling
• Konfiguration af Split DNS
• Kill-switch-beskyttelse
• Auto-connect
• Logfiler og diagnosticering

Den er velegnet til interne testbrugere, udviklere, avancerede brugere og testscenarier, der kræver scriptede handlinger.

PandaVPN CLI er bedre egnet til automatiseret test, fjernfejlfinding og scriptstyrede forbindelser.

Panda Desktop og PandaVPN CLI er to kontrolgrænseflader til den samme PandaVPN daemon og deler den samme forbindelsesstatus, så de kan bruges sammen.

Kør ikke ældre desktopapps, såsom Panda-Qt eller den gamle Linux AppImage, samtidig med PandaVPN CLI, da det kan medføre konflikter i netværkskonfigurationen.

Nogle funktioner kræver tilladelser på systemniveau, f.eks.:

• Oprettelse af TUN / WireGuard-netværksinterfaces
• Ændring af DNS
• Opsætning af systemproxy
• Anvendelse af Kill-switch
• Reparation af ruter
• Administration af packet VPN runtime

Derfor udfører CLI disse handlinger via den daemon / service, der passer til platformen.

Daemon-former på forskellige platforme:

Den grundlæggende forskel er: På Windows og macOS installeres tjenesten normalt automatisk via installationspakken, mens brugeren på Linux normalt skal køre sudo panda service install manuelt.

På Windows er det kun nødvendigt at køre følgende i PowerShell som administrator, hvis du ikke bruger installationspakken og placerer binærfilerne manuelt:

panda service install windows

På macOS er det kun nødvendigt under udvikling og fejlfinding, hvis .pkg-installationspakken ikke bruges, eller hvis daemon ikke starter automatisk:

sudo panda start

På Linux anbefales:

sudo panda service install
panda service status

Ja, de er de samme. Forskellen ligger primært i arkitekturen for den installationspakke, der downloades.

Installationstrin, kommandoer og måden at administrere tjenesten på er de samme. Installationspakken hæver automatisk rettighederne og registrerer Windows Service.

Ja, de er de samme. Den primære forskel er arkitekturen for den .pkg-pakke, der downloades.

Installationstrinnene er de samme. Efter installation med .pkg installeres og startes LaunchDaemon / helper normalt automatisk.

Til globale brugere anbefaler vi som standard at bruge mode auto:

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

Hvis en ny installation allerede bruger mode auto som standard, kan man også bruge en mere enkel version:

panda login
panda node refresh
panda connect
panda doctor

Tilsvarende kortform:

panda login
panda no re
panda conn
panda do

Det anbefales, at den officielle downloadside og begynderguiden først viser de fulde kommandoer; kortformerne kan derefter vises i avanceret dokumentation eller i beskrivelser af interaktiv tilstand.

gfwlist er en specifik kilde til split-regler og er ikke egnet som standardtilstand for globale brugere.

For globale brugere anbefales som standard:

panda mode auto

Eller brug PandaVPNs globale tilstand fast:

panda mode pandavpn global

gfwlist kan beholdes i dokumentationen for avanceret split routing, men det anbefales ikke at vise den på den officielle hjemmesides første skærm, downloadsidens Hero eller i hurtigstarten for begyndere.

Det anbefales først at afbryde forbindelsen og slå Kill-switch fra:

panda disconnect
panda kill-switch off

Hvis det er en manuel opgradering eller en Linux service-opgradering, anbefales det også at stoppe daemon:

sudo panda stop

Ved opgradering på macOS og Windows med installationspakke håndterer installationspakken normalt service-installation og genstart automatisk. Når opgraderingen er fuldført, anbefales det at køre:

panda version
panda doctor
panda connect

Efter manuel opgradering på Linux anbefales:

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

panda connect us

Betyder en bare group selector; den låser ikke VIP / SVIP / FREE tab, og API vælger en passende tab.

panda connect svip us

Betyder fast brug af us under SVIP tab.

Kolonformen er ækvivalent og egnet til scripts:

panda connect svip:us

favorite tab er i øjeblikket en flat favorite channel list og understøtter ikke favorite group smart connect som connect fav us; brug følgende til favorite:

panda connect fav

eller:

panda connect --node <NODE_ID>

Understøtter primært:

Almindelige indstillinger:

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

openvpn anbefales i øjeblikket ikke som hovedtilstand i brugerdokumentationen.

Anbefaling:

Bemærk: mode proxy og Kill-switch udelukker hinanden.

mode auto er standardtilstanden i den nye version.

Dens adfærd er:

• API node / smart connect vælger runtime med prioritet ud fra meta.protocol;
• Hvis WireGuard anbefales, forsøges WireGuard først;
• Hvis WireGuard-metadata, adressetildeling, runtime-start, handshake eller forbindelsestest mislykkes, falder den tilbage til PandaVPN global kompileret fra SS payload;
• SS, OPENVPN samt ukendte eller manglende protokoller bruger PandaVPN global som fallback;
• mode auto accepterer ikke en policy-parameter, og den udledte runtime er altid global.

Nye brugere anbefales at bruge:

panda mode auto
panda connect

direct-region er den anbefalede syntaks; bypass-region / bypass er kompatibilitetsaliaser.

Eksempel:

panda mode pandavpn direct-region in

Svarer til kompatibilitetsaliaset:

panda mode pandavpn bypass-region in

Den nye version understøtter en mere komplet split profile-syntaks:

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

Almindelige tokens:

Eksempler:

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

Det anbefales ikke at vise lange kommandoer i begynderdokumentation; de passer bedre i avanceret split-dokumentation.

Vis alle noder:

panda node list

Opdater og vis derefter igen:

panda node refresh
panda node list

Kort form:

panda no re
panda no list

Vis en bestemt region eller gruppe:

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

Vis nodegrupper:

panda node group

Vis detaljer for en bestemt gruppe:

panda node group show us

Søg først efter node:

panda node list us

Opret derefter forbindelse:

panda connect --node 1822

Du kan også oprette forbindelse efter navn:

panda connect --node "US Node"

Kort form:

panda no list us
panda conn --node 1822

panda connect bruger det seneste mål.
Hvis der ikke findes et tidligere mål, forsøges global smart connect.

Smart connect kræver:

• at du er logget ind;
• at nodekataloget er cachelagret;
• kør om nødvendigt først panda node refresh.

Kort form:

panda conn

Almindelige årsager:

• du er endnu ikke logget ind;
• nodekataloget er ikke opdateret;
• den aktuelle konto har ingen tilgængelige noder;
• netværket er ikke tilgængeligt;
• daemon kører ikke;
• den aktuelle mode er ikke kompatibel med målnoden;
• i mode auto kunne den anbefalede protokol ikke starte, og fallback mislykkedes også.

Anbefalet fejlfinding:

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

panda status

Struktureret output:

panda status --json

Kort form:

panda stat

doctor er en skrivebeskyttet diagnosticeringskommando, der bruges til at se de aktuelle nøglestatusser for Panda CLI.

panda doctor
panda doctor --json

Kort form:

panda do

Fokuser især på:

runtime
kill_switch
selected_node
vpn_dns
dns_lockdown
split_policy
system_proxy_state
vpn_routes
last_error

trace bruges til at se, hvilken regel, DNS action og route et bestemt mål vil bruge.

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

Bemærk: fuld trace-funktionalitet kræver active PandaVPN packet runtime. Uden kompatibel runtime kan der kun udføres begrænset validering eller fallback til legacy trace.

Det skyldes normalt, at den officielle service / LaunchDaemon er installeret, og at du også manuelt har kørt:

sudo panda start

sudo panda start starter en unmanaged / ikke-administreret daemon, som samtidig med den officielle daemon kan administrere:

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

Princippet er: behold kun én daemon.

Almindelig håndtering på macOS / Linux:

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

På Linux, hvis du bruger systemd service, skal du derefter genstarte den officielle service:

sudo panda service restart
panda doctor

På macOS, hvis du installerer med .pkg, bør LaunchDaemon / helper normalt administrere daemon; brug ikke sudo panda start langfristet som daglig startmetode.

Hvis du kun vil afbryde VPN, behøver du ikke afslutte daemon:

panda disconnect
panda kill-switch off

Hvis du faktisk vil stoppe daemon:

sudo panda stop

Bekræft:

panda status

Hvis der vises panda daemon unavailable, betyder det, at hoved-daemon er stoppet.

Bemærk: LaunchDaemon / helper installeret via macOS .pkg kan være administreret af systemet; almindelige brugere bør ikke ofte stoppe tjenesten manuelt.

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

Ryd logs:

panda log clear

Aktivér debug midlertidigt:

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

Gendan standard:

panda log level reset

I et no-tunnel IPv6-scenarie kan awdl0 / llw0 blive block, hvilket gør AirDrop / Continuity midlertidigt utilgængeligt.
Normalt gendannes det efter disconnect.

Hvis det stadig er unormalt, anbefales:

panda disconnect
panda kill-switch off
panda repair
panda doctor

Understøttede versioner kan konfigurere dette:

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

Forklaring:

• Som standard anbefales auto;
• Ændringen udløser ikke hot reconnect;
• Der kræves reconnect, før det gælder for nye TCP socket;
• Nodes uden TFO-understøttelse bør ikke få tydelig regression i forbindelsesforsinkelse.

Hvis den aktuelle version ikke har denne konfigurationsmulighed, skal du følge panda config --help eller den faktiske CLI help.

Privacy mode kan forstås som en strengere sikkerhedstilstand og anbefales som ækvivalent med:

panda mode pandavpn global
panda kill-switch on

Eller ved automatisk valg af protokol som standard:

panda mode auto
panda kill-switch on

I Privacy mode anbefales følgende begrænsninger:

• Understøtter ikke proxy mode;
• Understøtter ikke split mode;
• Tillader kun VPN global-semantik;
• Kill-switch skal være aktiveret;
• Almindelig egress blokeres.

panda repair er mere omfattende og kan reparere:

• VPN route
• DNS snapshot
• Kill-switch guard
• system proxy-relateret tilstand

panda proxy repair reparerer primært den aktuelle brugers system proxy drift.

panda repair
panda proxy repair

Ved Fresh install er standarden proxy system-proxy on.
Hvis brugeren eksplicit har gemt off, bevares den konfiguration.

Vis eller indstil:

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

Bemærk: I mode auto, pandavpn og wireguard ignorerer VPN runtime den gemte system proxy-præference; VPN companion proxy er stadig tilgængelig og bruger scoped egress.

Windows system proxy er den aktuelle brugers HKCU WinINET-indstilling og kræver per-user user-agent.
Hvis du er i en SSH- eller ikke-interaktiv session, kan proxy repair muligvis ikke altid starte user-agent automatisk.

Anbefalet:

panda proxy status
panda proxy repair
panda doctor

Hvis det stadig ikke virker, så prøv igen i en desktop login session.

Linux Phase 1 understøtter primært GNOME gsettings.
Miljøer som KDE / XFCE kan blive vist som unsupported.

Det påvirker ikke nødvendigvis PandaVPN packet runtime, men kan påvirke oplevelsen i system proxy mode.

Betydningen af Kill-switch er, at kun trafik via TUN tillades, mens al anden almindelig trafik blokeres.

proxy mode er en standalone lokal proxytilstand uden packet VPN / TUN og uden tilsvarende DNS- og routingbeskyttelse. Derfor understøtter Kill-switch ikke standalone proxy mode.

Når du har brug for Kill-switch, skal du bruge:

panda mode auto
panda kill-switch on

Eller:

panda mode pandavpn global
panda kill-switch on

Eller:

panda mode wireguard
panda kill-switch on

Nej.

Auto-connect dækker primært best-effort connect, når daemon / service starter, samt pending retry, når netværket midlertidigt ikke er tilgængeligt ved opstart.

Aktivér:

panda config auto-connect on

Deaktivér:

panda config auto-connect off

Det er ikke en generel automatisk genforbindelsesmekanisme under runtime.

Split rules bruges til at angive, at bestemte domæner, nøgleord, regex eller IP skal gå via proxy, direct eller block.

Regelfiler:

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

Almindelige kommandoer:

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

Nuværende kendte begrænsning: efter login bliver pending auto-connect, der venter på retry, ikke automatisk wake.

Det anbefales at køre manuelt efter login:

panda connect

Normalt er det ikke nødvendigt. Ændringer i Split DNS-konfigurationen hot-loades.

Almindelige kommandoer:

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

Hvis platformen ikke understøtter visse local DNS-kilder, giver doctor en warning.

I de nye versioner er Windows Kill-switch opgraderet fra daemon-held dynamic session til persistent WFP filters.
Det betyder, at guard kan bevares efter et unormalt daemon-exit.

Men persistent WFP er ikke det samme som boot-time filter; det meget tidlige opstartsvindue er stadig en del af senere hardening.

Betydningen af Kill-switch er, at kun trafik via TUN tillades, mens al anden almindelig trafik blokeres.

proxy mode er en standalone lokal proxytilstand uden packet VPN / TUN og uden tilsvarende DNS- og routingbeskyttelse. Derfor understøtter Kill-switch ikke standalone proxy mode.

Når du har brug for Kill-switch, skal du bruge:

panda mode auto
panda kill-switch on

Eller:

panda mode pandavpn global
panda kill-switch on

Eller:

panda mode wireguard
panda kill-switch on

Ja.

mode auto + kill-switch on er tilladt, men den endelige sti skal resolve til PandaVPN / WireGuard og må ikke ende i standalone proxy. Hvis der under forbindelsen sker fallback fra WireGuard til PandaVPN, skal guard active også bevares, og der må ikke opstå noget fail-open window.

Anbefalet:

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

Det anbefales ikke.

Kill-switch er en mulighed for forbedret privatlivsbeskyttelse og passer ikke i den korteste brugbare vej. Årsagerne er:

• disconnect slår ikke Kill-switch fra;
• Når den er aktiveret, kan det almindelige netværk blive blokeret;
• Det involverer også LAN-adgang, DNS lockdown, firewall og forskelle i platformsrettigheder;
• Nye brugere kan fejlagtigt tro, at netværket er gået i stykker.

Det anbefales, at nye brugere først gennemfører:

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

Når du har bekræftet, at forbindelsen fungerer normalt, kan du aktivere efter behov:

panda kill-switch on
panda doctor

Nej.

Dette er forventet adfærd. Kill-switch er en vedvarende sikkerhedskontakt, og disconnect afbryder kun den aktuelle runtime; den slår ikke Kill-switch fra automatisk.

Hvis du vil gendanne almindelig netværksadgang, skal du køre:

panda kill-switch off

I strikt tilstand blokerer Kill-switch almindelig LAN / WAN-trafik.
Versioner, der understøtter allow-lan, kan aktivere begrænset LAN-adgang:

panda kill-switch allow-lan on

Slå LAN-tilladelse fra:

panda kill-switch allow-lan off

Bemærk: allow-lan tillader private network / link-local / ULA unicast og v1 discovery, men LAN DNS bør stadig blokeres for at undgå at omgå Panda DNS lockdown.