PandaVPN CLI命令列客戶端

面向開發者、進階用戶與自動化測試場景打造。透過終端即可完成登入、節點刷新、VPN 模式切換、Kill Switch 配置、連線與日誌診斷。

Windows 和 macOS 安裝包會自動註冊背景服務,Linux 用戶可透過命令手動安裝 systemd service。

panda@terminal
panda>mode pandavpn globalpanda>connect[Success] Connected to <NODE_ID>.panda>doctor[OK] Runtime healthy.

選擇適合你的 CLI 版本

根據你的作業系統和處理器架構下載 PandaVPN CLI,並按照對應系統的快速開始步驟完成安裝、登入、節點刷新、模式切換、連線和診斷。

macOS

版本:2.1.1更新:

系統說明

適用於 macOS 用戶。安裝包會自動完成必要的權限申請、背景 daemon 安裝與啟動。

更新內容

  • 1. 優化 Automatic、PandaVPN 及 WireGuard 模式切換,連線更流暢。
  • 2. 優化流量路由及區域網絡設定,減少不必要的重新連線。
  • 3. 新增 VPN 出口 IP 資訊,支援適用的 IPv4 及 IPv6 連線。
  • 4. 改善連線恢復能力,提升整體網絡可靠性。
查看版本說明 →

安裝說明

  1. 下載對應架構的 .pkg 安裝包。
  2. 按兩下開啟安裝包,並按提示完成安裝。
  3. 安裝包會自動安裝並啟動背景 daemon。
  4. 安裝完成後,開啟 Terminal 即可使用 panda 命令。

快速開始

# 1. 查看幫助
panda help

# 2. 登入帳號
panda login

# 3. 刷新節點目錄
panda node refresh

# 4. 設定 PandaVPN 全域模式
panda mode pandavpn global

# 5. 可選開啟 Kill Switch
panda kill-switch on

# 6. 一鍵連線
panda connect

# 7. 查看診斷狀態
panda doctor

# 8. 修復網絡配置異常
panda repair

Linux

版本:2.1.1更新:

系統說明

適用於 Linux 用戶。Linux 版本提供 CLI 二進制檔,需要用戶手動安裝背景 systemd service。

下載

更新內容

  • 1. 優化 Automatic、PandaVPN 及 WireGuard 模式切換,連線更流暢。
  • 2. 優化流量路由及區域網絡設定,減少不必要的重新連線。
  • 3. 新增 VPN 出口 IP 資訊,支援適用的 IPv4 及 IPv6 連線。
  • 4. 改善連線恢復能力,提升整體網絡可靠性。
查看版本說明 →

安裝說明

  1. 下載對應架構的 Linux CLI 檔案。
  2. 解壓或放置到系統可執行路徑。
  3. 執行 sudo panda service install 安裝背景 systemd service。
  4. 安裝完成後,即可使用 panda 命令登入、刷新節點、連線和診斷。

快速開始

# 1. 安裝背景服務
sudo panda service install

# 2. 查看幫助
panda help

# 3. 登入帳號
panda login

# 4. 刷新節點目錄
panda node refresh

# 5. 設定 PandaVPN 全域模式
panda mode pandavpn global

# 6. 可選開啟 Kill Switch
sudo panda kill-switch on

# 7. 一鍵連線
panda connect

# 8. 查看診斷狀態
panda doctor

# 9. 修復網絡配置異常
panda repair

Windows

版本:2.1.1更新:

系統說明

適用於 Windows 用戶。安裝包會自動申請管理員權限,並註冊 PandaVPN CLI 背景 Windows Service。

更新內容

  • 1. 優化 Automatic、PandaVPN 及 WireGuard 模式切換,連線更流暢。
  • 2. 優化流量路由及區域網絡設定,減少不必要的重新連線。
  • 3. 新增 VPN 出口 IP 資訊,支援適用的 IPv4 及 IPv6 連線。
  • 4. 改善連線恢復能力,提升整體網絡可靠性。
查看版本說明 →

安裝說明

  1. 下載對應架構的 Windows 安裝包。
  2. 按兩下執行安裝包,並按提示完成安裝。
  3. 安裝包會自動申請管理員權限,並註冊背景 Windows Service。
  4. 安裝完成後,開啟 PowerShell 或 Terminal 即可使用 panda 命令。

快速開始

# 1. 查看幫助
panda help

# 2. 登入帳號
panda login

# 3. 刷新節點目錄
panda node refresh

# 4. 設定 PandaVPN 全域模式
panda mode pandavpn global

# 5. 可選開啟 Kill Switch
panda kill-switch on

# 6. 一鍵連線
panda connect

# 7. 查看診斷狀態
panda doctor

# 8. 修復網絡配置異常
panda repair

建議先執行 panda help 查看支援的命令。互動模式下可不帶參數執行 panda,並按 Tab 補全命令。若 routes、DNS、system proxy 或 Kill Switch 狀態被意外修改或遺失,請執行 panda repair 恢復 Panda 管理的網絡配置。

為進階網絡場景而生

智能連接與運行時支持

自動選擇推薦的連接方式,並在需要時進行 fallback。支援 PandaVPN 和 WireGuard runtime,適配不同網絡環境。

路由、DNS 與防洩露保護

支援全局路由、GFWList、direct-region、proxy-region、自定義分流規則、DNS 策略、fake-IP DNS,以及帶 LAN 訪問控制的嚴格 Kill Switch。

自動化與診斷友好

支援 JSON 輸出,並提供 doctor、status、trace、watch、log 等命令,便於腳本化、監控和故障排查。

常見問題解答

Panda CLI 與桌面用戶端有甚麼區別?

PandaVPN CLI 更適合自動化測試、遠端故障排查,以及透過指令碼控制連接。

Panda Desktop 和 PandaVPN CLI 是同一個 PandaVPN daemon 的兩個控制入口,共用同一個連接狀態,因此可以配合使用。

請勿同時運行 PandaVPN CLI 與 Panda-Qt、舊版 Linux AppImage 等舊版桌面客戶端,否則可能導致網絡設定衝突。

為什麼安裝後需要系統級權限?

建立 TUN 介面、修改系統 DNS、應用 Kill Switch 等進階防護功能均需系統級權限,因此會在背景運行對應的平台 daemon / service。

為什麼 Kill Switch 不能和 proxy 模式一起用?

Kill Switch 旨在只允許流量經過 TUN 隧道並阻斷其餘流量。standalone proxy 模式沒有 TUN 介面,因此二者互斥,請切換至 pandavpn 或 wireguard 模式使用。