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。
| 能力 | 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建隧道 → Gosing-tunFileDescriptor+ coresingtun.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)。
- Platform.md — Android 平台支持与功能边界。
- build.md — 构建、签名、测试与 AAR 校验指南。
- CHANGELOG.md — 版本变更记录。
- SniShaper Wiki — 核心引擎的通用文档(代理模式、规则格式等,桌面端与 Android 共用同一引擎):
本项目 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。
本项目受益于以下优秀开源项目的启发:
- DoH-ECH-Demo
- lumine
- snishaper-core
- golang.org/x/mobile(gomobile)
- React / MUI(桌面版前端,Android 直接复用)
GNU Affero General Public License v3.0(AGPL-3.0)