fridare

Fridare

English | 中文 | GUI图形界面

[[图片] GitHub Streak](https://git.io/streak-stats)

[图片] Github stars [图片] Github forks [图片] Github watchers [图片] Github license [图片] Github issues [图片] Github pull requests [图片] Github contributors [图片] Github last commit [图片] Github repo size [图片] Github code size [图片] Github language count [图片] Github top language [图片] Github tag [[图片] GitHub followers](https://github.com/suifei?tab=followers) [[图片] Twitter Follow](https://twitter.com/suiflynn)

任何问题，请到仓库的 fridare issues 内提交，会进行反馈和修复bug，也推荐加QQ群，更好的沟通，但请先提交 issue ，作者再忙也会不定期一次性处理问题，更欢迎朋友们推送PR协同解决问题，感谢！☺️

Fridare 是面向 iOS / Android / Linux / Windows 的 Frida 自动化魔改工具：改名称、端口与协议面标识，降低常见环境检测命中率。提供 命令行 + 跨平台 GUI，并支持 静态补丁 与 Docker 源码重编译 双技术路线。

界面语言 / GUI language — 中文 · English

GUI 可以切换语言。打开 设置 → 界面配置 → 语言，在 中文 和 English 之间选择。切换后窗口立即重建，并写入 config.json（language: zh 或 en）。默认中文。

The GUI can switch language. Open Settings → Interface configuration → Language and choose 中文 or English. The window rebuilds immediately and the choice is saved. Chinese is the default.

文档：双技术路线 · v4.1.0 · xcand-17.24.3 · 16 vs 17 · 16.7.19 · 17.17.1 · Windows · Android · iOS · frida-tools · 安装 · CHANGELOG

双技术路线（v4.0.4）

深度魔改（deep）要点：魔改名固定 5 位小写 a-z；server 与 host client wheel 必须成对（同一 magic）；对象路径含 /re/{magic}/，避免只改 re.frida. 导致 UNKNOWN_METHOD。详细说明见 docs/dual-track.md。

xcand-17.24.3 安装注意（当前 Frida 产物）

• 优先用本 tag：xcand-17.24.3（Android arm64/x86_64 deep + host wheels）。说明见 docs/xcand-17.24.3.md。不是免杀；端口用 -l。
• **Android backend_class != null（#41）：请下 xcand-17.24.3** 的 android zip。本批已修 helper.dex / string_ids（re.xcand，backend_class != null 不再因旧 dex 触发）。旧 kxmwp 包若仍 abort，不要继续用，改下本 tag。
• host-wheels / pip：tools 文件名必须是 PEP 440 本地版本，带 **+**。本 tag：frida_tools-14.11.0+frida.17.24.3.fridare.xcand-py3-none-any.whl。server 与 host wheel 同一 magic。
• 顺带：catalog 架构隔离（#38 续）；Windows 编译路径无黑窗（CREATE_NO_WINDOW）。

历史：kxmwp-17.17.1 / 16.7.19

• host-wheels / pip（旧包）：17：frida_tools-14.10.4+frida.17.17.0.fridare.kxmwp-py3-none-any.whl。16：frida_tools-13.7.1+frida.16.7.19.fridare.kxmwp-py3-none-any.whl。请重新下载 kxmwp-16.7.19 的 host-wheels.zip（旧 zip 里 frida_tools-tools.frida.16.7.19… pip 拒装）。写成 14.10.4.frida. 也会报 Invalid wheel filename（#36）。16/17 的 tools 不能混用。
• **Android kxmwp-server abort：历史说明见 docs/kxmwp-17.17.1.md；新环境请直接用 xcand-17.24.3**。
• **16.x frida-ps：undefined symbol: kxmwp_agent_main**：请重新下载 kxmwp-16.7.19 的 android-arm64 zip。补丁只改 agent ELF 的 hash，并把 GumJS 全局改成 Kxmwp（不会把 Frida. 写回产物）。客户端必须 frida==16.7.19 魔改 wheel。
• **Frida 17 Java.perform**：frida CLI / frida-trace 自带 java-bridge。Python session.create_script 要自己处理 frida:load-bridge，否则 Java is not defined。native Interceptor 不受影响。用法见 docs/xcand-17.24.3.md / docs/kxmwp-17.17.1.md。

GUI：打开「源码重编译」→ 选 deep →「一键深度定制（①+② deep）」
Host：只跑 GUI / AI 改挂载源码 / docker 客户端
Docker：clone · configure · make（含 MinGW windows-x86_64）
产物：catalog/ / / /binaries/*-server.exe + python/host wheels + PROTOCOL-SYNC

写给 Windows 用户（.cmd / .bat 小坑）

中文 Windows 里 cmd.exe 用的不是 UTF-8，而是系统代码页（常见 GBK/CP936）。所以：

1. **.cmd / .bat 里请只用英文（ASCII）** —— 写中文（哪怕文件是 UTF-8）容易乱码、if/goto 异常、脚本跑一半就挂。
2. **换行必须是 Windows 的 CRLF（\r\n）** —— 用 LF 存盘时，部分环境下批处理会解析失败。
3. 本仓库 win/patch-frida.cmd、win/patch-frida-tools.cmd、ui/build.bat 都按上面规则写好了；GUI / PowerShell / Markdown 可以用中文，不受影响。
4. 改完脚本可自检：powershell -File win\test_cmd_ascii.ps1

更细的说明见 win/README.md。

欢迎大家入QQ群讨论：QQ 555354813 ，如本项目对你有所帮助，记得给作者加星鼓励哦！

特性

v4.x 核心能力

经典能力（CLI + GUI 共用）

• 自动下载并修改指定版本 frida-server / agent / gadget
• 自定义名称与端口；arm / arm64 等架构
• 二进制替换：frida-server、frida-agent、frida-tools
• 修改版 .deb 打包；Conda / 多 Python 环境
• macho / elf / pe；Windows · Linux · macOS · Android · iOS
• 配置文件、依赖检查、模块列表与自更新

欢迎使用一键安装快速上手：

curl -s https://raw.githubusercontent.com/suifei/fridare/main/fridare.sh | bash -s install

🎉 GUI 与 v4 大版本（摘要）

v4.0.4 — 双轨深度魔改 · Docker · Agent（2026-08）

• 源码重编译标签默认 deep；一键深度 = 开发魔改 + Docker 编译
• Windows x86_64-w64-mingw32 server 产物 + host wheel PROTOCOL-SYNC
• MinGW wrap 预种子脚本自动 stage 进容器 /work
• OpenAI 端点真实 HTTP 探测；代理出口开关默认关
• 详见 docs/dual-track.md 与 CHANGELOG

v4.0.0 — 图形界面发布（2025-01-02）

重大更新：图形用户界面发布

Fridare 现在提供了基于 Fyne 框架的现代化图形用户界面，让 Frida 服务器的修改变得更加直观和便捷！

🚀 GUI版本亮点

• 🎨 现代化界面：采用 Fyne 框架构建的跨平台原生GUI应用
• 🖱️ 拖拽操作：支持文件拖拽，简化文件选择流程
• 📊 实时监控：可视化进度条和实时日志显示
• ⚙️ 可视化配置：图形化的配置管理界面
• 🔧 多工具集成：包含创建、修补、GUI三个独立工具

📦 本机构建 GUI

依赖：Go 1.21+；GUI 需要 CGO + 本机 C 编译器（Windows 上 MinGW/gcc 在 PATH）。CLI 工具可 CGO_ENABLED=0 纯静态构建。

Windows（推荐 PowerShell，无需 bash）：

cd ui
.\build.ps1
# 或 .\build.bat

Linux / macOS：

cd ui
./build.sh
# 交叉编译 Windows GUI: ./build.sh windows   # 仍需目标侧图形依赖，一般建议本机构建

产物（ui/build/）：

🖥️ 运行

.\build\fridare-gui.exe          # Windows
./build/fridare-gui              # Linux / macOS

预编译包请直接下 Releases（无需本地装 Go）。

📸 GUI版本截图

[图片] 查看原图 [图片] 查看原图 [图片] 查看原图 [图片] 查看原图 [图片] 查看原图 [图片] 查看原图 [图片] 查看原图 [图片] 查看原图

🔧 Windows平台deb包完全支持

v4.0.0版本的重大突破之一是在Windows平台下实现了对deb包的完全支持：

核心优势

• 无需Linux环境：直接在Windows下处理deb包，告别WSL和虚拟机
• 原生deb处理：完整的解压、修改、重新打包工具链
• GUI可视化操作：图形界面下的拖拽式deb包处理
• 一键式工作流：从下载到修改到打包的完整自动化流程

技术实现

• 实现了Windows平台下的原生deb包解析算法
• 集成了跨平台的tar.gz和ar归档处理能力
• 支持Debian控制文件的读取和修改
• 保持Linux兼容的文件权限和结构

使用场景

# 直接在Windows下修改iOS deb包
./fridare-gui.exe  # 拖拽deb文件进行可视化修改

# 或使用命令行
./fridare-patch.exe -i frida-server.deb -o modified.deb

这项功能让Windows用户无需额外环境即可完成完整的Frida服务器定制工作流程！

[v3.1.5] - 2024-07-29 Windows 支持

Added

• 新增 patch-frida.cmd 脚本,用于在 Windows 环境下修改 frida-server
• 新增 patch-frida-tools.cmd 脚本,用于在 Windows 环境下修改 frida-tools
• 增加对 Windows 平台的全面支持
• 更新了使用说明,增加了 Windows 平台的详细教程

[v3.1.4] - 2024-07-18

Added

• 增加 patch-tools 命令，用于修补 frida-tools 模块
• 新增 render_markdown 函数，用于在终端中渲染简单的 Markdown 格式
• 添加 generate_random_name 函数，用于生成随机的 Frida 魔改名
• 实现 move_file 函数，用于处理文件移动时的 "are identical" 错误

Improved

• 优化 list_frida_versions 函数，现在能够渲染 Markdown 格式的版本说明
• 改进 build_frida 函数，支持使用本地 deb 文件进行构建
• 增强 patch_frida_tools 和 restore_frida_tools 函数的功能和错误处理
• 优化 modify_frida_tools 函数，提高修改 frida-tools 的可靠性
• 改进 download_frida_module 函数，增加对特定操作系统和架构的支持

Fixed

• 修复了在某些情况下无法正确获取 Frida 路径的问题
• 解决了移动文件时可能遇到的 "are identical" 错误

Changed

• 更新 show_main_usage 和其他使用说明函数，以反映新增的功能
• 调整 parse_arguments 函数，支持新增的 patch-tools 命令
• 修改配置文件的处理方式，增加了对 FRIDA_NAME 的支持

Other Changes

• 代码结构优化，提高了整体可读性和可维护性
• 增加了更多的日志输出，提供更详细的执行信息
• 更新了版本号至 3.1.4

v3.1.