FAQs

目前，PandaVPN 支持 Windows、macOS、Android、iOS、Linux、Android TV、Apple TV 以及命令行版 CLI。

您可以在 Windows 电脑、Mac、Android 手机、Android 平板、Android TV、iPhone、iPad、Linux 设备和 Apple TV 上使用 PandaVPN 服务。

如果您需要在服务器、路由环境或其他支持命令行的设备上使用，也可以选择 PandaVPN CLI 版本。建议您前往官网下载对应平台的最新版客户端：
https://pandavpnpro.com/download

PandaVPN，目前只有一个官方网站：

https://pandavpnpro.com/

请通过以下官方渠道下载或购买 PandaVPN：

1. 官方网站：
   https://pandavpnpro.com/
2. Google Play 官方页面：
   https://play.google.com/store/apps/details?id=com.pandavpn.androidproxy
3. Apple App Store 官方页面：
   https://apps.apple.com/app/id1450910298

请不要通过其他网站下载或购买 PandaVPN。非官方渠道可能提供仿冒软件，可能导致无法使用、隐私泄露或资金损失。

如果您发现疑似仿冒网站或应用，或者不确定某个渠道是否官方，请通过客服邮箱联系我们确认：

[email protected]

PandaVPN 不同客户端支持的模式略有不同，具体以客户端显示为准。

1. Smart Mode 智能模式
   客户端自动选择合适的连接方式，适合大多数用户日常使用。
2. 全局模式
   所有流量都通过 VPN，隐私保护更强，但访问本地网站、App 或局域网设备时可能变慢。
   移动端名称通常为：Tunnel All for Privacy
   PC / Mac 端名称通常为：Encrypted Proxy: Global (Exclude LAN)
3. 绕过指定地区
   默认走 VPN，但指定地区流量直连。例如选择 United States / US 后，美国相关网站和 App 会直连，其他流量走 VPN。
4. 仅代理指定地区
   默认直连，只有访问指定地区时才走 VPN。适合访问特定国家或地区的网站、流媒体服务。
5. 仅代理社交媒体
   仅让 YouTube、Facebook、X 等社交媒体或流媒体流量走 VPN，其他流量直连。
6. 按 App 分流
   移动端可通过 Per-App VPN 设置指定 App 是否走 VPN。
7. 自定义分流
   高级用户可通过 Custom Split Settings 自定义 IP、域名或规则，决定哪些流量走 VPN、直连或阻断。
8. 协议模式
   PandaVPN、OpenVPN、WireGuard 属于不同连接协议。如果连接不稳定或速度不理想，可以切换协议后重试。

建议：
如果不确定怎么选，优先使用 Smart Mode。访问本地网站或 App 变慢时，建议使用“绕过指定地区”或分流模式。

不同地区、不同运营商的网络情况不一样，实际速度可能会有所差异。

一般来说，距离您地理位置较近、延迟较低的节点，连接速度会更快、更稳定。您也可以根据访问需求选择对应地区的线路，例如访问某个国家或地区的网站、应用或游戏时，优先选择该地区的节点。

建议优先选择客户端中延迟较低的线路进行连接。如果速度不理想，可以切换其他相近地区的节点或更换协议后再试。

PandaVPN 不限制使用流量，也不会主动限制连接速度，您可以根据需要正常使用。

但需要注意：PandaVPN 不能代替您的网络，也不是“免流量”工具。使用 PandaVPN 上网时，设备仍然需要先连接 Wi-Fi 或移动数据网络，并且会正常消耗对应的 Wi-Fi 或手机套餐流量。

简单来说：

1. PandaVPN 本身不限制流量。
2. PandaVPN 不会让手机流量或 Wi-Fi 流量变成免费。
3. 如果设备没有联网，PandaVPN 也无法连接和使用。
4. 实际速度可能会受本地网络、运营商、所在地区和所选线路影响。

如果连接后无法上网，建议先确认设备本身的 Wi-Fi 或移动数据是否正常，再尝试更换 PandaVPN 线路或协议。

如果连接 PandaVPN 后，访问本地网站、App 或局域网设备变慢，通常是因为当前流量全部经过 VPN 隧道转发。

您可以在客户端切换协议或进入 PandaVPN Mode，选择更适合的分流模式：

1. 如果主要访问本地网站或 App，建议选择“绕过指定地区”，并将本地所在地区加入绕过列表。这样本地流量会直连，其他流量仍可通过 VPN。
2. 如果只想访问特定国家或地区的网站，建议选择“仅代理指定地区”。这样只有访问指定地区时才会走 VPN，其他流量保持直连。
3. 如果只需要加速或访问社交媒体，可以选择“仅代理社交媒体”。
4. 如果需要保护全部网络流量，可以选择“全局隐私模式”，但访问本地网站或 App 可能会变慢。

如果需要访问路由器、打印机、NAS 等局域网设备，也可以在客户端中开启排除局域网或本地网络直连相关设置。

是的，PandaVPN，也叫熊猫VPN，是安全的。

PandaVPN 支持 OpenVPN、WireGuard 以及自研 PandaVPN Mode 等连接方式，并通过加密传输保护您的网络连接，降低数据被监听或泄露的风险。

在隐私保护方面，PandaVPN 采用随机数字账号，注册时无需提供过多个人信息，并支持零日志政策，尽量减少用户隐私数据留存。

同时，PandaVPN 还支持比特币等支付方式，并内置 AdBlocker 广告过滤功能，可帮助减少部分广告、弹窗和恶意内容干扰。

线路名称中的简写通常表示网络服务商、地区或适用服务。

例如：HKT、HKBN、APNIC、HKCM、PCCW、HiNet、SoftBank 等，一般代表线路相关的网络服务商。

如果线路名称包含平台名称，如 Netflix、BBC iPlayer、AbemaTV、Viaplay、VIU，通常表示该线路更适合访问对应平台。

如遇访问异常，建议更换同地区其他线路后再试。

部分用户会将 VPN 称为“加速器”。如果您只是打开了 PandaVPN 客户端，但还没有连接 VPN 线路，IP 地址不会发生变化。

请在 PandaVPN 客户端中选择一个线路或服务器，并点击连接。连接成功后，您的网络 IP 地址才会切换为所选服务器的 IP 地址。

如果连接成功后 IP 地址仍未变化，可以尝试以下方法：

1. 断开后重新连接 PandaVPN。
2. 更换其他线路或服务器。
3. 切换连接协议后重试。
4. 关闭浏览器后重新打开，再查看 IP 地址。

如果仍然无法切换 IP，请确认客户端是否显示“已连接”，并更新到最新版 PandaVPN 后再试。

线路列表会根据线路等级、服务器所在国家或地区，以及部分使用场景进行分组，方便您快速选择合适的线路。

常见分组说明如下：

1. Free / Premium / Premium+
   表示不同等级的线路标签页。Free 线路可免费使用，Premium 和 Premium+ 线路需要根据账号权限或套餐状态使用。
2. Smart-Select Server
   智能选择线路。点击后，系统会根据当前网络情况自动推荐合适的线路。
3. Recommend
   推荐线路。系统会根据您的网络情况推荐可用线路。
4. 国家或地区分组
   例如 America、Asia、Europe、USA、Oceania、Middle East 等，表示服务器所在地区。您可以根据访问目标选择对应地区的线路。
5. BitTorrent
   该分组线路允许 BT 下载。
6. 流媒体线路
   目前没有单独的 Streaming 分组。如果需要观看 Netflix、Disney+、HBO 等流媒体服务，可以在线路列表中搜索对应平台名称，或选择线路名称中带有相关平台标签的线路。

除以上分组外，其他线路通常会按国家、地区或线路等级分类。您可以根据访问需求选择对应线路。

PandaVPN 的 Android 和 iOS 客户端支持 AdBlocker 广告过滤功能。

您可以在客户端设置中开启 AdBlocker。开启后，在支持的模式下连接任意线路，即可过滤部分广告内容。

AdBlocker 主要用于过滤部分网站广告、弹窗广告、Banner 广告，以及部分应用内广告。

请注意：

广告过滤效果会因网站、App、地区和广告加载方式不同而有所差异，无法保证过滤所有广告。

目前，我们支持信用卡、PayPal、Google Play、Payssion 和 Line Pay 等。

有的。PandaVPN 提供以下免费使用方式：
1. 免费线路
PandaVPN 分为 Lite 和 Pro 两个版本，客户端内的线路会显示在 Free、Premium 和 Premium+ 三个标签页中。
Free 标签页中的线路，Lite 用户和 Pro 用户都可以免费使用，无需观看广告，也无需付费。
2. 三天免费试用
在手机上安装 PandaVPN Pro 版本后，系统会自动生成试用账号。首次连接成功后，可以获得 3 天免费试用时长。
3. 观看广告获得 Premium 时长
Lite 用户可以通过观看激励视频广告，获得免费的 Premium 使用时长，用于连接 Premium 标签页中的线路。
需要注意的是，Pro 用户需要付费后才能解锁 Premium 标签页中的线路。
4. 邀请好友获得 Premium 时长
您可以通过邀请链接邀请好友使用 PandaVPN。好友首次充值后，您和好友都可以获得一定的 Premium 时长奖励。
5. Premium+ 线路
Premium+ 标签页中的线路属于更高等级线路，Lite 用户和 Pro 用户都需要付费后才能使用。

PandaVPN 提供 7 天退款保证。如果您对服务不满意，请在购买后 7 天内联系客服申请退款。

申请退款前，请先取消 PayPal 或信用卡订阅，避免后续自动续费。

退款申请方式：

1. 通过 App 内的“在线反馈”联系客服。
2. 发送邮件至 [email protected] 申请退款。

退款到账时间：

1. UnionPay 银联和 PayPal 订单，通常会在 1-3 天内退回账户。
2. 信用卡订单，可能需要 5-10 个工作日才会显示在账单中。

注意：

1. 7 天套餐不支持 7 天退款保证。
2. App Store 和 Google Play 购买的订单，由对应平台处理退款。请前往 App Store 或 Google Play 按平台规则自行申请退款。

Premium+ 是 PandaVPN 提供的更高等级线路，主要面向对速度、稳定性或特定地区访问有更高要求的用户。

Premium+ 线路通常采用更优质的服务器资源，适合高清视频、流媒体、游戏或对连接质量要求较高的场景。

目前 Premium+ 线路仍处于测试或限时开放阶段，具体可用状态以客户端显示为准。测试或免费开放结束后，可能需要升级套餐后才能继续使用 Premium+ 线路。

如果连接效果不理想，建议更换其他 Premium+ 线路或切换协议后再试。

如果您需要取消 PandaVPN 自动续费，请根据购买渠道操作：

1. PayPal 订阅
   登录 PayPal 账号，进入“设置” > “付款” > “管理自动付款”，找到 PandaVPN 后取消订阅。
2. 信用卡订阅
   如果您通过信用卡订阅，可在 PandaVPN 续费页面重新选择套餐并尝试支付，系统通常会提示您取消当前订阅，按提示取消即可。
   如果没有取消提示，可能说明订阅已取消。您也可以登录 Stripe 账户，在 Billing / Subscription 中找到 PandaVPN 订阅并取消。
3. App Store 订阅
   如果您是在 iPhone 或 iPad 上通过 App Store 购买，请前往 Apple ID 的“订阅”页面，找到 PandaVPN 后取消订阅。
4. Google Play 订阅
   如果您是在 Android 设备上通过 Google Play 购买，请前往 Google Play 的“付款和订阅”页面，找到 PandaVPN 后取消订阅。

取消订阅后，系统将不会再自动扣费。已购买的 Premium 时长仍可使用至当前有效期结束。

如有疑问，请通过客户端在线反馈或客服邮箱联系：

[email protected]

为了保障您的账号安全，非定制账号仅限本人使用，不建议将账号分享给他人。

如果账号被他人使用，可能会导致设备数量被占用、账号异常、连接受限或个人信息泄露等问题。因账号共享造成的损失或风险，需要由账号本人承担。

如果您需要多人或多设备共同使用，建议购买叠加设备数量，或联系客服咨询定制设备数量套餐。

同时在线设备数是指同一账号可同时连接 PandaVPN 的设备数量。试用账号支持 1 台设备同时在线，付费账号支持 3 台设备同时在线。

登录设备数量不限制，但同一时间可在线连接的设备数量会受套餐限制。如需更多设备同时使用，可以叠加购买设备数。

如果您需要同一账号支持更多设备同时在线，可以在账户中心叠加购买设备数。

请登录“我的账户”页面，点击“叠加设备”或“增加 3 台设备数”。每购买一次，即可额外增加 3 台可用设备数量。

如果您需要定制更多设备数量套餐，可以通过 App 内在线反馈，或发送邮件至客服邮箱联系我们：

[email protected]

请在反馈中说明您需要购买的设备数量，客服人员会为您提供报价和购买方式。

如果账号已绑定邮箱，请在登录页面点击“忘记密码”，通过绑定邮箱重置密码。

如果账号未绑定邮箱，请将 PandaVPN 数字 ID、订单截图或付款成功截图发送至客服邮箱：

[email protected]

客服核实后会协助您重置密码。

如果您已成功付款，但 Premium 还没有生效，请根据付款方式处理：

1. PayPal 付款
   部分 PayPal 订单可能会因平台审核导致延迟到账，最长可能需要 3 个工作日。请稍后再查看账号状态。
2. App Store 或 Google Play 订阅
   请在对应客户端登录账号，进入“我的账户”或“管理订阅”，点击“恢复订阅”或“恢复购买”。
3. 其他付款方式
   请通过 App 内在线反馈，或发送邮件至客服邮箱联系我们：
   [email protected]

请提供您的 PandaVPN 数字 ID、订单截图或付款成功截图，客服会帮您查询处理。

如果您忘记了 PandaVPN 数字 ID，可以按以下方式找回：

1. PayPal 付款订单
   请打开 PayPal 订单详情，在商品说明中查看。您购买的套餐后面通常会显示对应的 PandaVPN 数字 ID。
2. 其他支付方式订单
   如果您是通过其他方式付款，请将订单截图或付款成功短信截图发送至客服邮箱：
   [email protected]
   客服会根据订单时间、付款信息等内容，帮您查询对应的数字 ID。
3. App Store 或 Google Play 订单
   如果您是在 App Store 或 Google Play 客户端内购买的订阅，可以先在客户端内尝试点击“恢复订阅”或“恢复购买”。
   如果仍无法找回，请联系客服并提供平台订单截图，以便进一步查询。

可以。Premium 订阅未过期前也可以提前续费。

续费成功后，新的套餐时长会自动叠加到当前账号剩余时长中，不会影响您已有的 Premium 使用天数。

例如：当前账号还剩 10 天 Premium 时长，再购买 30 天套餐后，账号总时长将变为 40 天。

目前 PandaVPN 处于推广期，邀请好友首次充值后，您和好友都可以获得免费 Premium 时长奖励。

奖励规则如下：

1. 好友奖励
   好友通过您的分享链接注册，或填写您的邀请码并完成付费后，可获得 30 天 Premium 时长奖励。
2. 邀请人奖励
   根据好友首次购买的套餐时长，您可获得不同奖励：
   如果好友购买的套餐低于 1 年，您可获得 30 天 Premium 时长奖励。
   如果好友购买的套餐大于或等于 1 年，您可获得 90 天 Premium 时长奖励。

注意：
如果好友首次购买的套餐低于 1 个月，邀请人和好友均无法获得奖励时长。

可以。注册后 7 天内仍可以填写邀请码。

官网：请登录您的账号并访问 https://pandavpnpro.com/my-account，然后在“填写邀请码”输入框中填写对应的邀请码。

请注意：邀请码需要在账号注册后的 7 天内填写，超过时间后可能无法再填写。

PandaVPN 支持用户申请注销账户并删除相关数据。

注销前，请先确认已取消当前订阅或自动续费。

注销方式如下：

1. 打开 PandaVPN 客户端。
2. 进入“菜单” > “我的账户” > “设置” > “注销账户”。
3. 点击“申请注销”。

提交申请后，系统会自动处理账户注销。注销完成后，账号将无法继续登录或使用，相关数据也将被删除。

如果观看 YouTube 视频加载慢或卡顿，可以尝试以下方法：

1. 更换 YouTube 或流媒体相关线路后重新连接。
2. 在客户端中切换其他连接协议后再试。
3. 如果使用 Chrome 浏览器，可以关闭 QUIC 功能。操作方式：
   在 Chrome 地址栏输入：
   chrome://flags/#enable-quic
   找到 Experimental QUIC protocol，将其设置为 Disabled，然后重启浏览器。

不同客户端的设置入口可能略有不同。如果仍然较慢，建议更新到最新版 PandaVPN，并尝试更换其他地区或延迟较低的线路。

如果连接 PandaVPN 后无法观看 Netflix，可能是当前线路或代理模式不适合流媒体播放。请尝试以下方法：

1. 优先选择名称中带有 Netflix 的线路，或更换同地区其他流媒体线路。
2. 移动端用户：进入协议或模式设置，不要选择 Tunnel All for Privacy（全局隐私模式），可切换为 PandaVPN Mode 下的分流模式后重新连接。
3. PC 端用户：如果当前为 Encrypted Proxy: Global (Exclude LAN) 模式，可切换为智能模式或其他分流模式后重新连接。
4. 重新打开 Netflix App 或浏览器后再试。

如果仍无法播放，请更换其他 Netflix 线路，或切换协议后重新连接。

支持。请在线路列表中搜索 Disney+，选择带有 Disney+ 标签的线路后重新连接，再打开 Disney+ 观看。

如果仍无法播放，可以尝试以下方法：

1. 开启全局代理模式后重新连接。
2. 更换其他带 Disney+ 标签的线路。
3. 关闭并重新打开 Disney+ App 或浏览器。
4. 如仍有报错，可根据 Disney+ 官方提示检查设备、账号地区和播放环境。

注意：

Disney+ 对设备、地区和网络环境要求较高，不同设备上的播放效果可能会有所差异。

主要支持：

常用设置：

panda mode auto
panda mode pandavpn global
panda mode proxy global
panda mode wireguard

openvpn 当前不建议作为用户文档中的主线模式展示。

建议：

注意：mode proxy 与 Kill-switch 互斥。

一样。区别主要是下载的 .pkg 架构不同。

安装步骤一致。使用 .pkg 安装后通常会自动安装并启动 LaunchDaemon / helper。

面向全球用户，推荐默认使用 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

官网下载页和新手引导建议优先展示完整命令；高级文档或交互模式说明中再展示短写。

gfwlist 是特定分流规则来源，不适合作为面向全球用户的默认模式。

全球用户默认推荐：

panda mode auto

或固定使用 PandaVPN 全局模式：

panda mode pandavpn global

gfwlist 可以保留在高级分流文档中，但不建议出现在官网首屏、下载页 Hero 或新手快速开始里。

核心区别是：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 CLI 通过命令行操作，更适合：

• 自动化测试
• 远程排查
• 脚本化连接
• 查看详细诊断信息
• 验证 Kill-switch、DNS、路由、系统代理等底层行为

桌面客户端更适合普通用户日常图形化操作。

注意：旧 Qt 桌面客户端和 CLI 不建议同时管理 VPN / 系统代理，避免互相覆盖配置。

部分能力需要系统级权限，例如：

• 创建 TUN / WireGuard 网络接口
• 修改 DNS
• 设置系统代理
• 应用 Kill-switch
• 修复路由
• 管理 packet VPN runtime

因此 CLI 会通过平台对应的 daemon / service 执行这些操作。

不同平台的 daemon 形式：

Panda CLI 是 Panda 的命令行客户端，支持通过终端完成：

• 登录与账号管理
• 节点刷新与节点连接
• PandaVPN / Proxy / WireGuard / Auto 模式切换
• 系统代理配置
• Split rules 分流规则
• Split DNS 配置
• Kill-switch 防护
• Auto-connect
• 日志和诊断

它适合内测用户、开发者、高级用户和需要脚本化操作的测试场景。

当路由、DNS、系统代理或 Kill-switch 状态被系统、其它 VPN / 代理工具、网络切换、睡眠恢复等情况意外修改或丢失，导致网络异常时，可以执行： ```bash panda repair ``` `panda repair` 会尝试恢复 Panda 管理的网络配置，例如 VPN 路由、DNS 快照、系统代理状态和 Kill-switch guard。它通常不需要先执行 `panda disconnect` 再重新 `panda connect`，适合在连接仍存在但网络状态异常时快速修复。 推荐排查顺序： ```bash panda doctor panda repair panda doctor ``` 常见适用场景： * `panda doctor` 提示路由、DNS、系统代理或 Kill-switch 状态异常； * 连接后突然无法访问网络； * Wi-Fi / 有线网络切换后网络异常； * 系统睡眠恢复后访问异常； * 其它 VPN、代理软件或系统网络设置修改了路由、DNS 或代理； * Kill-switch guard 状态异常； * 不想先断开再重新连接，希望直接尝试恢复当前网络配置。 如果执行 `panda repair` 后仍未恢复，再尝试重新连接： ```bash panda disconnect panda connect panda doctor ``` 注意：`panda repair` 不会重新登录账号，也不会刷新节点目录。如果问题是 daemon 未启动、账号未登录、节点不可用或连接目标异常，请分别检查 `panda status`、`panda login`、`panda node refresh` 和 `panda log`。

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。

通常不需要。Split DNS 配置变更会热加载。

常用命令：

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。

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 系统代理是当前用户 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，但可能影响系统代理模式体验。

在 no-tunnel IPv6 场景下，可能 block awdl0 / llw0，导致 AirDrop / Continuity 暂不可用。
通常 disconnect 后恢复。

如果仍异常，建议：

panda disconnect
panda kill-switch off
panda repair
panda doctor

通常是因为既安装了正式 service / LaunchDaemon，又手动执行过：

sudo panda start

sudo panda start 会启动一个 unmanaged / 脱管 daemon，可能与正式 daemon 同时管理：

• VPN 路由
• DNS
• TUN
• 系统代理
• 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 作为日常启动方式。

如果只是断开 VPN，不需要退出 daemon：

panda disconnect
panda kill-switch off

如果确实要停止 daemon：

sudo panda stop

确认：

panda status

如果显示 panda daemon unavailable，说明主 daemon 已停止。

注意：macOS .pkg 安装的 LaunchDaemon / helper 可能会被系统管理，不建议普通用户频繁手动停服务。

建议先断开连接，并关闭 Kill-switch：

panda disconnect
panda kill-switch off

如果是手动升级或 Linux service 升级，建议再停止 daemon：

sudo panda stop

macOS 和 Windows 使用安装包升级时，安装包通常会自动处理服务安装和重启。升级完成后建议执行：

panda version
panda doctor
panda connect

Linux 手动升级后建议：

sudo panda service install
sudo panda service restart
panda version
panda doctor

panda log
panda log --lines 200
panda log --all

清理日志：

panda log clear

临时打开 debug：

panda log level debug dns,tcp --ttl 10m

恢复默认：

panda log level reset

支持版本可以配置：

panda config tcp-fast-open auto
panda config tcp-fast-open on
panda config tcp-fast-open off

说明：

• 默认建议 auto；
• 修改后不会热重连；
• 需要 reconnect 后对新 TCP socket 生效；
• 不支持 TFO 的节点不应出现明显连接延迟回归。

如果当前版本没有该配置项，以 panda config --help 或实际 CLI help 为准。

新版本 Windows Kill-switch 已从 daemon-held dynamic session 升级为 persistent WFP filters。
这意味着 daemon 异常退出后 guard 可以保留。

但 persistent WFP 不等同 boot-time filter，极早期启动窗口仍属于后续 hardening 范围。

不是。

Auto-connect 主要覆盖 daemon / service 启动时的 best-effort connect，以及启动时暂时无网络时的 pending retry。

开启：

panda config auto-connect on

关闭：

panda config auto-connect off

它不是通用的 runtime 自动重连机制。

Split rules 用于指定某些域名、关键词、正则或 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 后不会自动 wake 待重试的 pending auto-connect。

建议登录后手动执行：

panda connect

| Pattern | 示例 | 含义 | |---|---|---| | 裸域名 | example.com | 后缀匹配 | | domain: | domain:api.example.com | 精确主机 | | suffix: | suffix:google.com | 后缀匹配 | | || | ||google.com | 后缀匹配 | | keyword: | keyword:netflix | 子串匹配 | | regexp: | regexp:.*\.cdn\.example\.com | Go 正则 | | ip-cidr: | ip-cidr:10.0.0.0/8 | IP 规则 |

先搜索节点：

panda node list us

再连接：

panda connect --node 1822

也可以按名称连接：

panda connect --node "US Node"

短写：

panda no list us
panda conn --node 1822

panda connect 会使用上次目标。
如果没有历史目标，则尝试 global smart connect。

Smart connect 需要：

• 已登录；
• 已缓存节点目录；
• 必要时先执行 panda node refresh。

短写：

panda conn

panda connect us

表示裸 group selector，不固定 VIP / SVIP / FREE tab，由 API 选择合适 tab。

panda connect svip us

表示固定使用 SVIP tab 下的 us。

冒号形式等价，适合脚本：

panda connect svip:us

收藏 tab 当前是 flat favorite channel list，不支持 connect fav us 这类收藏 group smart connect；收藏请用：

panda connect fav

或：

panda connect --node <NODE_ID>

新版支持更完整的 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

新手文档不建议展示长命令，适合放在高级分流文档中。

Kill-switch 的语义是只允许流量经过 TUN，其它普通流量被阻断。

proxy mode 是 standalone 本地代理模式，没有 packet VPN / TUN，也没有同等 DNS 和路由保护。因此 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

可以。

mode auto + kill-switch on 是允许的，但最终路径必须解析成 PandaVPN / WireGuard，不能落到 standalone proxy。连接过程中如果从 WireGuard 回退到 PandaVPN，也必须保持 guard active，不能出现 fail-open 窗口。

推荐：

panda mode auto
panda kill-switch on
panda connect
panda doctor

不建议。

Kill-switch 是增强隐私保护选项，不适合放进最短可用路径。原因是：

• disconnect 不会关闭 Kill-switch；
• 开启后普通网络可能被阻断；
• 还涉及 LAN 访问、DNS lockdown、防火墙和平台权限差异；
• 新用户可能误以为网络坏了。

推荐新用户先完成：

panda login
panda node refresh
panda mode auto
panda connect
panda doctor

确认连接正常后，再按需开启：

panda kill-switch on
panda doctor

不会。

这是预期行为。Kill-switch 是持久安全开关，disconnect 只断开当前 runtime，不会自动关闭 Kill-switch。

如果要恢复普通网络访问，需要执行：

panda kill-switch off

mode auto 是新版默认模式。

它的行为是：

• API node / smart connect 按 meta.protocol 优先选择 runtime；
• 如果推荐 WireGuard，会优先尝试 WireGuard；
• 如果 WireGuard 元数据、地址分配、runtime 启动、handshake 或连通性探测失败，会回退到 SS payload 编译的 PandaVPN global；
• SS、OPENVPN、未知或缺失协议会使用 PandaVPN global 兜底；
• 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

常见原因：

• 尚未登录；
• 节点目录未刷新；
• 当前账号没有可用节点；
• 网络不可用；
• daemon 未运行；
• 当前 mode 与目标节点不兼容；
• mode auto 下推荐协议启动失败且 fallback 也失败。

建议排查：

panda account
panda node refresh
panda node list
panda mode
panda doctor
panda log --lines 200

panda status

结构化输出：

panda status --json

短写：

panda stat

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

panda repair 更综合，可能修复：

• VPN route
• DNS 快照
• Kill-switch guard
• 系统代理相关状态

panda proxy repair 主要修复当前用户的系统代理漂移。

panda repair
panda proxy repair

在严格模式下，Kill-switch 会阻断普通 LAN / WAN 流量。
支持 allow-lan 的版本可以开启有限 LAN 访问：

panda kill-switch allow-lan on

关闭 LAN 放行：

panda kill-switch allow-lan off

注意：allow-lan 允许私网 / link-local / ULA 单播和 v1 discovery，但 LAN DNS 仍应被阻断，避免绕过 Panda DNS lockdown。

Privacy 模式可以理解为更严格的安全模式，建议等价于：

panda mode pandavpn global
panda kill-switch on

或在默认自动选择协议下：

panda mode auto
panda kill-switch on

Privacy 模式下建议限制：

• 不支持 proxy mode；
• 不支持 split mode；
• 只允许 VPN global 语义；
• 必须启用 Kill-switch；
• 普通 egress 被阻断。

查看全部节点：

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