logo 您的 IP 地址:未知 · 您当前的状态: 未保护 要隐藏您的 IP 地址,您需要下载 PandaVPN 并连接至一台服务器。

PandaVPN CLI 命令行客户端

面向开发者、高级用户与自动化测试场景打造。通过终端即可完成登录、节点刷新、VPN 模式切换、Kill-switch 配置、连接与日志诊断。

Windows 和 macOS 安装包会自动注册后台服务,Linux 用户可通过命令手动安装 systemd service。

获取 PandaVPN
panda@terminal
panda> mode pandavpn global panda> connect [Success] Connected to <NODE_ID>. panda> doctor [OK] Runtime healthy. |

选择适合你的 CLI 版本

根据你的操作系统和处理器架构下载 PandaVPN CLI,并按照对应系统的快速开始步骤完成安装、登录、节点刷新、模式切换、连接和诊断。

macOS

系统说明

适用于 macOS 用户。安装包会自动完成必要的权限申请、后台 daemon 安装与启动。

安装说明

  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

Linux

系统说明

适用于 Linux 用户。Linux 版本提供 CLI 二进制文件,需要用户手动安装后台 systemd service。

安装说明

  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

Windows

系统说明

适用于 Windows 用户。安装包会自动申请管理员权限,并注册 PandaVPN CLI 后台 Windows Service。

安装说明

  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

建议先通过 panda help 熟悉命令,再完成登录、节点刷新和连接测试。Kill-switch 可在 VPN 断开或客户端异常退出时阻断非 PandaVPN 流量,帮助避免 IP 泄露。

为高级网络场景而生

智能连接与运行时支持

自动选择推荐的连接方式,并在需要时进行 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 和桌面客户端有什么区别?

CLI 更适合自动化测试、远程排查和脚本化连接。不建议将旧 Qt 桌面客户端与 CLI 同时运行,以避免网络配置冲突。

为什么安装后需要系统级权限?

创建 TUN 接口、修改系统 DNS、应用 Kill-switch 等高级防护功能均需系统级权限,因此会在后台运行对应的平台 daemon / service。

为什么 Kill-switch 不能和 proxy 模式一起用?

Kill-switch 旨在只允许流量经过 TUN 隧道并阻断其余流量。standalone proxy 模式没有 TUN 接口,因此二者互斥,请切换至 pandavpn 或 wireguard 模式使用。