ProxyPin Android 手机安装与首次配置
下载安装方式
方式一：Google Play
在 Google Play 商店搜索「ProxyPin」即可找到官方应用并安装。包名为 com.network.proxy。
方式二：Gitee Releases
国内用户如果无法访问 Google Play，可以从 Gitee 下载 APK 文件：
- 用电脑浏览器访问 Gitee Releases 页面
- 下载最新版 APK 文件到电脑
- 通过数据线、微信文件传输助手或网盘发送到手机
- 在手机上点击 APK 文件安装
如果系统提示「未知来源」，需先在设置中允许安装来自未知来源的应用。
首次启动配置
授予 VPN 权限
首次打开 ProxyPin 时，系统会请求 VPN 连接权限。这是 ProxyPin 工作的核心机制——通过 VPN Service 拦截所有网络流量。
- 点击「确定」或「允许」授权 VPN 权限
- 授权后状态栏会出现小钥匙图标，表示 VPN 已连接
ProxyPin 不会上传用户数据，VPN 通道仅用于本地流量拦截与转发。
安装根证书（关键步骤）
默认情况下 ProxyPin 只能抓取 HTTP 请求。要解密 HTTPS 流量，必须安装并信任自签名根证书：
- 打开 ProxyPin，点击右上角「三个点」菜单
- 选择「HTTPS 代理」
- 打开「启用 HTTPS 代理」开关
- 点击「安装根证书」→「用户证书」→「下载根证书」
- 证书文件下载完成后，按系统提示安装到 Android 安全设置中
Android 7.0+ 的证书限制：从 Android 7.0（Nougat）开始，应用默认只信任系统级证书，不信任用户手动安装的证书。这意味着：
- 浏览器抓包正常（Chrome 等会使用用户证书）
- 部分 App 的 HTTPS 请求可能看不到解密内容（取决于 App 是否信任用户证书）
解决方法：
- 已 root 设备：将用户证书移动到系统证书目录
/system/etc/security/cacerts/ - 未 root 设备：对目标 App 配置 network_security_config 允许用户证书，或使用 ProxyPin 的 Flutter 专用绕过功能（见 Flutter 绕过证书固定）
验证安装
完成上述步骤后，在 ProxyPin 主界面点击右下角「启动」按钮。如果状态栏出现小钥匙图标，且访问 HTTP 网站时能在 ProxyPin 请求列表中看到流量，说明安装成功。
下一步：配置桌面端并扫码连接 → 扫码连接移动端