ProxyPin跨平台部署指南：Windows/macOS/Linux环境配置详解

ProxyPin是一款基于Flutter框架开发的开源免费抓包软件，支持Windows、macOS、Linux等全平台系统。本文将详细介绍在三大桌面操作系统上的部署流程，帮助用户快速搭建抓包环境。

项目概述

ProxyPin支持拦截、检查和重写HTTP(S)流量，特别优化了Flutter应用抓包体验。其核心特性包括手机扫码连接、域名过滤、脚本扩展等，适合开发者进行网络调试和流量分析。项目源码结构清晰，各平台部署配置文件集中在对应系统目录下：

• Windows配置：windows/
• macOS配置：macos/
• Linux配置：linux/

Windows环境部署

系统要求

• Windows 10/11 64位系统
• .NET Framework 4.8及以上
• 管理员权限（用于端口配置）

安装步骤

1. 下载安装包
   从项目发布页面获取Windows安装程序，或通过源码编译：

   git clone https://gitcode.com/GitHub_Trending/ne/network_proxy_flutter
   cd network_proxy_flutter
   flutter build windows --release
   

2. 安装证书
   双击运行安装目录下的证书文件，完成根证书安装： assets/certs/ca.crt

3. 配置端口转发
   编辑安装目录下的配置文件，设置监听端口： windows/runner/Runner.rc

4. 启动应用
   双击ProxyPin.exe启动程序，首次运行需允许防火墙例外。

常见问题解决

• 端口占用：修改配置文件中的端口号，默认端口为8888
• 证书信任问题：手动将证书添加到"受信任的根证书颁发机构"
• 启动失败：检查windows/packaging/exe/make_config.yaml中的应用ID配置

macOS环境部署

系统要求

• macOS 10.15+（Catalina及以上版本）
• Xcode 12.0+（编译需要）
• 开发工具Command Line Tools

安装步骤

1. 编译应用

   git clone https://gitcode.com/GitHub_Trending/ne/network_proxy_flutter
   cd network_proxy_flutter
   flutter build macos --release
   

2. 信任开发者
   macOS首次打开会提示"不受信任的开发者"，需在"系统偏好设置-安全性与隐私"中允许运行。

3. 证书配置
   导入SSL根证书并设置信任：

   sudo security add-trusted-cert -d -r trustRoot -k /Library/Keychains/System.keychain assets/certs/ca.crt
   

4. 启动应用
   将编译生成的ProxyPin.app拖入应用程序文件夹，双击启动。

高级配置

• 自动启动：添加到系统登录项
• 网络过滤规则：编辑macos/Runner/Info.plist
• 打包配置：修改macos/packaging/dmg/make_config.yaml

Linux环境部署

系统要求

• Ubuntu 20.04/Debian 11及以上
• GTK 3.0开发库
• libssl-dev依赖包

安装步骤

1. 安装依赖

   sudo apt update
   sudo apt install -y libgtk-3-dev libssl-dev libayatana-appindicator3-dev
   

2. 编译应用

   git clone https://gitcode.com/GitHub_Trending/ne/network_proxy_flutter
   cd network_proxy_flutter
   flutter build linux --release
   

3. 安装证书

   sudo cp assets/certs/ca.crt /usr/local/share/ca-certificates/
   sudo update-ca-certificates
   

4. 创建桌面快捷方式
   使用项目提供的.desktop文件： linux/proxy-pin.desktop

编译配置

Linux平台插件配置文件位于：linux/flutter/generated_plugins.cmake，如需添加额外插件，可在此文件中修改。

跨平台通用配置

移动设备连接

通过扫码功能快速配置移动设备代理，无需手动设置WiFi代理：

1. 在桌面端点击"扫码连接"按钮
2. 手机端打开ProxyPin应用扫描二维码
3. 自动同步证书和代理配置

域名过滤设置

编辑过滤规则文件，添加需要拦截的域名： lib/network/components/host_filter.dart

脚本扩展

通过JavaScript脚本扩展功能，脚本文件存放路径： assets/js/fetch.js

验证部署

功能测试

1. 启动ProxyPin，确保状态栏显示"已就绪"
2. 打开浏览器访问任意HTTPS网站
3. 在ProxyPin界面查看捕获的请求数据

日志查看

各平台日志文件路径：

• Windows: %APPDATA%\ProxyPin\logs
• macOS: ~/Library/Logs/ProxyPin
• Linux: ~/.config/proxypin/logs

总结

ProxyPin通过Flutter框架实现了真正的跨平台体验，各系统部署流程虽有差异，但核心功能保持一致。通过本文档提供的配置指南，开发者可在不同操作系统环境下快速搭建专业的抓包分析环境。

项目持续维护中，更多功能请参考官方文档：

• README.md
• README_CN.md

如有部署问题，欢迎提交Issue或参与社区讨论。