Repository navigation
GUI Configuration
dongle edited this page Oct 31, 2026
·
7 revisions
FlowWeaver 的绝大部分功能都可以直接在 GUI 界面中完成，无需手动修改配置文件。界面共 13 个页面：主页、订阅、代理、规则、路由、DNS、进化、日志、连接、配置文件、设置、关于、欢迎。
- 启动代理：点击后启动本地 HTTP + SOCKS5 混合端口代理。
- 系统代理：开启后自动写入系统代理设置。
- 订阅页：粘贴 Clash 订阅链接导入；订阅启用后自动加载其节点、代理组与分流规则，内置规则随之隐藏。
- 代理页：对齐 Clash Verge 的节点列表布局与切换体验，按代理组选择节点；支持 ss（AEAD-2022）、vmess、vless、trojan、tuic、hysteria2、wireguard、socks5、http，除 http 外全部支持 UDP。
在「规则设置」中添加域名时：
-
默认通配：你可以只输入一个域名（如
pixiv.net），系统会默认进行后缀匹配（即自动涵盖www.pixiv.net等相关站点）。 -
智能优先级系统：FlowWeaver 内置了匹配权重，优先级顺序如下：
-
精确匹配 (Highest): 如
google.com。 -
正则匹配: 以
~开头（如~.*google.*）。 - 后缀/通配符匹配: 域名越长，权重越高。 系统会自动选择最精确的那条规则，你无需担心规则冲突。
-
精确匹配 (Highest): 如
-
上游地址：每条规则可填写上游 IP（填
DIRECT表示直连出站）。
在规则编辑弹窗中，点击「生成 Fake SNI」按钮：
-
功能：自动将
a.b.c转换为a-b-c.mapped。 - 原理：通过变换 SNI 字符串，绕过 GFW 对黑名单 SNI 的封锁。
-
ECH 映射：自动获取并存储目标域名的
echconfig（public name、HPKE 配置）。 - 引导 ECH：启用后对未知域名使用内置 DoH 查询 ECH 记录。
在「设置」中启用「自动更新优选 IP」：
- 动态监控：FlowWeaver 会定期从内置的 IP 源拉取当前延迟最低、丢包率最少的边缘节点。
- 自适应切换：当某个 IP 连接状态不佳，工具会自动切换到其余 IP，确保连接的持久稳定性。
为规则指定特定的 DNS 解析模式：
-
prefer_ipv4/prefer_ipv6: 默认解析策略。 -
ipv4_only/ipv6_only: 在纯 IPv6 或某些双栈环境下有特定优化效果。
- 首次启动并选择语言后，会自动进入「新手引导」：以聚光灯高亮真实界面元素，带你实际点击「开启代理」「系统代理」按钮，并依次认识订阅导入、节点选择与 TUN 设置。
- 完成（或跳过）后，标记会写入注册表
HKCU\Software\FlowWeaver（tutorial_done），更新程序后不会再次弹出。 - 想重新学习：设置 → 通用 → 新手引导 → 重新学习；高级功能请继续阅读本 Wiki。
规则分两个文件，规则更新（「检查更新」）只整体替换上游备份，绝不会丢失你的本地修改：
-
rules/config.json：有效状态（可直接手编的工作文件），界面改动与手编内容都保存在这里。 -
rules/config.upstream.json：上游备份（运行时自动生成），由规则更新整体替换。 - 两者的差量即你的本地修改，更新时自动叠加到新上游之上；与上游冲突时以本地修改为准。
在规则页中：
- 「已修改」徽标：该规则来自上游，但你本地改过参数。
- 「自定义」徽标：该规则是你手动新建的。
- 恢复默认：带「已修改」徽标的规则可点击历史图标，确认后丢弃本地修改、恢复为上游默认值。
侧边栏「连接」页实时展示当前经过核心的活动连接：
- 连接详情：主机（域名或 IP）、目标地址（拨号后的 ip:port）、命中的规则、生效的代理模式、上下行流量计数、连接时长与状态。
- 搜索过滤：顶部搜索框按主机 / 规则 / 模式实时过滤；每行可一键复制 JSON 详情用于排障。
- 诚实呈现：未知或暂不可用的字段显示为「—」，不会把缺失数据当成已确认信息。
- 有界内存：核心侧连接注册表上限 4096 条，超出时淘汰最旧的已完成连接，不会随时间无限增长。
规则页顶部「测试域名」按钮：输入域名（可选进程名）即可模拟该域名会被如何处理。
- 与真实引擎一致：模拟走的是与真实连接完全相同的匹配管线（含进程规则、自动分流回退、MITM 降级），不会出现两套逻辑各说各话。
- 结果内容：命中的规则、生效模式、来源（manual/auto/default）、上游、DNS 模式、Fake SNI、ECH，以及按优先级排序的候选规则和分数（精确 > 正则 > 关键字 > 后缀，同类中更长模式胜出）。
- 明确标注为模拟：结果带「模拟结果」徽标——这是预测，不是真实连接的决策记录。
程序启动时自动检测上次异常退出遗留的系统代理设置：
- 安全恢复：仅当当前系统代理仍与本程序启用时记录的标记一致时才自动关闭——即只恢复可确认为本程序创建的更改。
- 绝不覆盖用户设置：若系统代理已被用户或其他程序修改，保持原样不动，仅在界面提示检测结果。
- 结果可见：检测与恢复操作通过界面提示及日志展示；恢复失败（如缺少管理员权限）会显示可操作的错误信息。
- 无遗留（上次正常退出或从未开启系统代理）时不做任何动作。
侧边栏「配置文件」独立页面为不同网络或场景保存命名配置快照（卡片网格布局，当前生效的配置文件高亮并带对勾标记）：
- 完整操作：从当前配置创建、重命名、复制、切换、导入、导出；每个配置文件独立保存规则（含站点组 DNS 模式）、上游与端口等设置。
- 切换安全：切换会先停止代理并断开活动连接，再把当前配置回写到离开的配置文件（未保存的修改不丢失），然后用目标配置替换实时配置。切换后需手动重新启动代理（界面会明示）。
- 导入校验：导入的文件用与实时匹配相同的加载管线校验，无效或版本不符的配置会被拒绝并展示原因。
-
互不影响：不使用配置文件的安装完全不受影响；配置文件保存在用户配置目录的
profiles/子目录下，每个配置文件一个子目录。
程序启动加载配置时，若发生版本迁移、字段修复、备份或校验问题，仪表盘顶部会显示一条可关闭的迁移报告：
- 内容分级：已应用的修改（信息）、警告（黄色）、错误（红色——配置无法安全迁移，已保持原样）。
- 升级保护：配置版本高于本构建支持时拒绝加载并提示先升级程序，绝不静默降级。
- 自动备份：迁移改写前自动备份原配置文件，备份路径随报告展示。
- 无迁移发生时不显示任何内容。规则文件导入（配置文件功能）使用同一套校验管线。
Note
界面操作后请确认点击「保存配置」，不需要重启软件即刻生效。所有界面改动都会自动写入配置文件（规则改动写入有效状态文件 rules/config.json），无需手动编辑。