snishaper-core 是 SniShaper 与 FlowWeaver 共用的核心代理库,通过 混合端口代理、规则引擎与 MITM、ECH 注入、TLS 分片、DoH 解析 与 TUN 数据面 等能力,为复杂网络环境提供可嵌入、可测试的 Go 数据面。
本库零全局可变状态:默认零日志、不读环境变量、不调用 os.Exit,全部行为通过 functional options 注入。
本库被以下两个应用嵌入,三者并行维护:
| SniShaper | FlowWeaver | snishaper-core(本仓库) | |
|---|---|---|---|
| 定位 | 轻量级代理服务端(GUI + CLI) | 功能全面的客户端 / 网关 | 可嵌入的 Go 核心库 |
| 核心能力 | 界面、系统代理、托盘、进化模式 | Clash 订阅、全协议节点、WireGuard、TUN 网关 | ProxyServer、RuleManager、DoH、证书、TUN 数据面 |
| 面向对象 | 最终用户 | 最终用户 | Go 开发者 |
两个应用都直接依赖本库,产品名经 config.Brand 注入(SniShaper 使用默认值 SniShaper,FlowWeaver 注入 FlowWeaver);规则文件格式与配置语义在三者间保持一致。
- 混合端口代理:单端口同时提供 HTTP CONNECT 与 SOCKS5。
- 规则引擎与 MITM:站点分组、多模式(MITM / Transparent / TLS-RF / QUIC / Migration / Direct)、按需证书签发。
- 订阅与节点协议:Clash 订阅解析,节点协议出站(vmess / vless / trojan / shadowsocks / hysteria / tuic / wireguard 等),规则可绑定订阅节点组。
- ECH 注入:DoH 发现、热更新与恢复。
- TLS 分片:ClientHello 分片与 OOB 发送。
- 智能分流:GFWList 后缀匹配与自动路由。
- 加密 DNS:多节点 DoH 故障切换解析。
- Cloudflare 优选 IP 池:健康检查、测速与 NAT64。
- TUN 数据面:基于 sing-tun 的透明劫持(Handler / Manager 分离)。
- 零全局状态:无
init()、无包级可变状态,可多实例、可并发嵌入。
rm := proxy.NewRuleManager(
filepath.Join(dir, "config", "settings.json"),
filepath.Join(dir, "rules", "config.json"),
)
if err := rm.LoadConfig(); err != nil { /* ... */ }
p := proxy.NewProxyServer("127.0.0.1:8080",
proxy.WithRuleManager(rm),
proxy.WithLogger(corelog.Std), // 库默认静默,注入才有日志
)
p.Start()可运行版本见本仓库示例 examples/basic:
go run ./examples/basic 8080| 包 | 说明 |
|---|---|
proxy |
ProxyServer(混合端口)、RuleManager(规则引擎)、AutoRouter、MITM、上游拨号 |
subscription |
Clash 订阅下载解析、节点存储与协议出站(mihomo 适配器) |
dohresolver |
DoH 多节点故障切换与 ECH 配置热修复 |
cfpool |
Cloudflare 优选 IP 池 |
netiface |
物理网卡选择与出站绑定(Selector) |
tlsfrag |
TLS ClientHello 分片与 OOB 发送 |
gfwlist |
GFWList 域名后缀匹配 |
certmanager |
CA 生成、MITM 证书签发、系统信任安装 |
singtun |
基于 sing-tun 的 TUN 数据面 |
sysproxy |
系统代理开关(Windows 注册表 / macOS networksetup / Linux gsettings),实例化 Manager |
evolution |
规则演化:多模式探测域名可达性、生成临时站点分组规则 |
config |
跨包共享配置类型(CertVerifyConfig 等) |
log |
Logger 接口与 Nop / Std / Func 适配器 |
- docs/DESIGN.md — 库设计、包边界与去全局化约定。
- examples/basic — 最小嵌入示例。
- SniShaper Wiki — 核心模式、规则自定义等应用层文档。
- FlowWeaver Wiki — 订阅导入、节点协议与客户端侧文档。
本库使用 Go 开发,最低版本 1.27。提交前门槛:
go build ./...
go vet ./...
go test ./...proxy/proxy_integration_test.go 提供仅使用导出 API 的端到端冒烟测试。
贡献指南见 CONTRIBUTING.md。
GNU Affero General Public License v3.0(AGPL-3.0)。本库衍生自 SniShaper,衍生与分发须遵循同一许可证。