ZOYKUHot Board

cuteethanleo/mistsailDokumentacja

雾帆 MistSail:基于 Sheas Cealer 1.1.4 的本地改版。一键在本机接管 TLS 握手(nginx 改写 SNI / 回环中继分片 ClientHello),无代理服务器。仅供抵御网络非法监听与网络安全研究。

Uwaga dotycząca języka:Brak zlokalizowanej dokumentacji. Wyświetlana jest oficjalna wersja oryginalna w języku angielskim.
Szybka instalacja
git clone https://github.com/cuteethanleo/mistsail.git

雾帆 MistSail

— 让握手藏进雾里 —

基于开源项目 Sheas Cealer 1.1.4 的本地改版 · WPF / .NET 8 · Windows

这是什么

HTTPS 加密了网页内容,但 TLS 握手第一个数据包 ClientHello 里的 SNI 仍是明文,链路上的中间设备可以据此识别、劫持或重置连接。

雾帆在本机接管握手,不使用任何境外代理服务器、VPN 或 TUN:

路线 适用 做法
本机 nginx 改写 SNI 常规站点 hosts 把域名指向 127.0.0.1,本机 nginx 用自签证书接管浏览器连接,再以改写后的 SNI 连向真实服务器
回环中继分片 拒绝改写 SNI 的 Cloudflare 类站点 hosts 把域名指向 127.0.0.2,进程内 SniRelay 把首个 ClientHello 按 TLS record 切片后透传,浏览器与真实服务器仍是端到端 TLS
本机 PAC + CONNECT 转发器 hosts 无法通配的动态视频域名(如 YouTube 的 rr*.googlevideo.com) 连接期间系统自动配置脚本只把这些后缀交给 127.0.0.1 的回环转发器,经 DoH 解析与 ClientHello 分片后直连;断开/退出时恢复原系统代理设置

主界面只有一个电源按钮,旧功能收进「更多功能」;连通性卡片、线路探测与「复制诊断信息」用于排查。

下载

到 Releases 下载 MistSail-v*-win-x64.zip,完整解压到新目录后右键 MistSail.exe 以管理员身份运行。压缩包为自包含 x64 版本,无需另装 .NET。

关于根证书,请如实了解

  • 全局模式启动时会生成一枚自签根证书并安装到当前用户的受信任根证书存储,仅用于让浏览器信任本机 nginx。
  • 出站到真实服务器仍是正常 TLS。回环分片中继这条路线不经过 nginx,也不解密任何流量。
  • 停止后证书会被清理;也可以随时在 certmgr.msc 里手动删除。

构建

依赖:.NET 8 SDK、Windows 10 17763+。

  1. 从官方 Sheas Cealer 1.1.4 免安装压缩包解压到 vendor/upstream-1.1.4/(提供 Cealing-Nginx.exe、Cealing-Mihomo.exe 等二进制,本仓库不包含)。
  2. lib/ 内已附带官方发行包中的 Sheas-Core.dll、Ona-Core.dll,用于解决原始源码缺少两个兄弟项目导致无法构建的问题。
  3. 运行:
.\Build-Package.ps1

脚本会先执行 Verification/RelayCheck 离线自检(只走回环地址,不访问外网),再发布自包含 x64 包到 artifacts/。

配置

direct-config.json 集中了全部参数,常用项:

键 默认 说明
FragmentMode auto 分片方式;由线路诊断决定,也可填具体策略或旧值 tcp / off
FragmentBytes 8 域名区域的分片字节数,域名总会被从中间切开
FragmentDelayMs 15 片与片之间的发送间隔
HandshakeTimeoutSeconds 4 单个候选 IP 发出 ClientHello 后的等待上限
RelayListenAddress 127.0.0.2 分片中继监听的回环地址
RelayHosts … 走分片中继的域名与候选 IP;为空数组时用 DoH 解析
RefreshCandidatesFromDoh true 候选 IP 全部失败后是否用 DoH 刷新该域名的候选
DohServers Cloudflare / Quad9 / Google 加密 DNS,带引导 IP
DesyncMode auto 内核级 WinDivert 假包;off 关闭、不加载驱动
DynamicProxyEnabled true 全局模式是否启用动态视频 PAC + 本机 CONNECT 转发器
DynamicProxyHosts ["googlevideo.com","youtubei.googleapis.com"] 只把这些后缀交给本机转发器;写域名即可,自动匹配子域
DynamicProxyOverrideExisting false 检测到已有公司 PAC / 固定代理时是否覆盖(默认不破坏原设置)

修改后停止并重新连接生效。更多说明见 README_DIRECT.md 与 README_X_RELAY.md。

日志与诊断

  • logs/relay.log:分片中继的每条连接结果(目标 IP、握手阶段、错误形态)、候选 IP 刷新、[video] 视频转发器/PAC 状态;不记录 URL、Cookie 或请求头。
  • logs/direct.log:实验性浏览器直连模式与视频转发器的连接日志。
  • 主界面「复制诊断信息」会把连通性结果、线路对照结论、PAC 端口/域名与系统 AutoConfigURL 一起复制到剪贴板。

能力边界

加密 DNS 与握手处理只能改善 DNS 污染和部分握手识别导致的问题,不改变路由,不能保证突破目标 IP 封锁、全部协议识别或站点自身的地区/账户限制。这是客户端方案的边界。

动态视频 PAC 只影响读取 Windows 自动配置脚本的程序(Chrome/Edge 等);Firefox 使用自带代理设置,需要改用“浏览器直连(实验)”模式。若线路已经能重组 TLS record/TCP 分段,视频路径仍会失败,诊断会明确说明。

注意事项与免责声明

  1. 本项目及所有相关资源仅供抵御网络非法监听和开展网络安全研究使用,无意绕过任何国家审查设备的审查。
  2. 使用前请阅读上游项目的隐私政策与使用协议,并遵守所在地法律法规。
  3. 本改版处于实验阶段,不保证任何站点可用;请勿与其他代理、VPN 或 TUN 软件同时使用。
  4. 全局模式连接期间会临时设置当前用户的 AutoConfigURL 指向本机 PAC,断开或退出时自动恢复;若程序被强杀,重新打开 MistSail 或运行 Repair-Remnants.ps1 即可恢复。检测到已有公司 PAC / 固定代理时默认不覆盖。

目录说明

路径 内容
Direct/ 本改版新增:SniRelay、FragmentingStream、DohResolver、DirectRelay、LineProbe、PacServer
Utils/SystemProxy.cs 本机 PAC 的系统代理设置与恢复
Wins/ Consts/ Convs/ Preses/ Proces/ Utils/ Props/ 上游 WPF 源码及本改版的界面修改
Verification/RelayCheck/ 离线自检程序
Cealing-Host-L.json 本地补充规则(含 google.com.hk),与上游快照分离
vendor/Cealing-Host-U.json 上游规则快照(文本,哈希保护)
docs/upstream/ 上游项目原始 README
docs/video/ 项目介绍视频的离线渲染脚本(Pillow + numpy + ffmpeg)

致谢

  • Space Time 的 Sheas Cealer、Cealing Host:本项目的全部基础。
  • kit 与 NiceBowl:SNI 伪造原理与说明文章。
  • upb-syssec 2023 年关于 TLS record 分片的公开测量。

许可

上游仓库未附带 LICENSE 文件,上游代码版权归原作者所有。本仓库对上游的修改与新增代码(Direct/、界面与构建脚本)以与上游相同的条件提供;若上游作者另有要求,将随时调整。

Kopia dokumentacji z oficjalnego repozytorium GitHub · Zobacz na GitHubie
Data migawki: 2026-11-08