Vanlige spørsmål om PandaVPN CLI

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

• Innlogging og kontoadministrasjon
• Oppdatering av noder og tilkobling til noder
• Bytte mellom PandaVPN / Proxy / WireGuard / Auto-moduser
• Konfigurasjon av systemproxy
• Split rules for trafikkdeling
• Konfigurasjon av Split DNS
• Kill-switch-beskyttelse
• Auto-connect
• Logger og diagnostikk

Den passer for interne testbrukere, utviklere, avanserte brukere og testscenarioer som krever skriptede operasjoner.

PandaVPN CLI er bedre egnet for automatisert testing, ekstern feilsøking og skriptstyrte tilkoblinger.

Panda Desktop og PandaVPN CLI er to kontrollgrensesnitt for den samme PandaVPN daemon og deler samme tilkoblingsstatus, så de kan brukes sammen.

Ikke kjør eldre skrivebordsapper, som Panda-Qt eller den gamle Linux AppImage, samtidig med PandaVPN CLI, da dette kan føre til konflikter i nettverkskonfigurasjonen.

Noen funksjoner krever tillatelser på systemnivå, for eksempel:

• Opprette TUN / WireGuard-nettverksgrensesnitt
• Endre DNS
• Angi systemproxy
• Bruke Kill-switch
• Reparere ruter
• Administrere packet VPN runtime

Derfor utfører CLI disse operasjonene via plattformens tilhørende daemon / service.

Daemon-former på ulike plattformer:

Hovedforskjellen er: På Windows og macOS installeres tjenesten vanligvis automatisk via installasjonspakken, mens brukere på Linux vanligvis må kjøre sudo panda service install manuelt.

På Windows trenger du bare å kjøre følgende i PowerShell som administrator hvis du ikke bruker installasjonspakken og plasserer binærfilen manuelt:

panda service install windows

På macOS er dette bare nødvendig ved utvikling og feilsøking, når .pkg-installasjonspakken ikke brukes, eller når daemon ikke starter automatisk:

sudo panda start

På Linux anbefales:

sudo panda service install
panda service status

Ja, de er de samme. Forskjellen ligger hovedsakelig i arkitekturen til installasjonspakken som lastes ned.

Installasjonstrinnene, kommandoene og måten å administrere tjenesten på er de samme. Installasjonspakken vil automatisk heve rettigheter og registrere Windows Service.

Ja, de er de samme. Hovedforskjellen er arkitekturen til den nedlastede .pkg-pakken.

Installasjonstrinnene er de samme. Etter installasjon med .pkg installeres og startes LaunchDaemon / helper vanligvis automatisk.

For globale brukere anbefaler vi å bruke mode auto som standard:

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

Hvis en ny installasjon allerede bruker mode auto som standard, kan du også bruke en enklere versjon:

panda login
panda node refresh
panda connect
panda doctor

Tilsvarende kortversjon:

panda login
panda no re
panda conn
panda do

Den offisielle nedlastingssiden og nybegynnerveiledningen bør prioritere å vise fullstendige kommandoer; kortformer kan vises senere i avansert dokumentasjon eller forklaringer av interaktiv modus.

gfwlist er en spesifikk kilde for split-regler og passer ikke som standardmodus for globale brukere.

For globale brukere anbefales som standard:

panda mode auto

Eller bruk PandaVPNs globale modus fast:

panda mode pandavpn global

gfwlist kan beholdes i dokumentasjonen for avansert split routing, men det anbefales ikke at den vises på den offisielle nettsidens første skjerm, nedlastingssidens Hero eller i hurtigstarten for nybegynnere.

Det anbefales å koble fra først og slå av Kill-switch:

panda disconnect
panda kill-switch off

Hvis det er en manuell oppgradering eller en Linux service-oppgradering, anbefales det også å stoppe daemon:

sudo panda stop

Ved oppgradering av macOS og Windows med installasjonspakke håndterer installasjonspakken vanligvis service-installasjon og omstart automatisk. Når oppgraderingen er fullført, anbefales det å kjøre:

panda version
panda doctor
panda connect

Etter manuell oppgradering på Linux anbefales:

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

panda connect us

Dette betyr en bare group selector; den låser ikke VIP / SVIP / FREE tab, og API velger passende tab.

panda connect svip us

Dette betyr fast bruk av us under SVIP tab.

Kolonformen er ekvivalent og egnet for scripts:

panda connect svip:us

favorite tab er for øyeblikket en flat favorite channel list og støtter ikke favorite group smart connect som connect fav us; for favorite, bruk:

panda connect fav

eller:

panda connect --node <NODE_ID>

Støtter hovedsakelig:

Vanlige innstillinger:

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

openvpn anbefales foreløpig ikke vist som hovedmodus i brukerdokumentasjonen.

Anbefaling:

Merk: mode proxy og Kill-switch utelukker hverandre.

mode auto er standardmodus i den nye versjonen.

Den fungerer slik:

• API node / smart connect velger runtime med prioritet basert på meta.protocol;
• Hvis WireGuard anbefales, prøves WireGuard først;
• Hvis WireGuard-metadata, adressetildeling, runtime-oppstart, handshake eller tilkoblingskontroll mislykkes, faller den tilbake til PandaVPN global kompilert fra SS payload;
• SS, OPENVPN, ukjente eller manglende protokoller bruker PandaVPN global som fallback;
• mode auto aksepterer ikke en policy-parameter, og den løste runtime er alltid global.

Anbefales for nye brukere:

panda mode auto
panda connect

direct-region er anbefalt skrivemåte; bypass-region / bypass er kompatibilitetsaliaser.

For eksempel:

panda mode pandavpn direct-region in

Tilsvarer kompatibilitetsaliaset:

panda mode pandavpn bypass-region in

Den nye versjonen støtter en mer komplett split profile-syntaks:

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

Vanlige token:

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 å vise lange kommandoer i nybegynnerdokumentasjon; de passer bedre i avansert split-dokumentasjon.

Vis alle noder:

panda node list

Oppdater og vis deretter igjen:

panda node refresh
panda node list

Kortform:

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øk etter node først:

panda node list us

Koble deretter til:

panda connect --node 1822

Du kan også koble til etter navn:

panda connect --node "US Node"

Kortform:

panda no list us
panda conn --node 1822

panda connect bruker det siste målet.
Hvis det ikke finnes et tidligere mål, forsøker den global smart connect.

Smart connect krever:

• at du er logget inn;
• at nodekatalogen er bufret;
• kjør om nødvendig først panda node refresh.

Kortform:

panda conn

Vanlige årsaker:

• du er ikke logget inn ennå;
• nodekatalogen er ikke oppdatert;
• den nåværende kontoen har ingen tilgjengelige noder;
• nettverket er ikke tilgjengelig;
• daemon kjører ikke;
• nåværende mode er ikke kompatibel med målnoden;
• under mode auto mislyktes oppstart av anbefalt protokoll, og fallback mislyktes også.

Anbefalt kontroll:

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

panda status

Strukturert output:

panda status --json

Kortform:

panda stat

doctor er en skrivebeskyttet diagnosekommando som brukes til å se gjeldende nøkkelstatus for Panda CLI.

panda doctor
panda doctor --json

Kortform:

panda do

Fokuser spesielt på:

runtime
kill_switch
selected_node
vpn_dns
dns_lockdown
split_policy
system_proxy_state
vpn_routes
last_error

trace brukes til å se hvilken regel, DNS action og route et bestemt mål vil bruke.

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

Merk: full trace-funksjonalitet krever active PandaVPN packet runtime. Uten kompatibel runtime er bare begrenset validering mulig, eller fallback til legacy trace.

Dette skjer vanligvis fordi den offisielle service / LaunchDaemon er installert, og du også har kjørt manuelt:

sudo panda start

sudo panda start starter en unmanaged / ikke-administrert daemon, som kan administrere følgende samtidig som den offisielle daemon:

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

Prinsippet for håndtering er: behold bare én daemon.

Vanlig håndtering på macOS / Linux:

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

På Linux, hvis du bruker systemd service, starter du deretter den offisielle tjenesten på nytt:

sudo panda service restart
panda doctor

På macOS, hvis installert med .pkg, bør LaunchDaemon / helper vanligvis administrere daemon, og ikke bruk sudo panda start langsiktig som daglig oppstartsmetode.

Hvis du bare vil koble fra VPN, trenger du ikke avslutte daemon:

panda disconnect
panda kill-switch off

Hvis du faktisk vil stoppe daemon:

sudo panda stop

Bekreft:

panda status

Hvis det viser panda daemon unavailable, betyr det at hoved-daemon er stoppet.

Merk: LaunchDaemon / helper installert via macOS .pkg kan være administrert av systemet; vanlige brukere anbefales ikke å stoppe tjenesten manuelt ofte.

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

Tøm logs:

panda log clear

Aktiver debug midlertidig:

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

Gjenopprett standard:

panda log level reset

I et no-tunnel IPv6-scenario kan awdl0 / llw0 bli block, noe som gjør AirDrop / Continuity midlertidig utilgjengelig.
Det gjenopprettes vanligvis etter disconnect.

Hvis det fortsatt er unormalt, anbefales:

panda disconnect
panda kill-switch off
panda repair
panda doctor

Støttede versjoner 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;
• Endringen utløser ikke hot reconnect;
• Reconnect kreves for at det skal gjelde for nye TCP socket;
• Nodes som ikke støtter TFO, bør ikke vise tydelig regresjon i tilkoblingslatens.

Hvis den gjeldende versjonen ikke har dette konfigurasjonsvalget, følg panda config --help eller den faktiske CLI help.

Privacy mode kan forstås som en strengere sikkerhetsmodus, og anbefales som ekvivalent med:

panda mode pandavpn global
panda kill-switch on

Eller, med standard automatisk protokollvalg:

panda mode auto
panda kill-switch on

I Privacy mode anbefales følgende begrensninger:

• Støtter ikke proxy mode;
• Støtter ikke split mode;
• Tillater bare VPN global-semantikk;
• Kill-switch må være aktivert;
• Vanlig egress blokkeres.

panda repair er mer omfattende og kan reparere:

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

panda proxy repair reparerer hovedsakelig system proxy drift for gjeldende bruker.

panda repair
panda proxy repair

Ved Fresh install er standarden proxy system-proxy on.
Hvis brukeren eksplisitt har lagret off, beholdes den konfigurasjonen.

Vis eller angi:

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

Merk: Under mode auto, pandavpn og wireguard ignorerer VPN runtime den lagrede system proxy-preferansen; VPN companion proxy er fortsatt tilgjengelig og bruker scoped egress.

Windows system proxy er gjeldende brukers HKCU WinINET-innstilling og krever per-user user-agent.
Hvis du er i en SSH- eller ikke-interaktiv økt, kan proxy repair ikke alltid starte user-agent automatisk.

Anbefalt:

panda proxy status
panda proxy repair
panda doctor

Hvis det fortsatt ikke trer i kraft, prøv igjen i en desktop login session.

Linux Phase 1 støtter hovedsakelig GNOME gsettings.
Miljøer som KDE / XFCE kan vises som unsupported.

Dette påvirker ikke nødvendigvis PandaVPN packet runtime, men kan påvirke opplevelsen av system proxy mode.

Betydningen av Kill-switch er å tillate trafikk bare gjennom TUN, mens annen vanlig trafikk blokkeres.

proxy mode er en standalone lokal proxy-modus uten packet VPN / TUN og uten tilsvarende DNS- og rutingbeskyttelse. Derfor støtter Kill-switch ikke standalone proxy mode.

Når du trenger Kill-switch, bruk:

panda mode auto
panda kill-switch on

Eller:

panda mode pandavpn global
panda kill-switch on

Eller:

panda mode wireguard
panda kill-switch on

Nei.

Auto-connect dekker hovedsakelig best-effort connect når daemon / service starter, samt pending retry når nettverket midlertidig ikke er tilgjengelig ved oppstart.

Aktiver:

panda config auto-connect on

Deaktiver:

panda config auto-connect off

Det er ikke en generell automatisk gjenoppkoblingsmekanisme under runtime.

Split rules brukes til å angi at bestemte domener, nøkkelord, regex eller IP-er skal gå via proxy, direct eller block.

Regelfiler:

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

Vanlige 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

Nåværende kjent begrensning: etter login blir pending auto-connect som venter på retry, ikke automatisk wake.

Etter login anbefales det å kjøre manuelt:

panda connect

Vanligvis ikke. Endringer i Split DNS-konfigurasjonen hot-loades.

Vanlige 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 plattformen ikke støtter enkelte local DNS-kilder, viser doctor en warning.

I nyere versjoner er Windows Kill-switch oppgradert fra daemon-held dynamic session til persistent WFP filters.
Dette betyr at guard kan bli værende etter at daemon avsluttes unormalt.

Men persistent WFP er ikke det samme som boot-time filter; det svært tidlige oppstartsvinduet er fortsatt en del av fremtidig hardening.

Betydningen av Kill-switch er å tillate trafikk bare gjennom TUN, mens annen vanlig trafikk blokkeres.

proxy mode er en standalone lokal proxy-modus uten packet VPN / TUN og uten tilsvarende DNS- og rutingbeskyttelse. Derfor støtter Kill-switch ikke standalone proxy mode.

Når du trenger Kill-switch, bruk:

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 tillatt, men den endelige path må resolve til PandaVPN / WireGuard og må ikke falle til standalone proxy. Under tilkobling, hvis den faller tilbake fra WireGuard til PandaVPN, må guard active også beholdes, og det må ikke oppstå noe fail-open window.

Anbefalt:

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

Anbefales ikke.

Kill-switch er et alternativ for forbedret personvern og passer ikke i den korteste brukbare veien. Årsaker:

• disconnect slår ikke av Kill-switch;
• Etter aktivering kan vanlig nettverk bli blokkert;
• Det involverer også LAN-tilgang, DNS lockdown, firewall og forskjeller i plattformtillatelser;
• Nye brukere kan feilaktig tro at nettverket er ødelagt.

Nye brukere anbefales å fullføre dette først:

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

Etter at du har bekreftet at tilkoblingen fungerer normalt, aktiver ved behov:

panda kill-switch on
panda doctor

Nei.

Dette er forventet oppførsel. Kill-switch er en vedvarende sikkerhetsbryter, og disconnect kobler bare fra gjeldende runtime; den slår ikke av Kill-switch automatisk.

For å gjenopprette vanlig nettverkstilgang, kjør:

panda kill-switch off

I streng modus blokkerer Kill-switch vanlig LAN / WAN-trafikk.
Versjoner som støtter allow-lan kan aktivere begrenset LAN-tilgang:

panda kill-switch allow-lan on

Slå av LAN-tillatelse:

panda kill-switch allow-lan off

Merk: allow-lan tillater private network / link-local / ULA unicast og v1 discovery, men LAN DNS bør fortsatt blokkeres for å unngå å omgå Panda DNS lockdown.