案例
usque:Cloudflare WARP MASQUE 模式的开源再实现
用 Go 重新实现 Cloudflare WARP 客户端的 MASQUE 模式:通过基于 QUIC/HTTP/3 的 Connect-IP(RFC 9484)隧道传输 IP 流量,并以原生 TUN 设备、SOCKS5 或 HTTP 代理、仅 TCP 的 L4 代理或端口转发等形式提供。RESEARCH.md 记录了作者如何借助 Frida、mitmproxy、JADX、IDA Free 和 Wireshark 分析官方 Android 客户端,弄清设备注册、TLS 客户端认证以及 Cloudflare 非标准的 cf-connect-ip 变体。它在官方客户端之外向 Cloudflare 服务注册并建立连接。
使用条件与局限
- 审阅对象为 2026-07-20 的 main 最新提交,与 v4.2.1 版一致。README 称项目仍处于早期阶段,作为库使用时 Go API 不稳定,并说明只有 Linux amd64 发布版经过测试,尽管发布内容包括多种架构的 Android、Linux、Windows 和 macOS 构建。RESEARCH.md 是叙述式研究记录;README 计划撰写的简明协议文档尚未完成。
- 需要访问 Cloudflare WARP 服务:register 命令会新建 WARP 账号并注册设备密钥,生成的配置文件保存该注册的密钥和令牌。该工具在官方客户端之外使用 Cloudflare 的服务;README 声明它与 Cloudflare 无关,未获其认可或审查,要求用户不要滥用服务,并指出该工具可被识别。ZeroTrust 登录需要该工具无法完成的 SSO;本条目不提供任何令牌、账号或配置细节。
- 构建需要 Go 1.26.3+ 并关闭 CGO。README 称 Cloudflare 的实现并不完全符合 RFC 9484,因此项目依赖作者 fork 的 connect-ip-go;连接由 quic-go 承载,gVisor 和 wireguard-go 的网络栈使各代理模式无需 root 即可在用户态运行。原生 TUN 模式仅支持 Linux 和 Windows,但 README 的已知问题列表仍写着仅支持 Linux。仓库提供 Dockerfile。
- CI 会校验模块并运行 go build、go vet、go test 和 golangci-lint,但所审阅的文件树中没有 Go 测试文件,因此正确性证据来自作者自己的使用。README 报告一次 SOCKS5 测速结果,在 1 Gbps 链路上约为 834/773 Mbps,并列出 happy eyeballs、WireGuard 和 DNS-over-HTTPS 等缺失功能。这些结果均为作者报告,本次来源核查未运行任何内容。
- 采用 MIT 许可(LICENSE.md)。Cloudflare 的服务条款和商标另行适用,README 将 usque 描述为独立研究项目。所审阅来源未确立任何 AI 或 REA 的使用。
关于此条目
- 类型
- 案例
- 类别
- 独立重建案例
- 关联
- 独立重建项目
- 目标
- 应用 · 协议
来源复核于
说明已依据一手来源复核;这不代表已运行验证、经过安全审计或确认兼容。
一手来源
- README.md GitHub · Diniboy1123/usque · 修订 6aa03fc
- RESEARCH.md GitHub · Diniboy1123/usque · 修订 6aa03fc
- go.mod GitHub · Diniboy1123/usque · 修订 6aa03fc
- api/masque.go GitHub · Diniboy1123/usque · 修订 6aa03fc
- api/tunnel.go GitHub · Diniboy1123/usque · 修订 6aa03fc
- cmd/nativetun_windows.go GitHub · Diniboy1123/usque · 修订 6aa03fc
- .github/workflows/ci.yml GitHub · Diniboy1123/usque · 修订 6aa03fc
- goreleaser.yml GitHub · Diniboy1123/usque · 修订 6aa03fc
- Dockerfile GitHub · Diniboy1123/usque · 修订 6aa03fc
- LICENSE.md GitHub · Diniboy1123/usque · 修订 6aa03fc
- https://github.com/Diniboy1123/usque/releases/tag/v4.2.1
- https://datatracker.ietf.org/doc/rfc9484/
同分区更多条目:应用
- Webamp:在浏览器中重新实现 Winamp 2 · 案例
- JADX-AI-MCP · 集成
- apktool-mcp-server Apktool MCP 服务 · 集成
- frida-mcp (yfe404) · 集成
- Super Trouper · 集成
- Frida · 工具