--- title: vpx 命令行 nav_title: 命令行 description: 在 Windows、macOS、Linux 和 OpenWrt 的终端中用 vpx 命令控制 12VPX NEO,从连接、路由到路由器,以及为客服收集报告。 --- 在 Windows、macOS、Linux 和 OpenWrt 上,12VPX NEO 附带 `vpx` 命令。它控制的后台服务与桌面应用和网页界面相同,因此在其中一处所做的更改,也会显示在其他地方。关闭终端不会断开连接;`vpx disconnect` 才会。 AUTOMATIC_TABLE_OF_CONTENTS ## 入门 `vpx --help` 会列出您所用版本中的所有命令,`vpx --help` 会解释某一条命令。在 Windows PowerShell 中,如果只输入 `vpx` 不起作用,请改为输入 `vpx.exe`。 在下面的示例中,请把大写的单词(例如 `SERVER_ID`)替换成您自己的值。网址和密码请放在单引号中。 日常命令不需要管理员或 root 权限。 ## 日常命令 | 任务 | 命令 | | --- | --- | | 添加您的服务 | `vpx login 'SUBSCRIPTION_URL'` | | 列出服务器 | `vpx servers`,或 `vpx servers --country JP`,或 `vpx servers --search NAME` | | 使用自动选择连接 | `vpx connect` | | 连接到指定服务器 | `vpx connect SERVER_ID` | | 选择自动选择的地区 | `vpx auto region jp`(`us`、`eu`、`jp`、`any` 或 `favorites`) | | 收藏或取消收藏服务器 | `vpx favorite SERVER_ID` 或 `vpx favorite SERVER_ID --remove` | | 显示连接状态 | `vpx status` | | 显示您的公网 IP 地址 | `vpx ip --refresh` | | 断开连接 | `vpx disconnect` | | 打开网页界面 | `vpx open` | | 显示您的账户 | `vpx account` | | 列出您账户的设备 | `vpx account-devices` | | 让本设备退出登录 | `vpx logout` | 您的设置链接是私密的。输入的命令可能会保留在 shell 历史记录中,因此在共用的电脑上请清除历史记录。 ## 路由和捕获 | 任务 | 命令 | | --- | --- | | 显示或更改路由模式 | `vpx mode`、`vpx mode full`、`vpx mode china` 或 `vpx mode ai` | | 列出手动规则 | `vpx rules list` | | 让某个域名及其下所有域名直连 | `vpx rules add general direct suffix example.com` | | 让某一个精确域名经过VPX服务 | `vpx rules add general tunnel exact www.example.com` | | 删除规则 | `vpx rules remove RULE_ID`,ID 来自 `vpx rules list` | | 添加并使用 Rocket 配置 | `vpx rocket add 'CONFIG_URL'`,然后 `vpx rocket list` 和 `vpx rocket use CONFIG_ID` | | 停止使用 Rocket 配置 | `vpx rocket off` | | 查看 AI 路由如何处理某个网站 | `vpx ai activity` 或 `vpx ai explain example.com` | | 更改捕获模式 | `vpx capture tun`、`vpx capture tproxy` 或 `vpx capture proxy-only` | 规则的写法是 `vpx rules add SCOPE ROUTE TYPE VALUE`: - **范围(SCOPE):** `general`(所有模式)或 `ai-only` - **路由(ROUTE):** `direct`(直连)或 `tunnel`(经过VPX服务) - **类型(TYPE):** `suffix`、`exact`、`keyword`、`cidr` 或 `geoip` [12VPX NEO 中的路由](/zh/docs/12vpx-neo/routing)介绍了每个选项的作用。 ## 其他设置 | 设置 | 命令 | | --- | --- | | 广告拦截 | `vpx ad-blocking` 显示当前设置;`vpx ad-blocking normal`(或 `off`、`light`、`pro`)更改设置;`vpx ad-blocking refresh` 更新列表 | | 出站优化 | `vpx outbound-optimization`、`vpx outbound-optimization throughput` 或 `vpx outbound-optimization latency` | | 启动时恢复连接 | `vpx restore-connection on`、`off` 或 `status` | | DNS 泄漏保护 | `vpx dns-leak on`、`off` 或 `status` | | 网络锁 | `vpx kill-switch on`、`off` 或 `status` | | 恢复网络 | `vpx restore-internet` | | 局域网代理访问 | `vpx lan-proxy on`、`off` 或 `status` | | 家庭节点 | `vpx home-server enable`、`disable` 或 `status` | | 电脑时间 | `vpx clock`,或用 `vpx clock --refresh` 重新检查 | | 显示所有设置 | `vpx settings` | [广告拦截、网络锁和其他设置](/zh/docs/12vpx-neo/settings)介绍了每项设置。 ## 路由器和网关 在 OpenWrt 和 Linux 上: | 任务 | 命令 | | --- | --- | | 为指定网络开启路由器模式 | `vpx router enable --lan lan,guest` | | 关闭路由器模式 | `vpx router disable` | | Linux 网关上的局域网 DNS | `vpx router dns`、`vpx router dns on` 或 `vpx router dns off` | | 列出排除的设备 | `vpx devices` | | 排除某台设备 | `vpx devices add 192.168.1.50 'Living room TV'` | | 取消排除 | `vpx devices remove 192.168.1.50` | `lan,guest` 是 OpenWrt 的网络名称;在 Linux 上,请使用您的网络适配器名称。请参阅[在路由器上使用 12VPX NEO](/zh/docs/12vpx-neo/router)。 ## 控制另一台设备 在命令前加上设备的地址和登录信息: ```sh vpx --daemon http://192.168.1.1:9847 --user root --password 'ROUTER_PASSWORD' status ``` 对于 OpenWrt 路由器,登录信息是 `root` 和路由器自身的密码。对于另一台电脑,则是在那台电脑的远程控制中设置的用户名和密码。每条要发给该设备的命令都要加上相同的选项;不加这些选项时,`vpx` 控制的是您正在输入命令的这台电脑。请参阅[网页界面和远程控制](/zh/docs/12vpx-neo/remote-control)。 | 任务 | 命令 | | --- | --- | | 显示远程控制设置 | `vpx listen` | | 开启对本机的远程控制 | `vpx --user admin --password 'PASSWORD' listen INTERFACE` | | 关闭远程控制 | `vpx listen --disable` | | 清除远程控制密码 | `vpx reset-password` | ## 更新 | 任务 | 命令 | | --- | --- | | 立即检查更新 | `vpx update --check` | | 安装已下载的更新 | `vpx update` | | 跟随稳定版或测试版更新 | `vpx update --channel stable` 或 `vpx update --channel beta` | | 显示版本 | `vpx version` | 在 OpenWrt 上,请改为通过路由器的软件包管理器更新。请参阅[在 OpenWrt 上更新](/zh/docs/12vpx-neo/router#在-openwrt-上更新)。 ## 出现问题时 在更改设置或重新连接之前,请先保存一份报告: ```sh vpx diagnostics > vpx-diagnostics.json ``` 这份报告只读取 12VPX NEO 已经掌握的信息。它不会更改任何内容,也不包含您的设置链接和密码。您可以把它发给客服,同时说明您当时在做什么、问题发生的时间以及确切的错误信息。`vpx diagnostics --explain` 会输出一份故障排除指南,即使没有网络连接也可以使用。 `vpx logs` 显示最近的事件,`vpx logs --follow` 会在您重试时持续显示新的事件。日志可能包含您访问过的网站名称,因此分享之前请先看一遍。 如需从终端联系客服,请查看 `vpx support --help`。这些命令会真的发送您的消息或日志。[支持、日志和您的账户](/zh/docs/12vpx-neo/support)介绍了联系我们的其他方式。 在 Windows 上,`vpx repair-driver` 会运行[驱动修复](/zh/docs/12vpx-neo/settings#在-windows-上修复-vpn-驱动)。