Frida UI

一个现代、轻量、基于网页的用户界面，用于 Frida，专为 Android 应用程序渗透测试 设计。它允许您直接从浏览器与设备、进程和脚本进行交互。

快速开始

# 使用 uv（推荐）或 pipx/pip 安装
uv tool install frida-ui
# 或者：pipx install frida-ui
# 或者：pip install frida-ui

# 启动服务器
frida-ui

打开您的浏览器并访问：http://localhost:8000

功能特性

📱 设备管理

• 自动发现：自动检测连接的 USB 和本地设备。
• 远程设备：轻松添加和管理远程 Frida 服务器（例如 192.168.1.x:27042）。
• 设备信息：查看选定的设备的详细系统参数（操作系统、架构、API 级别）和可视化类型指示器。

🚀 进程与应用控制

• 应用列表：查看已安装的应用和正在运行的进程。
• 搜索：按名称或标识符对应用进行实时过滤。
• 会话管理：
  • 附加：连接到正在运行的进程。
  • 启动：启动已安装的应用。
  • 启动并运行：启动应用并立即注入编辑器脚本以及任何排队的 CodeShare 脚本（早期插桩）。
  • 终止/分离：终止进程或优雅地断开连接。

💻 脚本编写与插桩

• 脚本编辑器：内置编辑器，用于编写 Frida 脚本。包含可选的 Monaco 编辑器（语法高亮和自动布局），并可优雅地回退到纯文本输入框。
• 文件加载：从本地文件加载脚本，或将 .js 文件拖放到编辑器中。
• 下载脚本：直接从编辑器头部将当前编辑器内容导出为 .js 文件（frida-ui_<应用ID>_<时间戳>.js）。
• CodeShare 集成：
  • 直接从 Frida CodeShare 导入脚本。
  • CodeShare 队列：排队多个 CodeShare 脚本，以便在 启动并运行 时自动加载并执行，或通过“运行 CodeShare 脚本”按钮手动执行。

📊 控制台与日志

• 实时输出：查看脚本中的 console.log、send() 和错误消息。
• 日志历史：每个应用会话的持久日志。
• 导出：将控制台日志下载为 .txt 文件以供分析。

🎨 用户界面/用户体验

• 深色主题：简洁、一致的深色模式界面。
• 持久化：跨会话记住您选择的设备、应用和窗格大小。
• 响应式：侧边栏、编辑器和控制台的可调窗格。
• 专注模式：切换 仅编辑器 或 仅控制台 视图，隐藏其他窗格以实现无干扰的工作流程。
• 无障碍：键盘快捷键（例如按 Escape 重置视图或关闭覆盖层）和 ARIA 支持。

开始使用

前提条件

• Python 3.7+
• uv（推荐） / pipx / pip。

安装

选项 1：从 PyPI 安装（推荐）

uv tool install frida-ui

您还可以自定义 Frida 版本：

uv tool install frida-ui --with frida==16.7.19

选项 2：从源码安装（最新版）

uv tool install git+https://github.com/adityatelange/frida-ui

您可以自定义 Frida 版本：

uv tool install git+https://github.com/adityatelange/frida-ui --with frida==16.7.19

[!重要提示] 您安装的 Frida 版本必须与 Android 设备上的 frida-server 版本匹配，以确保兼容性。

运行

使用默认配置启动服务器：

frida-ui

或使用自定义选项：

frida-ui --host 127.0.0.1 --port 8000 --reload

• --host：指定主机（默认值：127.0.0.1）
• --port：指定端口（默认值：8000）
• --reload：为开发启用自动重载

在浏览器中打开 **http://localhost:8000**。

Android 设备设置

在使用 frida-ui 之前，您必须在 Android 设备上运行 frida-server。frida-server 的版本必须与上一步中安装的 Frida 版本匹配。

选项 1：USB 连接

如果您已安装 ADB 并希望通过 USB 连接：

1. 下载 frida-server： 访问 Frida releases，下载与您设备架构/ABI 匹配的 Android 版 frida-server 二进制文件（例如 frida-server-x.x.x-android-arm64.xz）。

2. 解压并推送到设备：

   root@kitploit:~

   unxz frida-server-x.x.x-android-arm64.xz
   mv frida-server-x.x.x-android-arm64 frida-server
   adb push frida-server /data/local/tmp/
   

3. 运行 frida-server：

   root@kitploit:~

   adb shell "chmod 755 /data/local/tmp/frida-server"
   adb shell "/data/local/tmp/frida-server -D"
   

4. 验证连接： 确保您的设备通过 USB 连接，并通过 adb devices 可见。frida-ui 在运行时将自动检测到它。

选项 2：远程连接（网络）

或者，您可以使用网络监听器运行 frida-server 并远程连接：

1. 在 Android 设备上下载并运行 frida-server（使用任何方法 - ADB、自定义脚本等）：

   root@kitploit:~

   ./frida-server -l 0.0.0.0:27042 -D
   

2. 在 frida-ui 中添加远程设备： 在 frida-ui 界面中，添加一个远程设备，其 IP 地址和端口为 frida-server 监听的地址（例如 192.168.1.x:27042）。

   此方法不需要安装 ADB。

使用指南

1. 选择设备：从顶部标题的下拉菜单中选择一个设备。
2. 选择应用：点击侧边栏中的应用。
3. 编写/加载脚本：
   • 在编辑器中输入 JS 代码。
   • 或者拖放一个文件。
   • 或者从 CodeShare 添加脚本 URL。
4. 操作：
   • 点击 附加 注入到正在运行的进程。
   • 点击 启动 启动应用。
   • 点击 启动并运行 启动应用并立即注入您的脚本。
5. 监控：在控制台中查看输出。

💡 示例脚本

尝试这个简单的脚本以挂钩一个方法（替换为目标方法）：

// 简单的方法挂钩示例
Java.perform(() => {
  const MainActivity = Java.use("com.example.app.MainActivity");
  MainActivity.checkPassword.implementation = function (password) {
    console.log("[*] checkPassword called with: " + password);
    return true; // 绕过检查
  };
});

注意事项

[!注意] 此工具是一个独立项目，不属于官方的 Frida 工具集，也未得到 Frida 项目的赞助。它是一个第三方用户界面，用于与 Frida 的核心功能进行交互。

[!警告] 此工具允许在目标进程中执行任意 JavaScript。请仅在受信任的网络和用户中暴露 frida-ui。执行不受信任的脚本可能会危及您的系统和数据。Web 服务器默认在本地运行，但公开了强大的插桩能力。

致谢

• Frida 项目 - https://frida.re/。
• Monaco 编辑器 - https://microsoft.github.io/monaco-editor/。
• 感谢 Github Copilot 提供的代码建议和改进。

随时间增长的 Star 数量