Vanliga frågor om PandaVPN CLI

Panda CLI är Pandas kommandoradsklient och stöder följande via terminalen:

• Inloggning och kontohantering
• Uppdatering av noder och anslutning till noder
• Växling mellan PandaVPN / Proxy / WireGuard / Auto-lägen
• Konfiguration av systemproxy
• Split rules för uppdelning av trafik
• Konfiguration av Split DNS
• Kill-switch-skydd
• Auto-connect
• Loggar och diagnostik

Den passar för interna testanvändare, utvecklare, avancerade användare och testscenarier som kräver skriptade åtgärder.

PandaVPN CLI passar bättre för automatiserade tester, fjärrfelsökning och skriptstyrda anslutningar.

Panda Desktop och PandaVPN CLI är två kontrollgränssnitt för samma PandaVPN daemon och delar samma anslutningsstatus, så de kan användas tillsammans.

Kör inte äldre skrivbordsappar, till exempel Panda-Qt eller den gamla Linux AppImage, samtidigt som PandaVPN CLI, eftersom det kan orsaka konflikter i nätverkskonfigurationen.

Vissa funktioner kräver behörigheter på systemnivå, till exempel:

• Skapa TUN / WireGuard-nätverksgränssnitt
• Ändra DNS
• Ställa in systemproxy
• Tillämpa Kill-switch
• Reparera rutter
• Hantera packet VPN runtime

Därför utför CLI dessa åtgärder via den daemon / service som motsvarar plattformen.

Daemon-former på olika plattformar:

Den viktigaste skillnaden är: På Windows och macOS installeras tjänsten vanligtvis automatiskt via installationspaketet, medan användare på Linux vanligtvis måste köra sudo panda service install manuellt.

På Windows behöver du bara köra följande i PowerShell som administratör om du inte använder installationspaketet och placerar binärfilen manuellt:

panda service install windows

På macOS behövs detta endast vid utveckling och felsökning, när .pkg-installationspaketet inte används, eller när daemon inte startar automatiskt:

sudo panda start

På Linux rekommenderas:

sudo panda service install
panda service status

Ja, de är desamma. Skillnaden ligger främst i arkitekturen för installationspaketet som laddas ned.

Installationsstegen, kommandona och sättet att hantera tjänsten är desamma. Installationsprogrammet höjer automatiskt behörigheterna och registrerar Windows Service.

Ja, de är desamma. Den största skillnaden är arkitekturen för det nedladdade .pkg-paketet.

Installationsstegen är desamma. Efter installation med .pkg installeras och startas LaunchDaemon / helper vanligtvis automatiskt.

För globala användare rekommenderar vi att använda mode auto som standard:

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

Om en ny installation redan använder mode auto som standard kan du även använda en enklare version:

panda login
panda node refresh
panda connect
panda doctor

Motsvarande kortversion:

panda login
panda no re
panda conn
panda do

Den officiella nedladdningssidan och nybörjarguiden bör i första hand visa de fullständiga kommandona; kortformer kan visas senare i avancerad dokumentation eller förklaringar av interaktivt läge.

gfwlist är en specifik källa för split-regler och passar inte som standardläge för globala användare.

För globala användare rekommenderas som standard:

panda mode auto

Eller använd PandaVPNs globala läge fast:

panda mode pandavpn global

gfwlist kan finnas kvar i dokumentationen för avancerad split routing, men det rekommenderas inte att visa den på den officiella webbplatsens första skärm, nedladdningssidans Hero eller i snabbstarten för nybörjare.

Det rekommenderas att först koppla från och stänga av Kill-switch:

panda disconnect
panda kill-switch off

Om det är en manuell uppgradering eller en Linux service-uppgradering rekommenderas det också att stoppa daemon:

sudo panda stop

Vid uppgradering av macOS och Windows med installer hanterar installern vanligtvis service-installation och omstart automatiskt. När uppgraderingen är klar rekommenderas att köra:

panda version
panda doctor
panda connect

Efter en manuell Linux-uppgradering rekommenderas:

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

panda connect us

Det betyder en bare group selector; den låser inte VIP / SVIP / FREE tab, utan API väljer lämplig tab.

panda connect svip us

Det betyder fast användning av us under SVIP tab.

Kolonformen är ekvivalent och lämplig för scripts:

panda connect svip:us

favorite tab är för närvarande en flat favorite channel list och stöder inte favorite group smart connect som connect fav us; för favorite, använd:

panda connect fav

eller:

panda connect --node <NODE_ID>

Stöder främst:

Vanliga inställningar:

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

openvpn rekommenderas för närvarande inte att visas som huvudläge i användardokumentationen.

Rekommendation:

Obs: mode proxy och Kill-switch är ömsesidigt uteslutande.

mode auto är standardläget i den nya versionen.

Dess beteende är:

• API node / smart connect väljer runtime med prioritet baserat på meta.protocol;
• Om WireGuard rekommenderas försöks WireGuard först;
• Om WireGuard-metadata, adresstilldelning, runtime-start, handshake eller anslutningskontroll misslyckas faller den tillbaka till PandaVPN global kompilerad från SS payload;
• SS, OPENVPN, okända eller saknade protokoll använder PandaVPN global som fallback;
• mode auto accepterar inte en policy-parameter, och den lösta runtime är alltid global.

Rekommenderas för nya användare:

panda mode auto
panda connect

direct-region är den rekommenderade syntaxen; bypass-region / bypass är kompatibilitetsalias.

Exempel:

panda mode pandavpn direct-region in

Motsvarar kompatibilitetsaliaset:

panda mode pandavpn bypass-region in

Den nya versionen stöder en mer komplett split profile-syntax:

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

Vanliga token:

Exempel:

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 rekommenderas inte att visa långa kommandon i nybörjardokumentation; de passar bättre i avancerad split-dokumentation.

Visa alla noder:

panda node list

Uppdatera och visa sedan igen:

panda node refresh
panda node list

Kortform:

panda no re
panda no list

Visa en viss region eller grupp:

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

Visa nodgrupper:

panda node group

Visa detaljer för en viss grupp:

panda node group show us

Sök först efter node:

panda node list us

Anslut sedan:

panda connect --node 1822

Du kan också ansluta med namn:

panda connect --node "US Node"

Kortform:

panda no list us
panda conn --node 1822

panda connect använder det senaste målet.
Om det inte finns något tidigare mål försöker den med global smart connect.

Smart connect kräver:

• att du är inloggad;
• att node-katalogen är cachad;
• vid behov, kör först panda node refresh.

Kortform:

panda conn

Vanliga orsaker:

• du är inte inloggad ännu;
• node-katalogen har inte uppdaterats;
• det aktuella kontot har inga tillgängliga noder;
• nätverket är inte tillgängligt;
• daemon körs inte;
• nuvarande mode är inte kompatibelt med målnoden;
• i mode auto misslyckades den rekommenderade protokollet att starta och fallback misslyckades också.

Rekommenderad kontroll:

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

panda status

Strukturerad utdata:

panda status --json

Kortform:

panda stat

doctor är ett skrivskyddat diagnostikkommando som används för att visa aktuell nyckelstatus för Panda CLI.

panda doctor
panda doctor --json

Kortform:

panda do

Fokusera särskilt på:

runtime
kill_switch
selected_node
vpn_dns
dns_lockdown
split_policy
system_proxy_state
vpn_routes
last_error

trace används för att se vilken regel, DNS action och route ett visst mål kommer att använda.

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

Obs: full trace-funktionalitet kräver active PandaVPN packet runtime. Utan kompatibel runtime är endast begränsad validering möjlig, eller fallback till legacy trace.

Det händer vanligtvis eftersom den officiella service / LaunchDaemon är installerad och du dessutom har kört manuellt:

sudo panda start

sudo panda start startar en unmanaged / ohanterad daemon, som kan hantera följande samtidigt som den officiella daemon:

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

Principen är: behåll endast en daemon.

Vanlig hantering på macOS / Linux:

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

På Linux, om du använder systemd service, starta därefter om den officiella tjänsten:

sudo panda service restart
panda doctor

På macOS, om installationen gjorts med .pkg, låt vanligtvis LaunchDaemon / helper hantera daemon och använd inte sudo panda start långsiktigt som daglig startmetod.

Om du bara vill koppla från VPN behöver du inte avsluta daemon:

panda disconnect
panda kill-switch off

Om du verkligen vill stoppa daemon:

sudo panda stop

Bekräfta:

panda status

Om panda daemon unavailable visas betyder det att huvud-daemon har stoppats.

Obs: LaunchDaemon / helper som installerats via macOS .pkg kan hanteras av systemet; vanliga användare bör inte stoppa tjänsten manuellt ofta.

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

Rensa logs:

panda log clear

Aktivera debug tillfälligt:

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

Återställ standard:

panda log level reset

I ett no-tunnel IPv6-scenario kan awdl0 / llw0 bli block, vilket gör AirDrop / Continuity tillfälligt otillgängliga.
Vanligtvis återställs det efter disconnect.

Om det fortfarande är onormalt, rekommenderas:

panda disconnect
panda kill-switch off
panda repair
panda doctor

Versioner som stöder detta kan konfigureras:

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

Förklaring:

• Som standard rekommenderas auto;
• Ändringen utlöser inte hot reconnect;
• Reconnect krävs för att det ska gälla nya TCP socket;
• Nodes som inte stöder TFO bör inte visa någon tydlig regression i anslutningslatens.

Om den aktuella versionen inte har detta konfigurationsalternativ, följ panda config --help eller den faktiska CLI help.

Privacy mode kan förstås som ett striktare säkerhetsläge och rekommenderas vara ekvivalent med:

panda mode pandavpn global
panda kill-switch on

Eller vid standardmässigt automatiskt protokollval:

panda mode auto
panda kill-switch on

I Privacy mode rekommenderas följande begränsningar:

• Stöder inte proxy mode;
• Stöder inte split mode;
• Tillåter endast VPN global-semantik;
• Kill-switch måste vara aktiverat;
• Vanlig egress blockeras.

panda repair är mer omfattande och kan reparera:

• VPN route
• DNS snapshot
• Kill-switch guard
• system proxy-relaterat tillstånd

panda proxy repair reparerar främst system proxy drift för den aktuella användaren.

panda repair
panda proxy repair

Vid Fresh install är standard proxy system-proxy on.
Om användaren uttryckligen har sparat off bevaras den konfigurationen.

Visa eller ställ in:

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

Obs: under mode auto, pandavpn och wireguard ignorerar VPN runtime den persistenta system proxy-inställningen; VPN companion proxy är fortfarande tillgänglig och använder scoped egress.

Windows system proxy är den aktuella användarens HKCU WinINET-inställning och kräver per-user user-agent.
Om du är i en SSH- eller icke-interaktiv session kan proxy repair inte alltid starta user-agent automatiskt.

Rekommenderat:

panda proxy status
panda proxy repair
panda doctor

Om det fortfarande inte träder i kraft, försök igen i en desktop login session.

Linux Phase 1 stöder främst GNOME gsettings.
Miljöer som KDE / XFCE kan visas som unsupported.

Detta påverkar inte nödvändigtvis PandaVPN packet runtime, men kan påverka upplevelsen av system proxy mode.

Betydelsen av Kill-switch är att endast tillåta trafik via TUN, medan annan vanlig trafik blockeras.

proxy mode är ett standalone lokalt proxyläge, utan packet VPN / TUN och utan motsvarande DNS- och routingskydd. Därför stöder Kill-switch inte standalone proxy mode.

När du behöver Kill-switch, använd:

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 täcker främst best-effort connect när daemon / service startar, samt pending retry när nätverket tillfälligt inte är tillgängligt vid start.

Aktivera:

panda config auto-connect on

Inaktivera:

panda config auto-connect off

Det är inte en generell mekanism för automatisk återanslutning under runtime.

Split rules används för att ange att vissa domäner, nyckelord, regex eller IP ska gå via proxy, direct eller block.

Regelfiler:

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

Vanliga kommandon:

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

Nuvarande kända begränsning: efter login kommer pending auto-connect som väntar på retry inte att wake automatiskt.

Efter login rekommenderas att du kör manuellt:

panda connect

Vanligtvis inte. Ändringar i Split DNS-konfigurationen hot-loadas.

Vanliga kommandon:

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

Om plattformen inte stöder vissa local DNS-källor visar doctor en warning.

I nya versioner har Windows Kill-switch uppgraderats från daemon-held dynamic session till persistent WFP filters.
Det betyder att guard kan finnas kvar efter att daemon avslutas onormalt.

Men persistent WFP är inte samma sak som boot-time filter; det mycket tidiga startfönstret ingår fortfarande i framtida hardening.

Betydelsen av Kill-switch är att endast tillåta trafik via TUN, medan annan vanlig trafik blockeras.

proxy mode är ett standalone lokalt proxyläge, utan packet VPN / TUN och utan motsvarande DNS- och routingskydd. Därför stöder Kill-switch inte standalone proxy mode.

När du behöver Kill-switch, använd:

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 är tillåtet, men den slutliga sökvägen måste resolve till PandaVPN / WireGuard och får inte hamna på standalone proxy. Under anslutningen, om fallback sker från WireGuard till PandaVPN, måste guard active också behållas och inget fail-open window får uppstå.

Rekommenderas:

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

Rekommenderas inte.

Kill-switch är ett alternativ för förstärkt integritetsskydd och passar inte i den kortaste användbara vägen. Skäl:

• disconnect stänger inte av Kill-switch;
• Efter aktivering kan det vanliga nätverket blockeras;
• Det involverar också LAN-åtkomst, DNS lockdown, firewall och skillnader i plattformsbehörigheter;
• Nya användare kan felaktigt tro att nätverket är trasigt.

Nya användare rekommenderas att först slutföra:

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

Efter att ha bekräftat att anslutningen fungerar normalt, aktivera vid behov:

panda kill-switch on
panda doctor

Nej.

Detta är förväntat beteende. Kill-switch är en beständig säkerhetsbrytare, och disconnect kopplar bara från aktuell runtime; den stänger inte av Kill-switch automatiskt.

För att återställa normal nätverksåtkomst, kör:

panda kill-switch off

I strikt läge blockerar Kill-switch vanlig LAN / WAN-trafik.
Versioner som stöder allow-lan kan aktivera begränsad LAN-åtkomst:

panda kill-switch allow-lan on

Stäng av LAN-tillåtelse:

panda kill-switch allow-lan off

Obs: allow-lan tillåter private network / link-local / ULA unicast och v1 discovery, men LAN DNS bör fortfarande blockeras för att undvika att Panda DNS lockdown kringgås.