案例

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 的使用。

关于此条目

类型
案例
类别
独立重建案例
关联
独立重建项目
目标
应用 · 协议

来源复核于

说明已依据一手来源复核;这不代表已运行验证、经过安全审计或确认兼容。

报告条目过时 建议修正翻译

一手来源

  1. README.md GitHub · Diniboy1123/usque · 修订 6aa03fc
  2. RESEARCH.md GitHub · Diniboy1123/usque · 修订 6aa03fc
  3. go.mod GitHub · Diniboy1123/usque · 修订 6aa03fc
  4. api/masque.go GitHub · Diniboy1123/usque · 修订 6aa03fc
  5. api/tunnel.go GitHub · Diniboy1123/usque · 修订 6aa03fc
  6. cmd/nativetun_windows.go GitHub · Diniboy1123/usque · 修订 6aa03fc
  7. .github/workflows/ci.yml GitHub · Diniboy1123/usque · 修订 6aa03fc
  8. goreleaser.yml GitHub · Diniboy1123/usque · 修订 6aa03fc
  9. Dockerfile GitHub · Diniboy1123/usque · 修订 6aa03fc
  10. LICENSE.md GitHub · Diniboy1123/usque · 修订 6aa03fc
  11. https://github.com/Diniboy1123/usque/releases/tag/v4.2.1
  12. https://datatracker.ietf.org/doc/rfc9484/

同分区更多条目:应用

应用分区全部 87 项资源应用案例(37)