多协议支持
支持 VLESS、VMess、Trojan、Hysteria2、AnyTLS、TUIC、Naive、WireGuard、Shadowsocks、SOCKS4/5 与 HTTP(S)。
主要功能
以下功能以当前 Android 2.3.0 源码实现为准；桌面端功能请以独立仓库说明为准。
智能分流与规则
可在全局代理和智能分流间切换，并通过规则管理配置直连、代理与拦截策略。
订阅分组管理
按分组维护订阅来源，支持启动更新、定时更新、自动去重与独立启停，收藏节点不受分组删除影响。
自动测试择优
组合 TCPing、URL Test、上下行带宽和流媒体解锁结果，自定义筛选阈值、优先顺序并自动连接最优节点。
可复用择优模式
内置聊天与下载模式，也可保存自己的测试方案；支持按延迟、上传、下载或指定站点解锁情况排序。
网速测试
基于 Cloudflare 测速端点执行下载、上传或双向测试，可配置流量大小、超时和并发参数。
流媒体解锁测试
通过临时本地代理逐节点运行 UnlockTests，查看各地区常用流媒体与网站的可用情况。
分应用代理
按应用选择“仅代理选中”或“绕过选中”，支持搜索过滤，精细控制每个应用的 VPN 行为。
局域网代理共享
向同一局域网设备提供 HTTP 与 SOCKS5 代理，支持自动端口、连接地址展示和可选账号密码认证。
IPv6 与 TUN 配置
可调整 TUN 实现、IPv6 路由、MTU 与局域网绕过；连接中修改关键配置会自动重连应用。
节点导入与收藏
支持订阅、文本和二维码导入，节点可按分组浏览、搜索、收藏、分享并执行批量测试。
节点 IP 信息
查询节点出口 IP 的地区、ASN、风险评分以及住宅或原生属性，也可在 VPN 连接后自动查询。
连接异常恢复
后台监测实际 VPN 出口；连续确认异常后自动刷新节点并重连，降低网络切换后的失联概率。
实时状态与通知
主界面和通知栏展示上传、下载速度与累计流量，并提供断开和重置连接等快捷操作。
运行日志
内置可刷新、分享和清空的运行日志页面，方便在不连接开发工具时排查客户端问题。
安全订阅下发
采用匿名设备注册、Android Keystore 设备密钥与 Crypto V2 加密响应，并校验设备及请求上下文。
稳健应用更新
支持应用内检查、暂停、继续和重试下载；下载完成后交给系统安装，连续失败时可回退到官网下载。
主题与启动偏好
支持跟随系统、明亮和暗色主题，可记住上次节点，并选择启动后执行的默认测试方案。
Android 客户端最低支持 Android 7.0（API 24），当前目标版本为 Android 15（API 35）。服务地址与测试参数可在源码中配置。
界面截图
简洁直观，设置与选点一目了然。
下载
移动端请求中… PC端请求中…
⚡ 各平台高速下载均使用 Cloudflare CDN 加速直链；GitHub 下载指向官方 Releases 最新资产。
移动端更新
Android 客户端继续使用移动端仓库的版本发布与应用内更新流程。
桌面端发布
Windows 与 macOS 版本统一读取 FireflyVPN-Desktop 的最新 Release，并按平台匹配下载资产。
开源协议
项目保持开源；具体依赖与许可证请以对应仓库说明为准。
更新日志
同时展示移动端与桌面端的最新 GitHub Release，并明确标注所属平台。
移动端
请求中…
正在获取移动端更新日志…
PC端
请求中…
正在获取桌面端更新日志…
开发与自定义
当前 Android 工程使用 Kotlin、Jetpack Compose 与 sing-box，可按需替换品牌和服务配置。
快速开始
- 放置
libbox.aar到app/libs/。 - 修改
AppConfig.kt：API 地址、测试端点、官网与反馈信息。 - 使用 JDK 运行
./gradlew assembleDebug，生成 ARM64 与 armeabi-v7a APK。
Firefly Edge API v2
GET /api/v2/bootstrap：客户端启动配置、更新与公告信息。GET /api/v2/subscriptions：经过匿名设备鉴权的线路目录。POST /api/v2/usage/report：按连接会话上报上传、下载汇总字节数。- 安全订阅响应使用 Crypto V2，并绑定设备、请求 challenge 与订阅标识。
构建发布要点
- 使用 Release 签名（避免 Native 签名校验失败）。
- 最低支持 Android 7.0，目标版本为 Android 15。
- 当前按
arm64-v8a与armeabi-v7a分包构建。 - 支持 Android 15+ 的 16KB 页面大小对齐配置。
常见问题
Android 客户端支持哪些系统和设备？
最低支持 Android 7.0（API 24），提供 arm64-v8a 与 armeabi-v7a 架构版本。当前应用版本为 2.3.0，网页会优先显示
GitHub Releases 的最新版本。
设备识别依赖 Google Play 服务吗？
不依赖。当前 Android 端使用本地系统能力生成经过哈希处理的稳定设备标识，不需要接入 Play Integrity 或保持 Google Play 服务联网。测速、URL Test 和流媒体测试仍需访问各自的测试站点。
流媒体解锁测试使用什么组件？
使用 oneclickvirt/UnlockTests
编译的Android 二进制，通过本地SOCKS 代理逐节点测试。
为什么会显示“访问受限”？重装可以恢复吗？
匿名账号或设备被服务端停用时，客户端会停止加载受保护的线路目录并显示限制提示。设备标识具有跨重装稳定性，因此重装不会绕过设备限制；解除限制后，重新打开应用并联网刷新即可恢复。
为什么 延迟测试(TCPing/URL Test) 全部显示超时？
1. 确认 network_security_config.xml 中包含
2. 确保节点本身可用！另外 延迟测试 需要网络连接，确保 WiFi 或移动数据正常。
3. 检查 Logcat 中 SingBoxCoreLog 标签的日志，排查 sing-box 核心错误。
为什么开启自动化测试后，启动时没有先跑默认 延迟测试(TCPing/URL Test)？
这是预期行为。启用自动化测试后，启动会直接进入“自动化流程”（其中包含 URL Test 阶段），避免重复测试。
隐私与声明
使用本软件前，请仔细阅读以下内容。
⚠️ 节点来源声明
本项目为开源客户端工具。用户使用的节点均来源于互联网第三方或用户自行搭建，项目开发者对节点的可用性、安全性及合法性不承担任何责任。
⚖️ 法律合规
请严格遵守您所在国家或地区的法律法规。在部分国家和地区，使用 VPN 或代理工具可能受到限制或禁止。因使用本软件导致的任何法律后果，由用户自行承担。
🔒 本地数据
订阅分组、节点、规则、收藏与客户端偏好主要保存在设备本地。设备密钥由 Android Keystore 管理，匿名访问凭据加密保存在应用私有存储中。
📡 服务端交互
为完成匿名设备注册、订阅鉴权和访问控制，客户端会发送哈希设备标识、设备型号与设备公钥。每次 VPN 会话结束后会按会话上报上传和下载汇总字节数，不包含访问网址、DNS 查询或流量正文。
🛡️ 第三方服务与节点
测速、节点 IP 查询、URL Test、流媒体检测与软件更新会连接相应第三方服务。代理流量由所选节点转发，请优先使用自建或可信来源的节点，避免通过不可信节点传输敏感信息。
🚫 禁止滥用
严禁将本软件用于任何违法犯罪活动，包括但不限于：非法访问、数据窃取、网络攻击、传播违法信息等。开发者保留对滥用行为追究责任的权利。
📜 开源免责
本项目基于 GPLv3 协议开源，不提供任何明示或暗示的担保。开发者不对软件的适用性、可靠性或因使用本软件产生的任何直接或间接损失负责。
继续下载和使用本软件，即表示您已阅读并同意以上声明内容。