Muffin：zapret 图形界面启动器

项目简介

Muffin 是 zapret 的跨平台图形界面（Qt6 / C++20）：Windows 下调用 winws，Linux 下调用 nfqws。它省去了手动编辑 .bat、敲终端命令、折腾 Cloudflare WARP 配置的麻烦，所有操作都在同一个窗口里完成。

主要功能

• 零配置部署：自动下载最新 zapret 发行版，校验 SHA-256 后安装到 /opt 或 Program Files。
• 真实 Blockcheck：测试实际的 TLS 握手（而非只发 ICMP），从 22 个配置中找出当前真正能绕过运营商 DPI 的那个。
• WARP 集成：自动安装、注册并配置 Cloudflare WARP，并隐藏其原生界面，保持在同一个窗口内操作。
• 智能看门狗：后台监控，当运营商改变 DPI 规则导致失效时，检测到故障并提示你切换策略。
• 本地统计：记录每个配置的历史成功率，方便判断哪个最稳定。
• 界面：无边框窗口、深色/浅色主题、平滑动画与霓虹配色；提供策略卡片、实时日志、ping 指示器和系统托盘。

安装与使用

Windows：从 Releases 下载 Muffin-Setup-x.x.x.exe 并运行安装（需要管理员权限，供 WinDivert 使用），首次启动会自动下载并配置 winws。

Linux（Debian / Ubuntu / Kali）：下载 .deb 包后执行：

sudo apt install ./muffin_x.x.x_amd64.deb

Ubuntu 24.04 / Linux Mint 22.x 需下载带 -ubuntu24.04.deb 后缀的包——标准包针对更新的 Qt 版本构建，在这些系统上无法启动。

Arch Linux：仓库内提供现成的 PKGBUILD：

git clone https://github.com/F0RSES/zapret-muffin-gui.git
cd zapret-muffin-gui/packaging/arch
makepkg -si

从源码构建：需要 Qt 6.6+、CMake 3.21+、GCC 11+ 或 MSVC 2022：

./scripts/build.sh
ctest --output-on-failure

注意事项

• Muffin 不修改原始二进制文件，而是从官方来源下载：Windows 端为 Flowseal/zapret-discord-youtube，Linux 端为 bol-van/zapret。
• 项目以 MIT 许可证分发。

本作品整理自 GitHub 开源项目 F0RSES/zapret-muffin-gui，原作者 @F0RSES，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。