Usage Guide

中文 | English

完整使用指南 (Usage Guide)

本文是 FlowWeaver 的完整使用方法总览。按顺序走完前四步即可正常使用。

1. 安装与首次运行

1. 从 Releases 下载对应平台的稳定版本（GUI 与 CLI 均提供，共 12 个构建目标；各平台说明见 Platform.md）。
2. GUI 运行 FlowWeaver.exe；CLI 直接运行 flowweaver 进入 TUI 交互面板。
3. 建议以管理员身份运行：系统代理写入与 TUN 模式需要管理员权限；开机自启（任务计划程序方式）同样需要，配置后登录时无 UAC 弹窗。

2. 导入 Clash 订阅

FlowWeaver 的核心用法是导入机场的 Clash 订阅：

• GUI：进入 订阅 页面，粘贴订阅链接并导入。订阅启用后自动加载其节点、代理组与分流规则，内置规则随之隐藏。
• CLI：

flowweaver sub add https://example.com/subscribe MyProvider  # 导入（名称缺省从地址推断）
flowweaver sub use MyProvider                                # 启用订阅并加载其规则
flowweaver sub update                                        # 更新当前订阅

不使用订阅时，FlowWeaver 也可以直接作为规则代理使用（内置规则不提供节点选择）。

3. 选择节点

• GUI：代理 页面提供对齐 Clash Verge 体验的节点列表，按代理组切换节点。
• CLI：

flowweaver sub nodes          # 列出代理组与节点
flowweaver sub current        # 查看当前订阅与各组选中的节点
flowweaver sub select Proxy "HK-01"   # 为某个代理组选择节点
flowweaver sub test           # 逐个测试节点连通性

支持的协议：ss（AEAD-2022）、vmess、vless（TCP / WebSocket）、trojan、tuic、hysteria2、wireguard、socks5、http。除 http 外全部协议支持 UDP 转发（含 QUIC / HTTP3）。WireGuard 隧道以用户态 IP 栈接入，不创建内核网卡、不修改系统路由表。

4. 启动代理并选择流量接管方式

启动代理后，FlowWeaver 在同一混合端口提供 HTTP 与 SOCKS5（端口可在设置中修改）：

方式	说明
系统代理	写入系统代理设置，浏览器等立即走代理
TUN 虚拟网卡	全局透明劫持所有流量，自动路由 + DNS 劫持；TUN 的 UDP 流量也会经当前订阅节点转发

5. 代理模式

每个站点组可选以下模式（无订阅时可配合内置规则使用），完整原理见 核心模式详解：

模式	一句话说明
Transparent	仅修 DNS / 目标 IP，应对纯 DNS 污染
MITM	本地终止 TLS，以自定义 SNI / ECH 重新握手（需安装根证书）
QUIC	出站转 HTTP/3 直连重放
TLS-RF	TLS 握手分片 + 精准切割 + 时延干扰
Migration	会话迁移（migration status|on|off|server|test）
Direct	直连

6. 证书（MITM / QUIC 必备）

• GUI：设置 → 证书管理 → 重新安装证书，详见 证书重装指南。
• CLI：flowweaver ca install（需要管理员 / root）。

7. 进阶功能

• 智能分流：基于 GFWList 自动识别受限域名，详见 智能分流详解；规则优化思路见 规则自定义指南。
• 加密 DNS（DoH）：抗污染解析器，多节点故障转移（dns list|test）。
• ECH 注入：自动获取并注入 ECH Config（ech fetch <域名>）。
• Cloudflare IP 优选池：自动测速、健康检查与刷新（cf status|refresh|health）。
• NAT64：IP 受限环境下的 IPv6 出口（nat64 list|test）。
• 进化模式：自动测试规则组合寻找最优访问方式（evolution start）。

8. 开机自启

• GUI：设置中开启。使用 Windows 任务计划程序，登录时自动启动且无 UAC 弹窗。
• CLI：flowweaver autostart on --with-proxy（独立条目，不影响桌面端）。

9. 命令行（CLI）

无参数运行 flowweaver 进入 TUI；单条命令如 flowweaver status、flowweaver tun on。完整命令目录（含订阅命令组）见 CLI 命令参考。快速自检可运行 flowweaver selfcheck。