ruyiBrowser GUI 是 ruyiPage 指纹浏览器的桌面端管理工具，基于 Electron + Vue3 构建。无需手动配置参数，通过图形界面即可创建、管理、启动多个独立的 Firefox 指纹环境，适用于多账号运营、反检测测试等场景。
底层浏览器由 firefox-fingerprintBrowser 提供，具备指纹隔离、代理绑定、WebRTC 防泄漏等能力。
环境管理 — 一键启动 Firefox 指纹浏览器
代理信息 — 支持 HTTP / SOCKS5，WebRTC 自动绑定代理 IP
指纹配置 — 地区语言、硬件指纹、右侧实时概要
WebGL 设置 + fpfile 预览 — 保存前实时查看最终指纹文件
- 多环境管理 — 创建、编辑、删除多个浏览器环境，每个环境独立 Profile
- 指纹配置 — 时区、语言、User-Agent、Canvas 噪声、WebGL、屏幕分辨率、CPU 核心数
- 代理绑定 — 支持 HTTP / SOCKS5 代理，一键测试连通性
- WebRTC 防泄漏 — 支持禁用 / 替换 / 使用代理 IP 等多种策略
- 根据 IP 自动填充 — 自动查询代理 IP，填充时区、语言、地理位置
- 语音指纹 — 自动根据语言生成对应 speech.* 配置
- fpfile 预览 — 保存前实时预览最终生成的指纹文件内容，支持分类过滤
- 一键启动 — 直接调用 foxprint.exe 启动对应环境，无需命令行
- Windows 10/11 x64
- foxprint 已安装（用于启动指纹浏览器）
从 Releases 下载最新安装包：
ruyiPage GUI Setup x.x.x.exe
双击安装，完成后从桌面快捷方式启动。
- 界面支持
HTTP和SOCKS5两种代理类型。 HTTP类型会直接写入 Firefoxnetwork.proxy.http/ssl配置并生效。SOCKS5类型在部分指纹内核中可能存在原生代理兼容问题，项目已内置本地桥接方案。
当环境选择 SOCKS5 并启动时，程序会自动执行：
- 在本机
127.0.0.1启动一个临时 HTTP 代理端口（随机端口） - 浏览器仅连接该本地 HTTP 端口
- 本地桥接进程再将请求转发到你配置的上游 SOCKS5（含账号密码）
这样可以保持上游仍是 SOCKS5，同时避开部分内核对 SOCKS5 直连的兼容限制。
- 本地端口仅绑定
127.0.0.1，不会对外网开放。 - 代理用户名密码仍使用环境中的 SOCKS5 配置。
- 删除环境或关闭应用后，相关桥接端口会自动清理。
npm installnpm run devnpm run build输出在 dist/ 目录。
src/
main/
main.js # Electron 主进程 + 所有 IPC handlers
python-bridge.js # HTTP 调用 Python 服务
http/
ipQuery.js # IP 地理信息查询
speechVoiceMap.js # 语音语言映射表
preload/
preload.js # contextBridge，安全暴露 API 给渲染进程
renderer/
views/
environment/ # 环境管理页（列表、新建、编辑）
settings/ # 设置页
components/ # 公共组件
style.css # 全局样式
python/
server.py # ruyiPage HTTP 桥接服务
assets/
icon.ico / icon.png # 应用图标
如果你准备把 ruyiBrowser GUI 用在 AI 自动化分析、复杂网页采集或高风控页面场景，建议先看这些配套项目：
-
📄 官方文档 / 自动化文档 更系统地查看
ruyiPage相关自动化说明、接入方式和配套能力说明：
https://0xshoulderlab.site/automation -
🤖 AI 自动化分析运行 Skill 面向 AI 协作和自动化分析场景的运行说明与实践入口，适合先了解如何把
ruyiPage接进你的工作流：
https://github.com/LoseNine/ruyipage-skill?tab=readme-ov-file -
🦊 Firefox 指纹浏览器项目 用于需要 Firefox 指纹环境、浏览器接管或更高真实度自动化场景，适合和
ruyiPage搭配使用：
https://github.com/LoseNine/firefox-fingerprintBrowser -
🟨 JavaScript 实现：ruyipage-js 面向 JavaScript / Node.js 生态的配套实现，适合希望在 JS 项目里接入
ruyiPage思路与能力的场景：
https://github.com/GanFish404/ruyipage-js -
🐹 Go 语言实现：ruyipage-go 由社区实现的 Go 版本，适合需要在 Go 项目中接入 Firefox 自动化能力的场景。感谢 @pll177 的实现与维护：
https://github.com/pll177/ruyipage-go
如有问题请提交 Issue