NordVPN CLI 技能 (Linux)

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

前提假设 / 兼容性

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

安装

选项 A：Snap（在 Ubuntu 上常见）

sudo snap install nordvpn
nordvpn --version

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

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

which nordvpn
nordvpn --version

验证守护进程正在运行

# systemd installs usually
systemctl status nordvpnd --no-pager || true

# snap installs may not expose systemd unit the same way
nordvpn status || true

# or may require the full patch to be specified like so
/snap/bin/nordvpn status || true

认证/登录

NordVPN CLI通常需要在每个机器/用户会话中登录一次。

nordvpn login

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

nordvpn account
nordvpn status

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

快速参考

状态

nordvpn status

连接（最佳可用）

nordvpn connect
# alias:
nordvpn c

连接到国家/城市/组

# country
nordvpn connect Sweden

# city (must exist in `nordvpn cities <country>`)
nordvpn connect "Stockholm"

# group (must exist in `nordvpn groups`)
nordvpn connect P2P

断开连接

nordvpn disconnect
# alias:
nordvpn d

列出位置

nordvpn countries
nordvpn cities Sweden
nordvpn groups

设置（读取 + 更改）

nordvpn settings

# examples (options differ by version)
nordvpn set autoconnect on
nordvpn set killswitch on
nordvpn set threatprotectionlite on  # if supported
nordvpn set protocol nordlynx        # if supported

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

# view help
nordvpn allowlist --help

# examples (subcommands differ by version)
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 <国家>
     • nordvpn groups

4. 人工介入登录

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

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

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

• status()→ 返回解析后的连接状态
• connect_best()→ 连接到最佳可用服务器
• connect_country(国家)
• connect_city(城市)（可选地附带国家用于消除歧义）
• connect_group(分组)
• disconnect()
• list_countries()
• list_cities(国家)
• list_groups()
• get_settings()
• set_setting(键, 值)
• allowlist_add(类型, 值)
• allowlist_remove(类型, 值)

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

1) 始终从状态开始

nordvpn status

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

• 连接状态（已连接/已断开）
• 当前服务器 / 国家 / 城市
• IP地址、协议、技术

2) 连接流程

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

伪逻辑：

• 运行检查NordVPN状态
• 若未连接 → 直接连接
• 若已连接至其他目标 →执行 nordvpn disconnect然后进行连接
• 运行nordvpn status再次检查并确认已连接

命令列表：

nordvpn connect "<target>"
nordvpn status

3) 断开连接流程

nordvpn disconnect
nordvpn status

4) 安全解析目标

若用户指定城市：

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

nordvpn countries
nordvpn cities "<country>"
nordvpn groups

常见错误及处理

未登录状态

症状：

• 命令行提示认证/账户/登录问题

处理方法：

• 返回：“需要登录。请运行nordvpn login”并重复。”
• 可选操作：运行nordvpn account进行确认。

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

症状：

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

处理方法：

• 检查systemctl status nordvpnd（针对systemd安装）

• 确认snap服务状态（snap安装方式各异）

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

  groups
  getent group nordvpn || true
  

无效位置/组

症状：

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

处理方法：

• 提供可用选项：

  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版本而异。请始终参考：

  nordvpn help
  nordvpn set --help
  nordvpn allowlist --help
  

• 如需稳定的机器可读输出，请注意NordVPN CLI无法始终提供JSON格式；请规划采用防御性方式解析人工可读状态文本（基于行的键/值提取，并允许字段缺失）。