QuickQ 命令行与高级配置

QuickQ 提供完整的命令行接口（CLI），支持连接管理、节点切换、参数配置、自动化脚本等全部核心功能。命令行操作可减少 60% 以上的重复操作时间，适合需要批量管理、自动化部署或精细调优的技术用户使用。

QuickQ 的命令行工具在所有平台（Windows、macOS、Linux）上均可使用，命令语法完全一致。本教程假设您已安装 QuickQ 且对终端操作有基本了解，不再解释基础终端命令。

命令行工具支持哪些操作系统？

QuickQ CLI（命令行接口）在以下系统中经测试可稳定运行：

• Windows：Windows 10 及以上版本（64 位），通过 PowerShell 或 CMD 执行
• macOS：macOS 12 Monterey 及以上版本，通过 Terminal 执行
• Linux：Ubuntu 20.04+、CentOS 8+、Debian 11+，通过 Bash 执行

CLI 工具随 QuickQ 客户端一同安装，无需额外下载。安装后即可在终端中调用 quickq 命令。

验证 CLI 是否可用： 打开终端，输入 quickq --version。如果返回版本号（如 v3.2.1），说明 CLI 可用；如果提示“命令未找到”，请确认 QuickQ 已正确安装并已添加到系统 PATH 环境变量中。

命令行支持哪些核心操作？

QuickQ CLI 支持以下核心操作，每个操作对应一个子命令：

连接管理：

节点操作：

配置管理：

账号管理：

其他：

每个子命令都支持 --help 参数，可查看该命令的详细用法和示例，如 quickq connect --help。

如何用命令行建立连接？

命令行建立连接的完整操作流程如下：

第一步：登录账号。 如果尚未登录，先执行 quickq login <邮箱/手机号> <密码>。登录凭证会保存在本地，后续会话无需重复登录。

第二步：查看可用节点。 执行 quickq list-nodes，从输出列表中选择一个节点。输出示例：

第三步：选择节点并连接。 执行 quickq select-node 东京，然后执行 quickq connect。如果希望一步完成，可执行 quickq connect --node 东京。

第四步：验证连接状态。 执行 quickq status，确认显示为 已连接 且节点名称正确。

以上步骤的完整命令序列：

如何用命令行切换节点？

命令行切换节点的操作路径如下：

查看当前节点： quickq status 会显示当前连接的节点名称。

查看所有节点： quickq list-nodes 列出所有可用节点。

切换节点： 使用 quickq select-node <节点名称> 切换。节点名称支持模糊匹配，如 quickq select-node 东京 会自动匹配包含“东京”的节点。

切换后重新连接： quickq reconnect 断开当前连接并使用新节点重新建立连接。也可使用 quickq connect 在已断开状态下建立连接。

如果您希望在切换节点后自动重新连接，可以使用 quickq connect --node 东京 一步完成，该命令会自动断开当前连接、切换至指定节点、重新建立连接。

如何查看和修改配置参数？

QuickQ CLI 支持查看和修改连接参数，方便精细化调优。以下为常用配置项：

查看全部配置： quickq config list

查看单个配置： quickq config get protocol（查看当前协议）

修改配置： quickq config set protocol wireguard（将协议切换至 WireGuard）

配置修改后立即生效，不影响当前连接状态。但部分参数（如协议）需要重新连接后才能完全生效。

如何用脚本实现自动化连接？

对于需要频繁连接、断开或定期切换节点的场景，可以使用脚本将 QuickQ CLI 命令组合成自动化流程。

示例脚本（Linux/macOS）：

示例脚本（Windows PowerShell）：

脚本可以添加到系统的定时任务（cron / Task Scheduler）中，实现定时切换节点、定期重连等自动化运维需求。

如果以上内容未能覆盖您的使用场景，可访问 常见问题汇总 或联系 7×24 客服获取进一步支持。