Запитання й відповіді 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 — сумісні псевдоніми.

Наприклад:

panda mode pandavpn direct-region in

Еквівалентно сумісному псевдоніму:

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

Якщо все ще не застосовується, спробуйте ще раз у сесії входу на робочий стіл.

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.