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.

Panda CLI betjenes via kommandolinjen og er bedre egnet for:

• Automatisert testing
• Fjernfeilsøking
• Skriptbaserte tilkoblinger
• Visning av detaljert diagnostikkinformasjon
• Validering av lavnivåatferd som Kill-switch, DNS, ruting og systemproxy

Skrivebordsklienten er bedre egnet for vanlige brukeres daglige grafiske operasjoner.

Merk: Det anbefales ikke at den gamle Qt-skrivebordsklienten og CLI administrerer VPN / systemproxy samtidig, for å unngå at de overskriver hverandres konfigurasjon.

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.

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.

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

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.