代理客户端与网络工具指南资料核对 ·

AFQKIT / TOOL GUIDE

工具选明白,连接有章法。

从官方工具下载,到配置、验证与排查。了解每个工具适合什么、怎么用,以及遇到问题先检查哪里。

官方来源按设备筛选本地生成验证命令

从你的使用场景开始

选择场景,查看配置重点与验证方法。

学习与检索 · 先验证浏览器,再验证应用

查资料、看课程、使用在线工具:先完成客户端配置,再分别检查浏览器和学习应用。校园网与家用网络的连接表现可能不同。

01

代理与网络工具目录

12 款工具 · 三类用途

按用途和设备查找工具:客户端用于日常连接,代理内核适合手动配置,网络诊断工具用于检查 DNS、路由与协议问题。以下下载入口均指向官方来源。

用途
设备

显示 12 个工具。按用途和设备筛选,查看适合你的官方入口。

代理客户端

Hiddify

多平台与多种配置格式
详细教程 官方下载 github.com/hiddify/hiddify-app/releases/latest

正式版 v4.1.12026.03.06 发布

支持平台
AndroidiOSWindowsmacOSLinux
内核 / 配置
sing-box / sing-box、V2Ray、Clash 等
主要能力
远程配置、自动更新与基于延迟的节点选择。
使用前确认
格式支持不代表所有自定义规则都能等价迁移;导入后需验证实际行为。
代理客户端

v2rayN

桌面多内核代理客户端
详细教程 官方下载 github.com/2dust/v2rayN/releases/latest

正式版 7.25.42026.09.30 发布

支持平台
WindowsmacOSLinux
内核 / 配置
Xray / sing-box 等,节点链接与对应内核配置
主要能力
节点与订阅管理、路由规则、系统代理及 TUN。
使用前确认
不同内核的配置字段不同;按系统与架构选择安装包,并核对内核版本。
代理客户端

Karing

跨设备配置与规则管理
详细教程 官方下载 github.com/KaringX/karing/releases/latest

正式版 v1.2.25.28022026.09.10 发布

支持平台
WindowsmacOSAndroidiOSLinux
内核 / 配置
修改版 sing-box;Clash、sing-box、节点订阅等
主要能力
多订阅规则、策略组、WebDAV 与局域网同步。
使用前确认
Clash.Meta 配置仅部分兼容;Linux 安装前确认 glibc 等系统依赖。
代理客户端

Clash Mi

多平台 mihomo 图形客户端
详细教程 官方下载 github.com/KaringX/clashmi/releases/latest

正式版 v1.0.30.16052026.09.22 发布

支持平台
WindowsmacOSAndroidiOSLinux
内核 / 配置
mihomo / Clash.Meta,YAML 配置
主要能力
配置导入、规则路由与内置 Zashboard 面板。
使用前确认
按对应平台安装;iOS 从官方商店入口获取,导入后检查 YAML 兼容性。
网络诊断

Wireshark

抓包与网络协议分析
详细教程 官方下载 www.wireshark.org/download.html

版本与安装方式以官方下载页为准

支持平台
WindowsmacOSLinux
使用方式
图形界面 / TShark,pcap 与 pcapng
主要能力
捕获网络报文、过滤连接、分析 DNS 与 TCP / TLS 握手。
使用前确认
GitHub 数据对应官方源码镜像;Linux 通过发行版安装,抓包文件分享前脱敏。

数据核对:。Stars / Forks 来自 GitHub;下载量为当前公开 GitHub Release 附件的累计下载次数(含预发布);未提供下载统计的项目会明确标注,不含商店和其他渠道,也不等于用户人数。点击数据可查看官方来源。

资料来源:各工具的官方项目、发行页和使用文档。点击卡片内的文档或数据可查看原始来源。平台、系统版本与配置兼容性以对应官方说明为准。

02

配置指南:从安装到验证

一次只调整一个变量
1

确认设备与安装包

核对操作系统、最低版本与 x64 / ARM64 等架构。优先选择官方稳定版,阅读该版本的安装说明。

2

导入兼容配置

在客户端内导入你已有的配置文件或订阅,确认解析成功、节点列表可见。不要把订阅令牌放进公开截图或第三方转换页面。

3

选择代理与路由模式

先按文档开启系统代理并使用规则模式。应用没有读取系统代理时,再检查应用设置或按官方说明配置 TUN。

4

验证真实任务

分别打开常用的学习网站与课程应用,并查看客户端连接记录,确认请求是否进入客户端、匹配了什么规则。

代理方式与路由模式是两个不同的设置
设置解决什么问题需要留意
系统代理告诉支持该设置的应用使用本机代理端口。终端、Git 和部分应用可能有自己的代理设置。
TUN 模式通过虚拟网卡和路由接管配置范围内的流量。需要相应权限;路由、DNS、排除项及其他 VPN 会影响结果。
规则模式依据配置规则选择代理、直连或其他策略。是否走代理取决于命中规则和策略组选择。
全局模式将进入客户端的请求交给所选全局策略。不能让未进入客户端的应用自动走代理;也不保证每个网站都可用。

概念参考:Clash Verge Rev 名词解释。不同客户端的入口与默认设置可能不同,以对应版本文档为准。

03

本地代理验证工具

在浏览器里生成,在你的电脑上验证

生成终端验证命令

浏览器能访问、终端却不通?用明确指定代理的请求,检查本机监听端口与 Git 连接。先在客户端设置中确认端口和协议。

只生成文本,不执行命令、不发起检测请求,也无需填写订阅。代理地址固定为本机 127.0.0.1。

7890 仅为填写示例;请使用客户端实际监听的端口。此工具适用于本机已启用 HTTP 或 SOCKS 监听的桌面客户端。

等待生成命令。

怎么运行,怎么读结果?

先确认客户端正在运行,再在所选终端执行 curl 命令;Windows PowerShell 使用 curl.exe。本页只生成文本,连接结果来自你的电脑。Git 远程查询是开发场景的可选检查,需要已安装 Git,可按需要单独执行。

curl 明确指定本机代理,并为这次请求覆盖环境中的代理例外;socks5h 表示由代理解析目标域名。收到 HTTP 响应只说明这次请求得到了响应;HTTP 代理的 200 Connection established 仅表示隧道建立,还要看后续 TLS 与目标响应。是否按预期走远端代理策略,需结合客户端连接记录确认。

对照响应状态、curl 错误码与下一步
看到的结果意味着什么下一步
HTTP 2xx / 3xx2xx 表示响应者报告本次请求成功;3xx 是重定向或其他处理状态,不能直接当作最终页面成功。检查跳转位置,在目标应用复核实际任务,并确认请求经过的路径。
HTTP 4xx / 5xx已收到某个 HTTP 响应者的错误状态;来源可能是目标、CDN、代理或网关。未用 --fail 时,curl 仍可能退出 0。按状态和响应内容检查认证、路径及服务策略,参见HTTP 错误怎么读。
HEAD 返回 405当前资源不允许这个请求方法;HEAD 与普通 GET 的处理可能不同。用同一目标的普通浏览器请求对照,不能只凭 HEAD 405 判定代理失效。
curl: (7)连接目标或代理失败;先看错误里列出的地址与端口。若是本机端口,检查客户端进程、监听地址与协议;再看入口选择与连接错误。
curl: (28)触发了超时限制,可能发生在解析、连接、握手或等待响应等阶段。结合错误文字与客户端日志,按分层定位顺序找到最早失败处。
curl: (60)对端证书校验失败,当前 HTTPS 请求尚未通过身份验证。核对系统时间、域名与信任链,按证书错误排查处理,保留证书校验。

Git 返回提交哈希与 HEAD 才说明本次远程查询成功。-c http.proxy 只影响这次 Git 调用;已有的 NO_PROXY / no_proxy 或更具体的 Git 代理设置仍可能影响路径,需对照客户端记录。长时间未返回时,可在终端按 Ctrl+C 停止查询。

单次命令不能代替其他应用、域名或线路速度的验证。结果说明依据 curl 请求方法、HTTP 错误处理与退出码参考。

命令依据:curl 官方手册 · Git 临时配置参数。

04

按症状排查问题

先看证据,再改设置
从配置、应用、路由到 DNS,逐层确认
遇到的症状先检查什么下一步怎么做
配置导入失败客户端支持的格式、订阅是否过期、导入日志。确认返回的是配置而非登录页,按语法、字段与版本检查顺序定位;订阅导入再看订阅与内核兼容排查。分享日志前遮盖令牌和节点凭据。
浏览器通,Git / 终端不通应用是否读取系统代理,本机监听协议与端口。生成一次性代理验证命令,再按应用路径验证步骤对照客户端记录。成功后按应用文档配置代理,或评估 TUN。
只有部分网站打不开连接记录里的目标域名、命中规则与策略组。按分流排查步骤确认出站,再看DNS、连接、TLS 与 HTTP 定位顺序。分别验证,不只看节点延迟。
域名解析失败客户端 DNS 日志与应用自己的加密 DNS 设置。先确认应用实际使用的解析路径;需要查询对照时,按doggo 的解析器对照示例检查。终端有答案不等于浏览器或代理侧解析一致。
开启 TUN 后断网服务权限、路由、DNS,以及其他 VPN / 虚拟网卡。先关闭 TUN 恢复连接,再按模式切换与断网恢复步骤逐项检查,并对照对应客户端文档。避免同时启用多个接管网络的工具。
退出客户端后仍无法联网系统或应用是否仍指向已关闭的本机端口。按退出后的网络恢复检查处理残留代理,并核对应用自己的代理设置;企业管理的代理按组织要求处理。

准备求助信息:客户端版本、操作系统、代理模式、复现步骤和已脱敏日志。先按排查前的记录清单保留现场,明确是导入失败、连接失败还是某个应用失败。

05

基础概念:读懂设置与连接

全部概念 →

客户端、DNS 与分流各自负责什么?用原理图和具体例子把请求路径理清楚,再回到对应工具设置。

REFERENCE / FAQ

把常见疑问
说明白。

理解工具的边界,少走配置弯路。

安装客户端后,就能直接连接吗?

客户端是读取配置和建立连接的软件,通常需要你已有的节点配置或订阅。先确认配置格式与客户端兼容,再在客户端内导入并验证。

同一个订阅能在所有客户端里使用吗?

不一定。Clash / mihomo YAML、sing-box JSON 和节点链接是不同格式,规则、DNS 与扩展字段也可能不同。选择订阅提供的对应格式,并检查客户端导入日志;不要把格式支持理解为所有功能完全等价。

延迟测试正常,为什么网页仍打不开?

延迟测试只检查特定测试目标与路径。实际网站还受域名解析、路由规则、TLS、目标站点及账号状态影响。查看该网站对应的连接记录,再用真实请求验证。

系统代理、TUN 和全局模式需要一起打开吗?

它们解决不同问题,没有统一的“全部开启”配置。系统代理与 TUN 影响流量如何进入客户端;规则与全局模式决定进入后的流量如何路由。先选择能覆盖实际应用的方式,再验证。

这个页面会接收我的订阅或配置吗?

本站没有订阅或配置上传入口。命令工具只在当前浏览器中生成文本,不读取客户端状态、不执行命令、不保存输入。运行命令时由你的电脑请求 GitHub,实际路径受本机代理与例外设置影响;打开官方链接时会访问相应外部网站。

更换客户端或升级前需要做什么?

先备份本地配置、规则与必要设置,并查看新版本的变更说明。跨内核迁移时重点核对格式、DNS 与路由;更新后分别验证浏览器、终端和常用应用。