免系统代理抓手机流量:Proxelar WireGuard 模式扫码配置实战教程

原创2026-10-15 06:49:111,952 阅读

免系统代理抓手机流量:Proxelar WireGuard 模式扫码配置实战教程

Proxelar 是一款开源的脚本化本地流量工作台,支持检查、拦截、重放和重写 HTTP/HTTPS 与 WebSocket 流量。本教程聚焦它的 WireGuard 模式:手机或 IoT 设备无需设置系统代理、无需配置防火墙,只需扫一个二维码,全部流量就能汇入你的抓包界面,是排查 App 网络问题最快的方式之一。

Proxelar 抓包工具概览图:单二进制 MITM 代理,支持 TUI、Web GUI、Lua 钩子与 WireGuard 模式

为什么选择 WireGuard 模式抓手机流量

传统的 HTTP 代理抓包要求手机端手动配置代理地址和端口,还会遇到以下麻烦:

  • 系统代理不覆盖全部流量——部分 App 绕过系统代理,直连网络,抓不到请求;
  • 配置繁琐——每台设备都要设置 Wi-Fi 代理,换网络后要重新配;
  • 防火墙与证书问题——需要额外处理自签名证书提示。

WireGuard 模式的做法完全不同:Proxelar 在本机启动一个 WireGuard VPN 隧道,手机连接这个隧道后,所有流量(TCP 与 UDP)都会经过 Proxelar,由它在用户态网络协议栈中重组 TCP 流,再走标准的 HTTP、TLS 中间人(MITM)、WebSocket 和原始流处理路径。

对比项 传统 HTTP 代理 WireGuard 模式
手机端配置 需设置系统代理 只需扫码连 VPN
流量覆盖 可能被 App 绕过 全量 TCP/UDP 流量
HTTPS 解密 需安装 CA 证书 同样需安装 CA 证书
HTTP/3 (QUIC) 通常抓不到 支持拦截并识别 SNI

一键安装 Proxelar

安装非常简单,任选一种方式:

# macOS / Linux(Homebrew)
brew install proxelar

# Windows(winget)
winget install --id EmanueleMicheletti.Proxelar --exact

# Rust 环境(Cargo)
cargo install proxelar

也可以使用 Docker 运行(官方镜像支持 linux/amd64 和 linux/arm64):

docker run --rm -it -v ~/.proxelar:/root/.proxelar -p 8080:8080 ghcr.io/emanuele-em/proxelar

💡 提示:~/.proxelar 挂载会让容器复用你本机已信任的 CA 证书,避免每次都要重新信任。

启动 WireGuard 抓包:扫码三步走

第一步:启动 WireGuard 模式

在能访问手机的局域网内(或同一 Wi-Fi 下),执行:

proxelar -m wireguard -b 0.0.0.0 -p 51820 \
  --wireguard-endpoint 192.168.1.10:51820

参数说明:

  • -m wireguard:启用 WireGuard 抓包模式;
  • -b 0.0.0.0:绑定所有网卡,让手机能连进来;
  • -p 51820:WireGuard 隧道监听端口(UDP);
  • --wireguard-endpoint:关键参数,填写手机能访问到的你的电脑的 IP:端口。

--wireguard-endpoint 的推导规则(详见 docs/src/proxy-modes/wireguard-socks-dns.md):

  • 绑定具体 IP 时自动推导;
  • 绑定 0.0.0.0 时会探测到 DNS 服务器的路由;
  • 遇到 NAT、容器、多网卡或公网主机名场景,必须显式指定。

第二步:手机扫码连接

首次启动时,Proxelar 会在状态目录(默认 ~/.proxelar)中生成仅所有者可读写的服务器/客户端密钥和 proxelar-wg.conf 配置文件,然后立即展示一个可扫描的二维码:

  • TUI 界面(默认):二维码直接显示在终端窗口中;
  • Web GUI(proxelar -i gui):在浏览器页面展示同样的二维码;
  • Terminal 模式:启动时打印同款二维码。

在手机上安装 WireGuard App,扫描这个二维码即可建立隧道。客户端配置文件名 proxelar-wg 特意控制在 15 个字符以内,以兼容 Android 的接口名长度限制。

⚠️ 安全提醒:二维码中包含客户端私钥,请只在受信任的屏幕上显示。扫码连接后,只要捕获到第一条流量,二维码就会自动从 TUI 和 Web GUI 上消失;配置文件仍保留在 ~/.proxelar/proxelar-wg.conf,以后也可以直接导入文件而不是扫码。

第三步:流量即时出现

隧道连通后,手机上的请求会立即出现在你的抓包界面中——终端 TUI 实时刷新,或者切换到 Web GUI 查看完整列表:

Proxelar Web GUI 手机流量抓包列表:展示各域名请求的方法、状态码、大小与耗时

HTTPS 解密同样需要信任 Proxelar 的本地 CA:在手机上访问 http://proxel.ar(流量需经 Proxelar 路由),下载并安装根证书。注意 Android 7+ 上的应用仅在开发者显式选择信任用户证书时才会解密,证书固定(pinning)的 App 仍无法拦截。

Proxelar TUI 终端抓包演示:实时查看请求流

HTTPS 与 HTTP/3 抓包能力

WireGuard 模式不只是"把流量引过来",它具备完整的协议处理链路:

  • TCP:在用户态网络协议栈中重组,走标准 HTTP、TLS MITM、WebSocket、原始流路径;
  • HTTP/3 (QUIC):UDP 上的 QUIC Initial 包会被拦截并按 HTTP/3 处理,使用动态 SNI 证书,支持捕获、Lua 钩子与 RFC 9220 WebSocket,这是普通 HTTP 代理完全做不到的;
  • 其他 UDP:直接中继到原始目标地址,不丢包;
  • DNS:53 端口可通过 --dns-upstream 指定上游解析器,用可重复的 --dns-map 覆写域名(例如 --dns-map api.example.com=127.0.0.1 方便本地联调)。

常见问题排查

1. 手机连不上隧道? 确认 --wireguard-endpoint 是手机能访问的 IP(同一 Wi-Fi 下填电脑局域网 IP),并放行 UDP 51820 端口。绑定 0.0.0.0 时 endpoint 是自动推导的,NAT 环境下可能推导出错误地址,显式指定即可。

2. 二维码不见了怎么办? 捕获到流量后二维码会自动消失,可改从 ~/.proxelar/proxelar-wg.conf 导入客户端配置,或重新运行生成。

3. 想换一套客户端身份? 删除 CA 目录中的三个 wireguard-* 文件即可轮换生成的单客户端身份,但需要重新导入客户端配置。

4. 证书提示不受信任? 回到"第三步",通过 http://proxel.ar 安装 CA 证书;证书管理细节见 docs/src/guides/ca-trust.md。

更多玩法

WireGuard 模式只是 Proxelar 六种捕获模式之一(forward、reverse、wireguard、socks5、dns、udp),还可以:

  • 用 Lua 脚本对流量做重写、阻断、Mock:proxelar -m wireguard --script examples/scripts/mock_api.lua;
  • 配合 --save-session debug.proxelar.json 保存会话,稍后导出 HAR / curl / 原始 HTTP;
  • 用 --upstream-proxy 让出站流量再经过一层代理。

更多脚本示例在 examples/scripts/ 目录,WireGuard 相关实现可参考 proxelar-cli/src/wireguard_setup.rs。


总结:Proxelar 的 WireGuard 模式把"抓手机流量"从一套繁琐的代理配置简化成了三步——启动命令、手机扫码、信任 CA 证书。配合 HTTP/3 拦截、DNS 覆写和 Lua 脚本能力,它成为排查移动端网络问题的一把快刀。

登录后查看全文
proxelar