免系统代理抓手机流量:Proxelar WireGuard 模式扫码配置实战教程
免系统代理抓手机流量:Proxelar WireGuard 模式扫码配置实战教程
Proxelar 是一款开源的脚本化本地流量工作台,支持检查、拦截、重放和重写 HTTP/HTTPS 与 WebSocket 流量。本教程聚焦它的 WireGuard 模式:手机或 IoT 设备无需设置系统代理、无需配置防火墙,只需扫一个二维码,全部流量就能汇入你的抓包界面,是排查 App 网络问题最快的方式之一。
为什么选择 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 查看完整列表:
HTTPS 解密同样需要信任 Proxelar 的本地 CA:在手机上访问 http://proxel.ar(流量需经 Proxelar 路由),下载并安装根证书。注意 Android 7+ 上的应用仅在开发者显式选择信任用户证书时才会解密,证书固定(pinning)的 App 仍无法拦截。
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 脚本能力,它成为排查移动端网络问题的一把快刀。


