Repository navigation
Usage Guide
dongle edited this page Nov 16, 2026
·
3 revisions
本文是 SniShaper 的完整使用方法总览。按顺序走完前四步即可正常使用;其余章节按需查阅。
- 从 Releases 下载最新的 Windows 稳定版本(也支持 Linux GUI 与跨平台 CLI,详见 Platform.md)。
- 解压并运行
SniShaper.exe。 - 建议以管理员身份运行:系统代理写入与 TUN 模式需要管理员权限;开机自启(默认任务计划程序方式)也需要管理员权限,且配置后登录时不会再弹 UAC 提示。
- 如需从源码自行构建,参见 build.md(12 个构建目标矩阵)。
MITM、QUIC 等模式需要本地代理终止 TLS 并重新签发证书,因此必须先信任 SniShaper 的根证书:
- GUI:进入 设置 → 证书管理 → 重新安装证书,详见 证书重新安装。
- CLI:
snishaper ca install(需要管理员 / root)。
Note
仅使用 Transparent / TLS-RF 等不需要解密流量的模式时,可以跳过此步。
- 在主界面点击 启动代理。SniShaper 在同一个混合端口上同时提供 HTTP 与 SOCKS5 代理(默认端口可在设置中修改,CLI 可用
port get|set查看 / 修改)。 - 内置了一套覆盖大量站点的官方规则(约 3800 行的站点组规则),一般无需手动配置即可使用。
二选一(或都不选,手动给应用填代理地址):
| 方式 | 说明 | 适合 |
|---|---|---|
| 系统代理 | 写入 Windows 系统代理设置,浏览器等立即走代理 | 只需浏览器走代理 |
| TUN 虚拟网卡 | 全局透明劫持所有流量,自动路由 + DNS 劫持 | 需要接管不走系统代理的程序 / 全局生效 |
注意:开启 TUN 会先自动关闭程序设置的系统代理,关闭 TUN 时会恢复。
SniShaper 为每个站点组提供 5 种模式,完整原理见 核心模式详解:
| 模式 | 一句话说明 |
|---|---|
| Transparent | 仅修 DNS / 目标 IP,应对纯 DNS 污染 |
| MITM | 本地终止 TLS,以自定义 SNI / ECH 重新握手,可做域前置 |
| QUIC | 出站转 HTTP/3 直连重放,利用 ClientHello scrambling |
| TLS-RF | TLS 握手分片 + 精准点位切割 + 时延干扰 |
| Migration | TLS 1.2 会话恢复,连接被重置时无需重新握手 |
基于 GFWList 的后缀匹配自动识别被屏蔽域名,对规则未覆盖的网站自动生效;也可配合自动路由功能按实测结果选路。详见 智能分流详解 与 规则自定义指南。
-
加密 DNS(DoH):内置抗污染解析器,多节点故障转移;在 DNS 页面或
dns命令配置。 -
ECH 注入:自动获取并注入 ECH Config,支持 DoH 发现与热更新(
ech fetch <域名>手动刷新)。 -
Cloudflare IP 优选池:自动测速、健康检查与刷新(
cf status|refresh|health)。 -
NAT64:IPv6 出口灵活切换,绕过纯 IPv4 屏蔽(
nat64 list|test)。 -
进化模式:自动测试多种规则组合,寻找目标站点最优访问方式并一键应用(
evolution start)。 -
会话迁移(Migration):
migration status|on|off|server|test。
-
GUI:设置中开启开机自启,并可在「自启方式」中选择注册机制(同一时刻只保留一种,切换时自动清理旧机制):
-
任务计划程序(默认):
LogonTrigger+HighestAvailable,登录时启动且无 UAC 弹窗; -
Windows 服务:安装
SniShaperAutostart服务(session 0 宿主进程,以提权 token 在用户会话拉起界面,同样无 UAC 弹窗); -
注册表:HKCU
Run键,登录时以普通权限启动后自动提权(弹一次 UAC)。
-
任务计划程序(默认):
-
CLI:
snishaper autostart on --with-proxy开启 CLI 服务的独立自启条目(与桌面端互不影响),autostart off关闭。
无参数运行 snishaper 直接进入交互面板(TUI);单条命令如 snishaper status、snishaper tun on。完整命令目录见 CLI 命令参考。
证书告警、规则不生效、端口被占用等问题见 常见问题与排障。快速自检可运行 snishaper selfcheck(端到端检查服务、监听端口、经代理请求、系统代理与 TUN)。
- Home
- 完整使用指南
- CLI 命令参考
- 核心模式详解
- 智能分流详解
- 规则自定义指南
- 界面配置指南
- 证书重新安装
- macOS 菜单栏应用
- Linux 软件包
- 代码结构
- Snishaper-Core 核心库
- CI 与 PR 自动化
- 便携式自动更新器
- 常见问题与排障
- Home
- Usage Guide
- CLI Reference
- Core Proxy Modes
- Auto Routing
- Custom Rules Guide
- GUI Configuration
- Certificate Installation
- macOS Menu Bar App
- Linux Packages
- Code Structure
- Snishaper-Core Library
- CI & PR Automation
- Portable Auto-Updater
- FAQ