PandaVPN CLI命令行客户端

面向开发者、AI Agent、高级用户和自动化工作流。通过命令行管理 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. 安装完成后,打开终端即可使用 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 或终端即可使用 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 模式使用。