EN Home

中文 | English

Welcome to the FlowWeaver Wiki

FlowWeaver is a full-featured local proxy client and gateway built around Clash subscriptions, multi-protocol nodes, a TUN virtual NIC and WireGuard tunnels.

Relation to SniShaper

FlowWeaver originates from SniShaper and is led by the same maintainer; both are maintained in parallel:

	SniShaper	FlowWeaver
Focus	Lightweight proxy server	Full-featured client / gateway
Core strengths	ECH injection, TLS fragmentation, session migration	Clash subscriptions, multi-protocol nodes, WireGuard, TUN gateway

The codebases evolve independently. Subscription and rule file formats are compatible and interchangeable.

Features

• Clash subscription import: paste an airport subscription link; nodes, proxy groups and routing rules are parsed automatically.
• Multi-protocol nodes: ss (AEAD-2022), vmess, vless, trojan, tuic, hysteria2, wireguard, socks5, http.
• UDP forwarding: every protocol except http supports UDP, including QUIC / HTTP3.
• TUN virtual NIC: transparent global traffic capture with auto-routing and DNS hijacking.
• Multiple proxy modes: MITM, Transparent, TLS-RF, QUIC, Migration.

Quick Start

flowweaver sub add https://example.com/subscribe MyProvider   # import a subscription
flowweaver sub use MyProvider                                  # activate it
flowweaver sub select Proxy "HK-01"                            # pick a node
flowweaver proxy on                                            # start the proxy

GUI users: download the build for your platform from Releases. Full walkthrough in the Usage Guide.

Documentation Map

• Usage Guide: complete usage from subscription import to proxy and TUN.
• Core Proxy Modes: the 5 modes — Transparent, MITM, QUIC, TLS-RF, Migration.
• Auto Routing: how GFWList-based auto routing works.
• Custom Rules Guide: optimizing rules for specific sites.
• GUI Configuration: key configuration points of every GUI page.
• Certificate Installation: installing the root CA for MITM / QUIC.
• CLI Reference: every command of the cross-platform CLI and TUI (including the subscription group).
• Code Structure: repository layout and data flow for contributors.
• FAQ: certificate warnings, rules not applying, subscription updates and more.