名称： nordvpn
描述： 通过 nordvpn CLI 在 Linux 上控制 NordVPN（连接/断开、选择国家/城市/组、查看状态、调整设置、管理允许列表）。适用于需要区域路由或临时 VPN 隧道的自动化任务。
主页： https://nordvpn.com/

NordVPN CLI 技能 (Linux)

一个用于控制 NordVPN Linux CLI (nordvpn) 的 ClawBot 技能，可从自动化和工作流中执行连接/断开、选择位置、验证状态和调整设置等操作。

前提条件 / 兼容性

• 适用于官方的 nordvpn CLI（示例版本：4.3.1 [snap]）。
• 需要 NordVPN 守护进程（通常是 nordvpnd）正在运行，并拥有足够的权限。
• 某些命令可能需要提升权限，具体取决于发行版和安装方式（snap 与 deb）。

安装

选项 A：Snap（Ubuntu 上常见）

sudo snap install nordvpn
nordvpn --version

选项 B：发行版软件包 / 仓库（因发行版而异）

如果通过 Nord 的仓库或包管理器安装，只需验证：

which nordvpn
nordvpn --version

验证守护进程是否运行

# systemd 安装通常如此
systemctl status nordvpnd --no-pager || true

# snap 安装可能不会以相同方式暴露 systemd 单元
nordvpn status || true

# 或者可能需要指定完整路径，例如
/snap/bin/nordvpn status || true

认证 / 登录

NordVPN CLI 通常要求每台机器/用户会话登录一次。

nordvpn login

如果环境是无头（headless）的，CLI 将引导您完成登录流程（通常通过浏览器链接/代码）。登录后，请确认：

nordvpn account
nordvpn status

ClawBot 指导： 除非您明确自动化基于浏览器的登录流程，否则请将登录视为手动先决条件。

快速参考

状态

nordvpn status

连接（最佳可用服务器）

nordvpn connect
# 别名：
nordvpn c

连接到特定国家 / 城市 / 组

# 国家
nordvpn connect Sweden

# 城市（必须存在于 `nordvpn cities <country>` 列表中）
nordvpn connect "Stockholm"

# 组（必须存在于 `nordvpn groups` 列表中）
nordvpn connect P2P

断开连接

nordvpn disconnect
# 别名：
nordvpn d

列出位置

nordvpn countries
nordvpn cities Sweden
nordvpn groups

设置（查看 + 更改）

nordvpn settings

# 示例（选项因版本而异）
nordvpn set autoconnect on
nordvpn set killswitch on
nordvpn set threatprotectionlite on  # 如果支持
nordvpn set protocol nordlynx        # 如果支持

允许列表（使特定流量绕过 VPN）

# 查看帮助
nordvpn allowlist --help

# 示例（子命令因版本而异）
nordvpn allowlist add port 22
nordvpn allowlist add subnet 192.168.0.0/16
nordvpn allowlist remove port 22

技能设计

本技能应做好的方面

1. 幂等的连接操作

   • 如果已连接到请求的目标，则不执行任何操作（或返回“已连接”）。

   • 如果连接到其他地方，可选择先断开连接，再连接到目标。
     2. 可靠的验证

   • 连接/断开后，始终运行 nordvpn status 并解析结果。
     3. 安全的回退机制

   • 如果请求的城市/国家/组无效，通过列出以下内容提供最接近的替代方案：

     • nordvpn countries
     • nordvpn cities <country>
     • nordvpn groups
       4. 人工介入的登录流程

   • 如果 nordvpn 报告未登录，则返回结构化响应，指示运行 nordvpn login。

推荐的“操作”（API 接口）

将这些实现为技能的可调用意图/工具：

• status() → 返回解析后的连接状态
• connect_best() → 连接到最佳可用服务器
• connect_country(country) → 连接到指定国家
• connect_city(city)（可选附带 country 以消除歧义）
• connect_group(group) → 连接到指定组
• disconnect() → 断开连接
• list_countries() → 列出所有国家
• list_cities(country) → 列出指定国家的城市
• list_groups() → 列出所有组
• get_settings() → 获取当前设置
• set_setting(key, value) → 更改设置
• allowlist_add(type, value) → 添加允许列表规则
• allowlist_remove(type, value) → 移除允许列表规则

建议的实现模式（CLI 编排）

1) 始终从状态检查开始

nordvpn status

解析 CLI 通常返回的字段，例如：

• 连接状态（Connected/Disconnected）
• 当前服务器 / 国家 / 城市
• IP、协议、技术

2) 连接流程

目标： 连接到目标（国家/城市/组）并进行验证。

伪逻辑：

• 运行 nordvpn status
• 如果已断开连接 → 直接连接
• 如果已连接到不同目标 → nordvpn disconnect 然后连接
• 再次运行 nordvpn status 并确认已连接

命令：

nordvpn connect "<target>"
nordvpn status

3) 断开连接流程

nordvpn disconnect
nordvpn status

4) 安全地解析目标

如果用户请求城市：

• 当已知国家时，优先使用 nordvpn cities <country>
• 否则尝试连接；如果失败，则列出国家并提供类似搜索的建议。

nordvpn countries
nordvpn cities "<country>"
nordvpn groups

常见错误与处理

未登录

症状：

• CLI 提示认证/账户/登录错误。

处理：

• 返回：“需要登录。请运行 nordvpn login 后重试。”
• 可选：运行 nordvpn account 进行确认。

守护进程未运行 / 权限被拒绝

症状：

• 无法连接、服务错误、权限错误。

处理：

• 检查 systemctl status nordvpnd（systemd 安装）
• 确认 snap 服务健康状态（snap 安装方式各异）

• 确保用户属于正确的组（某些安装使用 nordvpn 组）：

  bash groups getent group nordvpn || true

无效的位置/组

症状：

• “未知国家/城市/组”或连接立即失败。

处理：

• 提供可用选项：

  bash nordvpn countries nordvpn groups nordvpn cities "<country>"

实用自动化示例

确保 VPN 已连接（任意服务器）

nordvpn status | sed -n '1,10p'
nordvpn connect
nordvpn status | sed -n '1,15p'

重新连接到特定国家

nordvpn disconnect
nordvpn connect Sweden
nordvpn status

切换网络锁（示例）

nordvpn set killswitch on
nordvpn settings

注意事项

• 命令选项和设置键可能因 NordVPN CLI 版本而异。始终依赖：

  bash nordvpn help nordvpn set --help nordvpn allowlist --help
  * 如果需要稳定的机器可读输出，请注意 NordVPN CLI 并不始终提供 JSON；请计划采用防御性方式解析人类可读的状态文本（基于行的键/值提取，容忍缺失字段）。