Честа питања за PandaVPN CLI

Panda CLI је Panda клијент командне линије и подржава извршавање следећих радњи преко терминала:

• Пријављивање и управљање налогом
• Освежавање чворова и повезивање са чворовима
• Пребацивање између режима PandaVPN / Proxy / WireGuard / Auto
• Конфигурација системског проксија
• Split rules правила за поделу саобраћаја
• Конфигурација Split DNS-а
• Kill-switch заштита
• Auto-connect
• Евиденције и дијагностика

Погодан је за интерне тест кориснике, програмере, напредне кориснике и тест сценарије који захтевају скриптоване операције.

Panda CLI ради преко командне линије и погоднији је за:

• Аутоматизовано тестирање
• Даљинско решавање проблема
• Скриптовано повезивање
• Преглед детаљних дијагностичких информација
• Проверу понашања ниског нивоа као што су 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 или провера повезивости не успеју, враћа се на PandaVPN global компајлиран из SS payload;
• SS, OPENVPN, непознати или недостајући протоколи користе PandaVPN global као fallback;
• 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 могућа је само ограничена провера или fallback на 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

Ако и даље нема ефекта, покушајте поново у desktop login session.

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 и routing заштите. Зато 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 се користе да се одреди да одређени домени, кључне речи, 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.