ЧЗВ за PandaVPN CLI
Намерете отговори и помощ за отстраняване на проблеми за PandaVPN CLI.
За тази страница все още няма публикувано FAQ съдържание.
CLI основи и инсталация
10 отговораНаучете какво представлява PandaVPN CLI, как се различава от настолното приложение и как да го инсталирате.
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 и споделят едно и също състояние на връзката, така че могат да се използват заедно.
Не стартирайте стари настолни приложения, като Panda-Qt или стария Linux AppImage, едновременно с PandaVPN CLI, тъй като това може да причини конфликти в мрежовата конфигурация.
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 е специфичен източник на правила за разделяне на трафика и не е подходящ като режим по подразбиране за потребители по целия свят.
За глобални потребители се препоръчва по подразбиране:
panda mode auto
Или фиксирано използване на глобалния режим на PandaVPN:
panda mode pandavpn global
gfwlist може да остане в документацията за разширено разделяне на трафика, но не се препоръчва да се показва в първия екран на официалния сайт, в 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.
Формата с двоеточие е еквивалентна и е подходяща за скриптове:
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 отговораРазберете CLI режимите на свързване, опциите за маршрутизиране, интелигентното свързване, възлите и текущото състояние.
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 |
| Искате само браузърът или системният прокси да минава през 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 като резервен вариант;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 са съвместими псевдоними.
Например:
panda mode pandavpn direct-region in
Еквивалентно на съвместимия псевдоним:
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 отговораИзползвайте тези въпроси за лекар, ремонт, регистрационни файлове, системен прокси, правила за разделяне, разделяне на DNS и поведение при превключване при спиране.
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, може да се направи само ограничена проверка или да се върне към 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, след това рестартирайте официалната услуга:
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;
- При node, които не поддържат 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 отговораИзползвайте тези въпроси за лекар, ремонт, регистрационни файлове, системен прокси, правила за разделяне, разделяне на DNS и поведение при превключване при спиране.
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 отговораИзползвайте тези въпроси за лекар, ремонт, регистрационни файлове, системен прокси, правила за разделяне, разделяне на DNS и поведение при превключване при спиране.
QAuto-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, който чака повторен опит, няма да бъде 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.
Все още имате нужда от помощ?
Свържете се с поддръжката на PandaVPN с вашата платформа, версия на приложението, избран сървър, канал за покупка и точната грешка или екранна снимка.
Свържете се с поддръжкатаСвържете се с поддръжката