Skip to content

About

Native Android client of SniShaper: Kotlin + Jetpack Compose Material 3 UI, gomobile-bridged snishaper-core, VpnService TUN. CA functionality removed (no certificates, MITM or QUIC).

Topics

Resources

Code of conduct

Stars

2 stars

Watchers

0 watching

Forks

Repository files navigation

Snishaper-Droid

中文 | English

Android Kotlin Core License GitHub Release GitHub Downloads GitHub last commit GitHub Actions Workflow Status

Snishaper-Droid 是 SniShaper 的 Android 客户端:直接复用桌面版的 React 19 + MUI 前端(打进 APK 由 WebView 渲染,Kotlin 只做宿主与桥接),代理引擎来自 snishaper-core,通过 gomobile bind 编译为 AAR 在进程内运行,无需 root。通过 TLS 分片、加密 DNS / ECH(DoH 层)、NAT64 与 VpnService 全局代理,在复杂网络环境下提供稳定而灵活的网络访问体验。

证书说明:根证书由 certmanager 生成、导出,并可经 su + certutil 写入系统信任库(需要已 root 的设备);未 root 的设备只能导出 PEM,由用户手动安装为用户证书。规则模式 mitm / quic / migration 与规则级 cert_verify 依赖这张本地证书,仅在证书生效时可用。详见 CA / 证书支持。

本项目提供 Android 7.0+ 支持。详见 Platform.md。


CA / 证书支持

能力 Android 现状
根证书生成 / 重置 / 导出(PEM) 可用(certmanager 已编入 AAR,设置页“证书 & 安全”)
写入系统信任库 需要 root:su + certutil;无 root 时下载 PEM 后手动安装为用户证书
已装证书列举 / 卸载 可用(读取系统信任库,卸载同样需要 root)
规则模式 mitm / quic / migration 保留;仅在根证书对目标应用生效时才能真正解密
规则级 cert_verify、sni_fake、规则级 ECH 保留;同上,依赖 MITM 路径
内置规则中的 CA 依赖项 导入时清洗:缺证书环境下等价降级为 tls-rf

为什么安装证书需要 root? Android 7.0 起用户证书只对声明信任它的应用生效,系统信任库位于 /system/etc/security/cacerts,写入必须提权。应用不做静默安装:UI 会明确提示将弹出超级用户授权。


姊妹项目

SniShaper 是同一引擎的桌面端(Windows / Linux / macOS),FlowWeaver 是全功能客户端分支。三者并行维护:

Snishaper-Droid(本仓库) SniShaper FlowWeaver
定位 Android 原生客户端 桌面端 GUI / CLI 全功能客户端 / 网关
平台 Android 7.0+ Windows / Linux / macOS Windows / Linux / macOS
核心能力 TLS 分片、DoH/ECH、NAT64、VpnService TUN ECH 注入、TLS 分片、QUIC、会话迁移、TUN Clash 订阅、全协议节点、WireGuard、TUN 网关

三者的代理引擎均来自独立库 snishaper-core:代理服务、规则引擎、DoH 解析、TLS 分片与 TUN 数据面由该库提供,本仓库只保留 Android 应用层(WebView 宿主、VpnService 与配置数据)。


交流群组

欢迎加入 QQ 群 Snishaper and FlowWeaver building,与 SniShaper、Snishaper-Droid 与 FlowWeaver 的用户和开发者直接交流、反馈问题与提交建议。


特性

  • 混合端口代理:单端口同时提供 HTTP CONNECT 与 SOCKS5(默认 127.0.0.1:8080)。
  • TLS-RF 分片:记录数 / 分段数 / 间隔 / TLS 次版本修改 / OOB 首字节,支持全局与规则级参数。
  • Transparent / Direct:纯透传与直连,未命中规则时按默认策略处理。
  • 加密 DNS:DoH 多节点故障转移、ECH(DoH 层)、QUIC DoH 与前端 SNI。
  • Cloudflare IP 优选池:自动测速、健康检查与失效清理。
  • NAT64 支持:多套 NAT64 前缀配置与连通性测试,IPv6 优先 / NAT64 分流。
  • 上游与静态 IP:规则可绑定静态上游 IP 列表。
  • 进化模式:直连 / TCPing / TLS 分片等探测(域前置 / ECH / QUIC 测试仅展示,Android 不可应用其规则)。
  • VpnService TUN(Beta):Kotlin VpnService 建隧道 → Go sing-tun FileDescriptor + core singtun.Handler + gvisor 栈,无需 root。
  • 配置导入 / 导出:兼容桌面格式,导入时按 Android 能力清洗并汇报改写条数。
  • 实时连接:连接表展示主机、目标地址、命中规则、模式与上下行,2.5 秒刷新并支持搜索。
  • 规则匹配解释:输入域名走真实匹配管线,查看最终模式、命中规则、DNS 策略、上游与候选规则。
  • 多配置档案:命名快照(设置 + 规则)的创建 / 重命名 / 复制 / 切换 / 导入 / 导出,切换前自动停止代理。
  • 多 CDN 优选池:命名 IP 池管理,规则可按名称绑定;Cloudflare 池仍支持自动抓取与健康检查。
  • 诊断包:一键打包运行状态、脱敏设置与日志,经系统分享面板导出。
  • 启动迁移报告:Dashboard 展示配置加载时的迁移 / 清洗变更、告警与备份路径。
  • React + MUI UI:与桌面版同一前端 bundle(11 个页面,桌面端独有的托盘 / 自启 / 系统代理 / 更新通道 / 网卡选择等控件已全部移除);顶部 ☰ 控制侧边栏,可见性持久化;6 套配色 × 明暗 / light·dark·system;简体中文 / English / Русский。
  • 前台服务:代理运行期间常驻通知,满足 Android 后台限制。

快速开始

对于一般用户,我们建议直接在 Releases 下载最新的 Android 稳定版本 APK(arm64-v8a)并安装。

  • 最低系统:Android 7.0(API 24)。
  • MuMu 等 x86_64 模拟器:请使用源码构建 -PdebugAbi=x86_64 的调试包。
  • 首次启动会自动播种默认规则集;可在 Dashboard 启动/停止代理引擎。

源码构建、签名配置与 AAR 校验方式见以下文档:

  • Platform.md — 平台支持、功能矩阵与已知限制。
  • build.md — 构建指南(gomobile AAR、Gradle APK、MuMu 冒烟测试与 CI)。

文档


构建与开发

本项目 UI 直接复用桌面版 React 19 + MUI 前端(Kotlin WebView 宿主 + Wails 桥接),通过 gomobile/mobile(独立 Go module)将 snishaper-core 绑定为 AAR 在进程内运行。当前支持 Android 7.0+,构建目标为 API 24(minSdk)/ 36(compileSdk · targetSdk)。

发布包使用仓库内的 keystore/release.jks 签名(v2 + v3 + v4 方案),本地一条命令完成构建 + 校验:pwsh -File scripts/build-apk.ps1 -Bundle;CI 从 Secrets 导入同一把密钥,构建后用 apksigner verify 把关,并附带 SHA256SUMS.txt。R8 未开启(isMinifyEnabled = false),release 与 debug 的 Go 侧行为一致。

CI/CD 与桌面端发布节奏对齐:

  • .github/workflows/android.yml:push / PR → gomobile bind → AAR 契约校验 → lint test assembleDebug(单 ABI,缩短反馈时间)。
  • .github/workflows/release.yml:手动 workflow_dispatch(确认版本号 + 渠道)→ bot 提交版本号 → 导入签名密钥 → assembleRelease bundleRelease → apksigner verify → 发布 GitHub Release(签名 APK + AAB + AAR + SHA256SUMS.txt + changelog)。

完整的构建指南详见 build.md。


致谢

本项目受益于以下优秀开源项目的启发:

项目活跃度与贡献者

活跃度徽章

GitHub contributors GitHub commit activity GitHub last commit

贡献者图谱

Star History

Star History Chart

许可

GNU Affero General Public License v3.0(AGPL-3.0)

About

Native Android client of SniShaper: Kotlin + Jetpack Compose Material 3 UI, gomobile-bridged snishaper-core, VpnService TUN. CA functionality removed (no certificates, MITM or QUIC).

Topics

Resources

Code of conduct

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages