返回 README
本项目提供跨平台支持:Windows 与 Linux 共用同一套代码与版本机制,平台相关逻辑通过 Go build tags 隔离。
下载 最新版本 中的 snishaper-windows-amd64.zip(便携版,Windows 自带解压)或 MSIX 安装包,解压 / 安装后运行 snishaper.exe。程序会自动请求管理员权限(TUN 模式需要),如拒绝则 TUN 功能不可用但其他功能正常。
从 最新版本 下载 snishaper-linux-amd64.tar.gz,解压后运行:
tar -xzf snishaper-linux-amd64.tar.gz
sudo ./SniShaper程序会自动申请 root 权限(TUN 模式需要),如提权失败则 TUN 功能不可用但代理等其他功能正常。当前提供 amd64 构建,基于 GTK4 + WebKitGTK 6.0(亦支持 GTK3)。
不需要图形界面、或在服务器 / SSH 环境中使用?本仓库内置 SniShaper CLI(cli/ 目录):
- 三平台支持:Windows / Linux / macOS(amd64 + arm64)。
- TUI 界面:上屏实时滚动代理日志,下屏输入命令(支持中文别名),日志刷新再快也不会淹没输入。
- 后台模式:
snishaper start常驻运行,status/stop/logs/proxy/sysproxy/tun/config/ca子命令远程管理。 - 完整核心:与 GUI 版共享同一套代理引擎(ECH 注入、TLS 分片、QUIC、TUN/gvisor、GFWList 分流、DoH、CF IP 池、NAT64、进化模式)。
- 移除更新检测:无自动更新,适合长期运行的服务器场景。
- 版本一致:与 GUI 版共用
Package.appxmanifest作为唯一版本源。
构建方式详见 build.md — 构建产物矩阵,产物按 build/bin/cli/<Platform>/<Arch>/ 组织,直接运行即可进入 TUI。
Darwin / macOS CLI 注意: 当前 Darwin CLI 由于缺少可用于持续实机测试的 macOS 测试设备,实际使用中可能存在我们尚未预见的问题。若你在 Darwin / macOS 上发现任何异常,请及时提交 Issue 或 Pull Request,帮助我们尽快定位和修复问题。
在主界面点击「证书管理」-> 「重置根证书」。CLI 版使用 snishaper ca regenerate 后重新 ca install。
软件内置了丰富的官方规则,你也可以在「规则面板」中根据实际情况自定义规则,最后点击「启动代理」即可。
需要移动端客户端?SniShaper 有两个基于相同路由理念的配套版本:
- Lumine for Android:Kotlin + Jetpack Compose(Material Design 3)原生界面,Go(enimul)核心经 gomobile 绑定为单个 AAR,无 WebView 内嵌;支持订阅管理、规则编辑、实时日志与后台保活,也可通过 F-Droid(
com.moi.lumine)获取。 - Lumine for HarmonyOS:ArkTS + ArkUI 原生界面(深浅色),便携 C++17 核心经 NAPI 接入为单个
liblumine_napi.so,无 WebView 内嵌;支持 VpnExtensionAbility(TUN)隧道、本地代理监听(SOCKS5 / HTTP 回环入站)、订阅管理、规则编辑、实时日志与运行状态通知。