Clash VPN怎么通过API查看当前活跃的连接数？

通过GET /connections接口获取连接列表

调用API端点获取活跃连接数据

调用Clash VPN的GET /connections接口是获取当前活跃连接信息的标准方法，该接口返回所有连接状态的JSON数据集。使用curl -X GET http://127.0.0.1:9090/connections命令即可调用，若配置了secret密钥需在请求头中添加Authorization: Bearer your-password。响应数据中的connections数组包含了当前所有活跃连接的详细信息，数组长度即为活跃连接数，通过解析该数组可获取每条连接的目标地址、协议类型和传输速率等关键信息。

在浏览器中直接访问API查看连接快照

对于快速查看连接状态的场景，可直接在浏览器地址栏输入http://127.0.0.1:9090/connections访问API端点，页面会显示当前连接快照的JSON数据。若配置了secret密钥，浏览器访问时需通过扩展或插件添加认证头，否则推荐使用Postman等API测试工具。返回的JSON数据中connections数组的根级字段可快速获取连接总数，每条连接的详细数据在数组内逐条列出，方便人工浏览和初步排查。

在Dashboard面板中自动获取并展示连接数

对于不熟悉命令行操作的用户，可通过Web Dashboard面板直观地查看当前连接数，无需手动调用API或解析JSON数据。在YACD或zashboard等面板中，填入Clash API地址（如http://127.0.0.1:9090）和secret密钥后，Dashboard会自动调用GET /connections接口获取数据。面板的“连接”页面会实时显示当前活跃连接总数，并以表格或列表形式展示每条连接的详细信息，包括目标地址、协议类型、传输速率和命中的规则名称等。

返回数据的结构与关键字段解读

connections数组与连接总数统计

GET /connections接口返回的JSON数据包含downloadTotal（总下载流量）、uploadTotal（总上传流量）和connections（活跃连接数组）三个主要字段。connections数组的长度即为当前活跃连接的总数，通过程序解析该数组的长度即可获得连接数，无需手动统计。该数组中的每个元素代表一条独立的活跃连接，包含该连接从建立到当前时刻的全部状态信息。

单条连接的详细字段说明

connections数组中的每个连接对象包含id（连接唯一标识）、metadata（包含源地址、目标地址、协议类型的元数据）、upload和download（该连接的流量统计）、start（连接建立时间）、chains（经过的代理链路）和rule（命中的规则名称）。metadata中的host字段为目标域名，network字段为协议类型（tcp/udp），type字段为连接类型（Direct/Proxy）。通过这些字段，用户不仅能获知连接数量，还能追踪具体的流量去向和规则匹配情况。

通过流量字段统计连接的传输数据量

每条连接中的upload和download字段记录了该连接从建立到当前时刻的累计上下行流量（单位为字节）。用户可通过GET /connections接口获取所有连接的流量数据，对全部连接的upload和download求和可得到当前会话的总流量。该数据在Dashboard面板中通常以图表或数字形式展示，帮助用户了解当前的流量使用情况。若需统计历史总流量，还需结合GET /traffic接口配合使用。

使用jq工具提取和统计连接数

通过jq命令获取连接数量

在自动化脚本或数据处理场景中，可使用jq命令行工具从API返回的JSON数据中精准提取连接数量。执行curl -s http://127.0.0.1:9090/connections | jq '.connections | length'可直接输出当前活跃连接数，无需手动数数组元素。若配置了secret密钥，命令为curl -s -H "Authorization: Bearer your-password" http://127.0.0.1:9090/connections | jq '.connections | length'。该命令输出一个纯数字，便于赋值给变量或存入日志文件。

提取指定字段进行进一步分析

除了统计连接数量，jq还可提取connections数组中的特定字段进行深入分析。执行curl -s http://127.0.0.1:9090/connections | jq '.connections[] | {host: .metadata.host, rule: .rule}'可提取每条连接的目标域名和命中的规则名称。该命令输出为JSON格式的字段列表，方便排查特定域名的连接是否走代理，或统计每个规则匹配的连接数量。结合grep或sort命令可进一步筛选和聚合数据。

将连接数纳入监控脚本

在需要持续监控连接数峰值的场景中，可将curl和jq命令封装为监控脚本，定期记录连接数到日志文件。脚本示例为#!/bin/bash COUNT=$(curl -s http://127.0.0.1:9090/connections | jq '.connections | length'); echo "$(date): $COUNT" >> /var/log/clash_connections.log。配合cron定时任务每分钟记录一次，可建立连接数的历史趋势数据，用于分析代理使用模式和发现异常流量高峰。

使用watch命令实现实时刷新监控

watch命令的基本用法

对于需要持续观察连接数变化趋势的场景，可通过watch命令结合curl和jq实现自动刷新监控。在终端中执行watch -n 2 'curl -s http://127.0.0.1:9090/connections | jq ".connections | length"'，每隔2秒自动刷新显示当前的活跃连接数。该命令在排查代理连接异常、统计并发连接数峰值或调试规则配置时较为实用，无需手动重复输入命令即可持续观察连接数的动态变化。

调整刷新间隔适应不同场景

watch命令的-n参数控制刷新间隔（单位为秒），用户可根据实际需求调整该值。在排查连接异常时，可将间隔设为1秒以获取更高的实时性；在长期监控时，可将间隔设为5-10秒减少系统开销。命令示例为watch -n 5 'curl -s http://127.0.0.1:9090/connections | jq ".connections | length"'，每5秒刷新一次。较短的刷新间隔会增加CPU使用率，但可捕捉到快速的连接波动。

结合Dashboard面板实现可视化监控

若命令行环境不便于观察，可通过Dashboard面板实现连接数的可视化实时监控。在YACD或zashboard面板中，连接页面会自动刷新并更新连接列表，无需手动操作即可观察连接数的变化。Dashboard面板的刷新频率通常由面板自身的设置控制，用户可在面板设置中调整刷新间隔。Dashboard的可视化界面比命令行更适合非技术用户，且能同时展示连接详情和流量统计。

通过DELETE /connections关闭所有连接

调用DELETE接口关闭所有活跃连接

除查看连接数外，API还支持通过DELETE /connections接口关闭所有当前活跃连接，或通过DELETE /connections/:id关闭指定连接。执行curl -X DELETE http://127.0.0.1:9090/connections可强制断开所有连接，若配置了secret需添加认证头。该操作在切换代理节点后需要新连接立即使用新节点时尤为有用，关闭后应用会自动重新建立连接，新的连接将使用切换后的节点。

关闭指定连接的精确控制

通过DELETE /connections/:id接口可关闭指定的单条连接而不影响其他连接。先执行GET /connections获取所有连接的id列表，再执行curl -X DELETE http://127.0.0.1:9090/connections/{id}关闭特定连接。该功能适用于需要断开特定应用或特定目标地址连接的场景，例如某条连接卡死或流量异常时，可精准关闭而不干扰其他正常连接。

关闭连接后的网络行为

执行DELETE /connections后，Clash会立即断开所有TCP连接，已关闭连接的应用会收到连接重置信号，自动尝试重新建立连接。新的连接将重新经过Clash的规则匹配流程，若用户在关闭前已切换了代理节点，新的连接将使用新节点。该操作不会影响Clash的运行状态或配置，仅刷新当前的连接池，是切换节点后确保新连接立即生效的有效手段。

常见问题FAQ