Честа питања за PandaVPN CLI
Пронађите одговоре и помоћ за решавање проблема за PandaVPN CLI.
Za ovu stranicu još nije objavljen FAQ sadržaj.
ЦЛИ основе и инсталација
10 odgovoraСазнајте шта је ПандаВПН ЦЛИ, по чему се разликује од десктоп апликације и како да је инсталирате.
QШта је Panda CLI?
Panda CLI је Panda клијент командне линије и подржава извршавање следећих радњи преко терминала:
- Пријављивање и управљање налогом
- Освежавање чворова и повезивање са чворовима
- Пребацивање између режима PandaVPN / Proxy / WireGuard / Auto
- Конфигурација системског проксија
- Split rules правила за поделу саобраћаја
- Конфигурација Split DNS-а
- Kill-switch заштита
- Auto-connect
- Евиденције и дијагностика
Погодан је за интерне тест кориснике, програмере, напредне кориснике и тест сценарије који захтевају скриптоване операције.
QКоја је разлика између Panda CLI-ја и десктоп клијента?
PandaVPN CLI је погоднији за аутоматизовано тестирање, удаљено решавање проблема и повезивања којима се управља скриптама.
Panda Desktop и PandaVPN CLI су два контролна интерфејса за исти PandaVPN daemon и деле исто стање везе, па се могу користити заједно.
Немојте истовремено са PandaVPN CLI-јем покретати старије десктоп апликације, као што су Panda-Qt или стари Linux AppImage, јер то може изазвати конфликте у мрежној конфигурацији.
QЗашто је Panda CLI-ју потребан daemon / service?
Неке могућности захтевају дозволе на системском нивоу, на пример:
- Креирање TUN / WireGuard мрежних интерфејса
- Измена DNS-а
- Подешавање системског проксија
- Примена Kill-switch-а
- Поправка рута
- Управљање packet VPN runtime-ом
Зато CLI извршава ове операције преко daemon / service који одговара платформи.
Облици daemon-а на различитим платформама:
| Платформа | Облик daemon-а |
|---|---|
| macOS | LaunchDaemon / privileged helper |
| Linux | systemd service |
| Windows | Windows Service |
QКоја је разлика између начина инсталације за Windows / macOS / Linux?
Кључна разлика је: На Windows-у и macOS-у услуга се обично аутоматски инсталира путем инсталационог пакета, док на Linux-у корисник обично мора ручно да изврши sudo panda service install.
| Платформа | Препоручени начин инсталације | Да ли је потребно ручно инсталирати service? |
|---|---|---|
| Windows | Инсталациони пакет | Обично не; инсталациони пакет ће подићи привилегије и регистровати Windows Service |
| macOS | .pkg инсталациони пакет | Обично не; инсталациони пакет ће инсталирати LaunchDaemon / helper |
| Linux | binary + systemd service | Потребно је извршити sudo panda service install |
На Windows-у, само ако не користите инсталациони пакет и ручно постављате бинарне датотеке, потребно је да у PowerShell-у као администратор извршите:
panda service install windows
На macOS-у, ово је потребно само током развоја и отклањања грешака, када се не користи .pkg инсталациони пакет, или када daemon не стартује аутоматски:
sudo panda start
На Linux-у се препоручује:
sudo panda service install
panda service status
QДа ли су кораци инсталације за Windows ARM64 и AMD64 / x64 исти?
Да, исти су. Разлика је углавном у архитектури инсталационог пакета који се преузима.
| Архитектура | Одговарајући уређаји |
|---|---|
| Windows x64 / AMD64 | Већина Windows рачунара са Intel / AMD процесорима |
| Windows ARM64 | Windows on ARM уређаји |
Кораци инсталације, команде и начин управљања услугом су исти. Инсталатор ће аутоматски подићи привилегије и регистровати Windows Service.
QДа ли су кораци инсталације исти за macOS Intel и Apple Silicon?
Да, исти су. Главна разлика је у архитектури преузетог .pkg пакета.
| Архитектура | Одговарајући уређаји |
|---|---|
| macOS amd64 / Intel | Intel Mac |
| macOS arm64 / Apple Silicon | Apple Silicon Mac, као што су M1 / M2 / M3 |
| macOS universal | Подржава и Intel и Apple Silicon |
Кораци инсталације су исти. Након инсталације помоћу .pkg, LaunchDaemon / helper се обично аутоматски инсталира и покреће.
QКоји је најкраћи пут за почетак коришћења након инсталације?
За глобалне кориснике препоручујемо да се подразумевано користи mode auto:
panda login
panda node refresh
panda mode auto
panda connect
panda doctor
Ако нова инсталација већ подразумевано користи mode auto, може се користити и једноставнија верзија:
panda login
panda node refresh
panda connect
panda doctor
Одговарајућа скраћена верзија:
panda login
panda no re
panda conn
panda do
Званична страница за преузимање и водич за почетнике треба прво да приказују пуне команде; скраћенице се могу приказати касније у напредној документацији или објашњењима интерактивног режима.
QШта се дешава након директног покретања panda?
gfwlist је специфичан извор split правила и није погодан као подразумевани режим за глобалне кориснике.
За глобалне кориснике подразумевано се препоручује:
panda mode auto
Или фиксно користите глобални режим PandaVPN-а:
panda mode pandavpn global
gfwlist може остати у документацији за напредни split routing, али се не препоручује да се приказује на првом екрану званичног сајта, у Hero делу странице за преузимање или у брзом старту за почетнике.
QДа ли треба да се искључим пре надоградње Panda CLI?
Препоручује се да се прво искључите и искључите Kill-switch:
panda disconnect
panda kill-switch off
Ако је у питању ручна надоградња или надоградња Linux service, препоручује се да се заустави и daemon:
sudo panda stop
При надоградњи macOS и Windows помоћу инсталера, инсталер обично аутоматски обрађује инсталацију и поновно покретање service. По завршетку надоградње, препоручује се да покренете:
panda version
panda doctor
panda connect
После ручне надоградње на Linux-у препоручује се:
sudo panda service install
sudo panda service restart
panda version
panda doctor
QКоја је разлика између panda connect us и panda connect svip us?
panda connect us
Означава bare group selector; не фиксира VIP / SVIP / FREE tab, већ API бира одговарајући tab.
panda connect svip us
Означава фиксно коришћење us под SVIP tab.
Форма са двотачком је еквивалентна и погодна за scripts:
panda connect svip:us
favorite tab је тренутно flat favorite channel list и не подржава favorite group smart connect као connect fav us; за favorite користите:
panda connect fav
или:
panda connect --node <NODE_ID>
Начини повезивања и рутирање
10 odgovoraРазумети ЦЛИ режиме повезивања, опције рутирања, паметно повезивање, чворове и тренутни статус.
QКоје режиме подржава Panda CLI?
Углавном подржава:
| Режим | Опис |
|---|---|
auto |
Подразумевани режим. Препоручује runtime на основу API / метаподатака чвора, а при неуспеху се враћа на PandaVPN global |
proxy |
Локални SOCKS5 / HTTP / PAC прокси |
pandavpn |
PandaVPN packet VPN / TUN runtime |
wireguard |
WireGuard packet VPN |
Честа подешавања:
panda mode auto
panda mode pandavpn global
panda mode proxy global
panda mode wireguard
Тренутно се не препоручује да се openvpn приказује као главни режим у корисничкој документацији.
QКако изабрати између auto, proxy, pandavpn и wireguard?
Препорука:
| Сценарио | Препоручени режим |
|---|---|
| Нови корисник / свакодневна веза | auto |
| Желите стално да користите глобални VPN | pandavpn global |
| Желите да само прегледач или системски proxy иде преко Panda | proxy |
| Потребан је Kill-switch | auto, pandavpn или wireguard |
| Чвор обезбеђује WireGuard metadata | auto или wireguard |
| Потребна је дубинска провера Split rules / Split DNS | pandavpn |
Напомена: mode proxy и Kill-switch се међусобно искључују.
QШта је mode auto?
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
QКоја је разлика између global, gfwlist, direct-region и proxy-region?
| Policy | Значење |
|---|---|
global | Све иде преко proxy / tunnel |
gfwlist | default direct; поклапања са GFWList иду преко proxy / tunnel |
direct-region in | default proxy / tunnel; када се поклопи двословни код земље in, користи се директна веза |
proxy-region us | default direct; када се поклопи двословни код земље us, саобраћај иде преко proxy / tunnel |
direct-region је препоручени запис; bypass-region / bypass су компатибилни alias-и.
На пример:
panda mode pandavpn direct-region in
Еквивалентно је компатибилном alias-у:
panda mode pandavpn bypass-region in
QКоја је експлицитна дуга split команда за PandaVPN?
Нова верзија подржава потпунију split profile синтаксу:
panda mode pandavpn split default direct proxy-region <cc>
panda mode pandavpn split default proxy direct-region <cc>
Чести token-и:
| Token | Значење |
|---|---|
default direct |
Ако ниједно правило не одговара, подразумевано је директна веза |
default proxy |
Ако ниједно правило не одговара, подразумевано се користи тунел |
proxy-region <cc> |
Наведени регион иде кроз тунел |
direct-region <cc> |
Наведени регион користи директну везу |
gfwlist |
Омогућава GFWList source |
direct-lan |
LAN користи директну везу |
proxy-lan |
LAN такође иде кроз тунел |
custom-rules |
Омогућава прилагођене split rules |
exclude-custom-rules |
Не учитава прилагођене split rules |
Примери:
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 документацију.
QКако приказати све чворове?
Приказ свих чворова:
panda node list
Освежите па поново прикажите:
panda node refresh
panda node list
Кратки запис:
panda no re
panda no list
Приказ одређеног региона или групе:
panda node list us
panda node list jp
panda node list de
Приказ група чворова:
panda node group
Приказ детаља одређене групе:
panda node group show us
QКако се повезати са одређеним node?
Прво пронађите node:
panda node list us
Затим се повежите:
panda connect --node 1822
Можете се повезати и по имену:
panda connect --node "US Node"
Кратки запис:
panda no list us
panda conn --node 1822
QНа шта се panda connect повезује када се покрене без параметара?
panda connect користи последњу мету.
Ако нема претходне мете, покушаће global smart connect.
Smart connect захтева:
- да сте пријављени;
- да је директоријум чворова кеширан;
- по потреби прво покрените
panda node refresh.
Кратки запис:
panda conn
QЗашто smart connect не успева?
Чести разлози:
- још нисте пријављени;
- директоријум чворова није освежен;
- тренутни налог нема доступне чворове;
- мрежа није доступна;
- daemon није покренут;
- тренутни mode није компатибилан са циљним чвором;
- у
mode auto, препоручени протокол није успео да се покрене, а fallback је такође неуспео.
Препоручена провера:
panda account
panda node refresh
panda node list
panda mode
panda doctor
panda log --lines 200
QКако да видим тренутни статус везе?
panda status
Структурирани излаз:
panda status --json
Кратки запис:
panda stat
Diagnostics and logs
9 odgovoraКористите ова питања за доктора, поправку, евиденцију, системски прокси, правила за подјелу, подијељени ДНС и понашање прекидача за убијање.
QЧему служи panda doctor?
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
QШта је panda trace?
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.
QЗашто се два Panda daemon такмиче за route?
Обично се то дешава зато што је инсталиран званични 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 као свакодневни начин покретања.
QКако да изађем из Panda daemon?
Ако само желите да прекинете VPN, није потребно да излазите из daemon:
panda disconnect
panda kill-switch off
Ако заиста желите да зауставите daemon:
sudo panda stop
Потврда:
panda status
Ако се прикаже panda daemon unavailable, то значи да је главни daemon заустављен.
Напомена: LaunchDaemon / helper инсталиран преко macOS .pkg може бити под управљањем система; обичним корисницима се не препоручује да често ручно заустављају сервис.
QКако да прегледам logs?
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
QКада треба користити panda repair?
QШта урадити ако су AirDrop / Continuity погођени на macOS-у?
У no-tunnel IPv6 сценарију, awdl0 / llw0 могу бити block, због чега AirDrop / Continuity могу привремено бити недоступни.
Обично се опоравља након disconnect.
Ако је и даље неуобичајено, препоручује се:
panda disconnect
panda kill-switch off
panda repair
panda doctor
QШта је TCP Fast Open конфигурација?
Подржане верзије могу ово да конфигуришу:
panda config tcp-fast-open auto
panda config tcp-fast-open on
panda config tcp-fast-open off
Објашњење:
- Подразумевано се препоручује
auto; - После измене неће бити hot reconnect;
- Потребан је reconnect да би важило за нови TCP socket;
- Nodes који не подржавају TFO не би требало да покажу очигледно погоршање латенције повезивања.
Ако тренутна верзија нема ову конфигурациону опцију, водите се са panda config --help или стварним CLI help.
QШта је Privacy mode?
Privacy mode се може разумети као строжи безбедносни режим и препоручује се да буде еквивалентан овоме:
panda mode pandavpn global
panda kill-switch on
Или, уз подразумевани аутоматски избор протокола:
panda mode auto
panda kill-switch on
У Privacy mode препоручују се следећа ограничења:
- Не подржава proxy mode;
- Не подржава split mode;
- Дозвољава само VPN global семантику;
- Kill-switch мора бити омогућен;
- Обични egress је блокиран.
Proxy and repair
5 odgovoraКористите ова питања за доктора, поправку, евиденцију, системски прокси, правила за подјелу, подијељени ДНС и понашање прекидача за убијање.
QКоја је разлика између panda repair и panda proxy repair?
panda repair је свеобухватнији и може да поправи:
- VPN route
- DNS snapshot
- Kill-switch guard
- стања повезана са system proxy
panda proxy repair углавном поправља system proxy drift тренутног корисника.
panda repair
panda proxy repair
QДа ли је system proxy подразумевано укључен?
При 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.
QЗашто system proxy не ступа на снагу на Windows-у?
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.
QЗашто се system proxy на Linux-у приказује као unsupported?
Linux Phase 1 углавном подржава GNOME gsettings.
Окружења као што су KDE / XFCE могу се приказати као unsupported.
То не мора нужно да утиче на PandaVPN packet runtime, али може утицати на искуство system proxy mode.
QЗашто Kill-switch не може да се користи заједно са 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
Split rules and Kill-switch
11 odgovoraКористите ова питања за доктора, поправку, евиденцију, системски прокси, правила за подјелу, подијељени ДНС и понашање прекидача за убијање.
QДа ли Auto-connect значи аутоматско поновно повезивање након прекида везе?
Не.
Auto-connect углавном покрива best-effort connect при покретању daemon / service, као и pending retry када мрежа привремено није доступна при покретању.
Укључивање:
panda config auto-connect on
Искључивање:
panda config auto-connect off
То није општи runtime механизам за аутоматско поновно повезивање.
QШта су Split rules?
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
QДа ли ће се pending auto-connect аутоматски покренути након пријаве?
Тренутно познато ограничење: након login, pending auto-connect који чека retry неће се аутоматски wake.
Препоручује се да након login ручно покренете:
panda connect
QКоју синтаксу подржавају Split rules?
- Pattern
- Bare domain
- Пример
example.com- Значење
- Suffix поклапање
- Pattern
domain:- Пример
domain:api.example.com- Значење
- Тачан host
- Pattern
suffix:- Пример
suffix:google.com- Значење
- Suffix поклапање
- Pattern
||- Пример
||google.com- Значење
- Suffix поклапање
- Pattern
keyword:- Пример
keyword:netflix- Значење
- Substring поклапање
- Pattern
regexp:- Пример
regexp:.*\.cdn\.example\.com- Значење
- Go regex
- Pattern
ip-cidr:- Пример
ip-cidr:10.0.0.0/8- Значење
- IP правило
QДа ли је потребан reconnect након промене Split DNS?
Обично није потребно. Промене 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.
QДа ли Windows WFP Kill-switch и даље ради након рестартовања?
У новим верзијама, Windows Kill-switch је надограђен са daemon-held dynamic session на persistent WFP filters.
То значи да guard може остати након ненормалног изласка daemon.
Међутим, persistent WFP није исто што и boot-time filter; веома рани прозор покретања и даље спада у будући hardening опсег.
QЗашто Kill-switch не може да се користи заједно са 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
QДа ли се mode auto може користити заједно са Kill-switch?
Да.
mode auto + kill-switch on је дозвољено, али коначна путања мора да resolve у PandaVPN / WireGuard и не сме да падне на standalone proxy. Током повезивања, ако дође до fallback-а са WireGuard на PandaVPN, guard active такође мора да остане активан и не сме да се појави fail-open window.
Препоручено:
panda mode auto
panda kill-switch on
panda connect
panda doctor
QДа ли Kill-switch треба да буде подразумевано укључен у брзом почетку за почетнике?
Не препоручује се.
Kill-switch је опција за појачану заштиту приватности и није погодан за најкраћу употребљиву путању. Разлози:
disconnectне искључује Kill-switch;- Након укључивања, уобичајена мрежа може бити блокирана;
- Такође укључује LAN приступ, DNS lockdown, firewall и разлике у дозволама платформи;
- Нови корисници могу погрешно помислити да је мрежа покварена.
Новим корисницима се препоручује да прво заврше:
panda login
panda node refresh
panda mode auto
panda connect
panda doctor
Након што потврдите да веза ради нормално, укључите по потреби:
panda kill-switch on
panda doctor
QДа ли ће disconnect искључити Kill-switch?
Не.
Ово је очекивано понашање. Kill-switch је трајни безбедносни прекидач, а disconnect само прекида тренутни runtime; не искључује Kill-switch аутоматски.
Ако желите да вратите нормалан приступ мрежи, извршите:
panda kill-switch off
QЗашто након укључивања Kill-switch није могућ приступ ни LAN-у?
У строгом режиму, Kill-switch блокира уобичајени LAN / WAN саобраћај.
Верзије које подржавају allow-lan могу да укључе ограничен LAN приступ:
panda kill-switch allow-lan on
Искључивање LAN дозволе:
panda kill-switch allow-lan off
Напомена: allow-lan дозвољава private network / link-local / ULA unicast и v1 discovery, али LAN DNS и даље треба да буде блокиран како би се избегло заобилажење Panda DNS lockdown.
Još uvek vam treba pomoć?
Kontaktirajte PandaVPN podršku sa platformom, verzijom aplikacije, izabranim serverom, kanalom kupovine i tačnom greškom ili snimkom ekrana.
Kontaktiraj podrškuKontaktiraj podršku