<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>网络 on 我的博客</title><link>https://blog.5616760.com/tags/%E7%BD%91%E7%BB%9C/</link><description>Recent content in 网络 on 我的博客</description><generator>Hugo -- gohugo.io</generator><language>zh</language><lastBuildDate>Wed, 04 Nov 2026 21:20:00 +0800</lastBuildDate><atom:link href="https://blog.5616760.com/tags/%E7%BD%91%E7%BB%9C/index.xml" rel="self" type="application/rss+xml"/><item><title>P2WLAN：异地设备进同一张网，顺手把「连接到底通没通」写成了 53KB 规格</title><link>https://blog.5616760.com/0068.html</link><pubDate>Wed, 04 Nov 2026 21:20:00 +0800</pubDate><guid>https://blog.5616760.com/0068.html</guid><description>&lt;p&gt;&lt;img alt="图：P2WLAN 官方封面" loading="lazy" sizes="(max-width: 767px) calc(100vw - 30px), (max-width: 1023px) 700px, (max-width: 1279px) 950px, 1232px" src="https://blog.5616760.com/img/0068-001.jpg"&gt;&lt;/p&gt;&#10;&lt;p&gt;P2WLAN 是一款&lt;strong&gt;免费开源的虚拟局域网工具&lt;/strong&gt;：给异地设备分配私有虚拟 IP，让它们像插在同一台路由器上一样互相访问。朋友异地联机、在外连家里的 NAS、连远端开发机，都不用逐个开公网端口。&lt;/p&gt;&#10;&lt;p&gt;项目：https://github.com/yhan-sun/p2wlan（3,312 Star · 154 Fork · MIT · Rust 主语言）&lt;/p&gt;&#10;&lt;p&gt;公众号上关于它的介绍已经不少。这篇补三件别处没说的：&lt;strong&gt;规模到底有多大、技术含量具体在哪、以及为什么它现在还不能「装完就用」&lt;/strong&gt;。&lt;/p&gt;&#10;&#10; &lt;blockquote&gt;&#10; &lt;p&gt;本文所有数字均为 2026-11-04 通过 GitHub REST API 实测，非引用二手报道。&lt;/p&gt;&#10;&#10; &lt;/blockquote&gt;&#10;&lt;hr&gt;&#10;&lt;h2 id="01--先看硬数据"&gt;01 · 先看硬数据&#10;&lt;/h2&gt;&lt;table&gt;&#10;&#9;&lt;thead&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;维度&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;实测值&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;备注&lt;/th&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/thead&gt;&#10;&#9;&lt;tbody&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Star / Fork&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;3,312 / 154&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;关注者远多于深度使用者&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Watchers&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;5&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;极低，社区尚未形成&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;建库 / 最近 push&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;2026-07-16 / 2026-11-02&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;存续 111 天&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Commit 总数&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;1,835&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;平均每天 16.5 次&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;贡献者&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;10&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;前两位占 93.6%&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Release 总数&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;165&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;v0.1.68 → v0.1.171&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;PR / Issue&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;236 / 33&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;开着的 issue 仅 2 个&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;许可证&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;MIT&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;客户端 + Control + Relay 全覆盖&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/tbody&gt;&#10;&lt;/table&gt;&#10;&lt;p&gt;把贡献者名单摊开：&lt;/p&gt;&#10;&lt;pre tabindex="0"&gt;&lt;code&gt;anYuJia 1041&#10;yhan-sun 677&#10;J-cloud-J 66&#10;github-actions[bot] 15&#10;dependabot[bot] 12&#10;jwc1love 10&#10;Libestor 8&#10;P2WLAN maintenance 3&#10;RoamerFly 2&#10;YZoiu 1&#10;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;&lt;strong&gt;两个人写了 93.6% 的代码。&lt;/strong&gt; 这不是缺点，但它决定了项目的真实形态：一个高密度小团队的产物，不是社区共建项目。Bus factor 事实上是 1.5。&lt;/p&gt;&#10;&lt;p&gt;代码规模（&lt;code&gt;git/trees/main?recursive=1&lt;/code&gt;，2,451 项，未截断）：&lt;/p&gt;&#10;&lt;table&gt;&#10;&#9;&lt;thead&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;语言&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th style="text-align: right"&gt;文件数&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th style="text-align: right"&gt;体积&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th style="text-align: right"&gt;其中测试&lt;/th&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/thead&gt;&#10;&#9;&lt;tbody&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Rust&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;922&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;14.0 MB&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;234 个 / 4.1 MB&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Python（验收脚本）&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;251&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;3.5 MB&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;—&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Dart（Flutter GUI）&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;244&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;2.8 MB&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;77 个 / 0.8 MB&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Go（Control + Relay）&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;174&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;1.3 MB&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;94 个 / 0.65 MB&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;文档（&lt;code&gt;docs/&lt;/code&gt;）&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;19&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;190 KB&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;—&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/tbody&gt;&#10;&lt;/table&gt;&#10;&lt;p&gt;&lt;strong&gt;测试代码占 Rust 总量 29%、Go 总量 50%。&lt;/strong&gt; 这个比例在个人主导的网络项目里不常见。&lt;/p&gt;&#10;&lt;p&gt;版本节奏也值得记一笔：96 天 165 个 release，平均 &lt;strong&gt;1.7 天发一次&lt;/strong&gt;。&lt;code&gt;0.1.68 → 0.1.171&lt;/code&gt;，三个月涨了 103 个 patch 号。这既是活跃度也是不稳定性——含义是协议和行为还在高频变动，不是「稳定版在打补丁」。&lt;/p&gt;&#10;&lt;hr&gt;&#10;&lt;h2 id="02--它解决的是-nat-那道墙"&gt;02 · 它解决的是 NAT 那道墙&#10;&lt;/h2&gt;&lt;p&gt;场景很朴素：家里开 Minecraft 服务器，朋友在学校连不上。&lt;/p&gt;&#10;&lt;p&gt;因为家庭路由器做 NAT，外部主动来的包进不来；而多数家庭宽带、校园网、移动网络根本没有可用公网 IPv4，还叠着 CGNAT 和企业防火墙。&lt;/p&gt;&#10;&lt;p&gt;P2WLAN 的做法是虚拟三层网络：给设备分配 &lt;code&gt;10.x.x.x&lt;/code&gt; 虚拟 IP，应用照常用「IP + 端口」访问，不暴露任何公网端口。&lt;/p&gt;&#10;&lt;p&gt;但这里有个容易误读的地方，官方文档写得很明确：&lt;/p&gt;&#10;&#10; &lt;blockquote&gt;&#10; &lt;p&gt;P2WLAN 提供的是三层 IP 网络，不提供以太网二层广播桥接。&lt;/p&gt;&#10;&#10; &lt;/blockquote&gt;&#10;&lt;p&gt;&lt;strong&gt;所以「依赖局域网广播自动发现」的游戏，装上也搜不到对方&lt;/strong&gt;，必须手动填 IP。这条限制挡住了相当一部分「局域网联机」的想象空间，也是它和 ZeroTier（提供虚拟以太网 / 二层桥接）最本质的功能差异。&lt;/p&gt;&#10;&lt;hr&gt;&#10;&lt;h2 id="03--路径策略三段式5-秒直连窗口"&gt;03 · 路径策略：三段式，5 秒直连窗口&#10;&lt;/h2&gt;&lt;pre class="mermaid" style="visibility:hidden"&gt;flowchart LR&#10; A["设备 A&lt;br/&gt;虚拟 IP 10.20.0.2"] -.-&gt;|"① LAN Direct"| B["设备 B&lt;br/&gt;虚拟 IP 10.20.0.5"]&#10; A -.-&gt;|"② IPv6 / IPv4 UDP Direct"| B&#10; A -.-&gt;|"③ 直连失败"| R["Encrypted Relay&lt;br/&gt;转发密文，不解密"]&#10; R -.-&gt; B&#10; A --&gt;|"认证 / 信令"| C["Control Plane&lt;br/&gt;身份 · 设备 · 虚拟 IP · 候选协调"]&#10; B --&gt;|"认证 / 信令"| C&#10; style A fill:#2563eb,stroke:#2563eb,color:#fff&#10; style B fill:#2563eb,stroke:#2563eb,color:#fff&#10; style R fill:#f59e0b,stroke:#f59e0b,color:#fff&#10; style C fill:#10b981,stroke:#10b981,color:#fff&lt;/pre&gt;&lt;p&gt;默认先保留 &lt;strong&gt;5 秒直连窗口&lt;/strong&gt;，同时并行准备 Relay；窗口结束后才允许启用已确认的加密中继。已建立的直连失活时允许 Relay 兜底，并继续尝试恢复直连。&lt;/p&gt;&#10;&lt;p&gt;&lt;strong&gt;对应用完全透明：虚拟 IP 不变，不用重配地址。&lt;/strong&gt;&lt;/p&gt;&#10;&lt;p&gt;Relay 只在直连不可用时参与，转发的是密文——但节点标识、时间、包大小这些元数据仍对中继可见。这一点官方在隐私说明里没藏着。&lt;/p&gt;&#10;&lt;hr&gt;&#10;&lt;h2 id="04--真正硬的地方打洞不是支持不支持"&gt;04 · 真正硬的地方：打洞不是「支持/不支持」&#10;&lt;/h2&gt;&lt;p&gt;多数同类软件在这件事上的表述是二元的：支持打洞 / 对称 NAT 用中继。P2WLAN 的 README 给的是一张 4×4 矩阵，按 RFC 3489 的经典 NAT 命名交叉：&lt;/p&gt;&#10;&lt;table&gt;&#10;&#9;&lt;thead&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;本端 ↓ / 对端 →&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;全锥形&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;受限锥形&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;端口受限锥形&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;对称 NAT&lt;/th&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/thead&gt;&#10;&#9;&lt;tbody&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;strong&gt;全锥形&lt;/strong&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;🟢&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;🟢&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;🟢&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;🟢&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;strong&gt;受限锥形&lt;/strong&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;🟢&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;🟢&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;🟢&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;🟢&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;strong&gt;端口受限锥形&lt;/strong&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;🟢&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;🟢&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;🟢&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;🟡 条件&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;strong&gt;对称 NAT&lt;/strong&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;🟢&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;🟢&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;🟡 条件&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;🟡 双端条件&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/tbody&gt;&#10;&lt;/table&gt;&#10;&lt;p&gt;🟢 常规支持（常规 UDP 探测 + 经认证的源地址学习可建立直连）｜🟡 条件支持（需结合实测端口规律、过滤规则与协调探测）&lt;/p&gt;&#10;&lt;p&gt;关键是最后一行：&lt;strong&gt;它不因为「对称 NAT」这个标签就放弃。&lt;/strong&gt; 双端对称 NAT 时走的是三套策略的组合：&lt;/p&gt;&#10;&lt;ul&gt;&#10;&lt;li&gt;&lt;strong&gt;端口预测&lt;/strong&gt; —— 学端口分配的步长与范围，按规律推出候选&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;固定锚&lt;/strong&gt; —— 双方测量都支持时，用 2/4/8 个 socket 做首波覆盖&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;有界生日探测&lt;/strong&gt; —— 端口域内按与域宽互素的步长扫描&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;p&gt;文档里的实现约束细到这种程度：&lt;/p&gt;&#10;&#10; &lt;blockquote&gt;&#10; &lt;p&gt;单 socket 预测窗口最多 32 个候选。完整同方向尾段可生成有界的连续后继假设……观察到跳号时使用完整生日窗口，最多发布 96 个候选。&lt;/p&gt;&#10;&#10; &lt;/blockquote&gt;&#10;&#10; &lt;blockquote&gt;&#10; &lt;p&gt;目标 IP 聚合上限为每秒 448、每 60 秒 4500；原有进程上限每秒 512、每 60 秒 6000 不变。&lt;/p&gt;&#10;&#10; &lt;/blockquote&gt;&#10;&lt;p&gt;这是把「探测预算」当一等公民在管。原因不难理解：&lt;strong&gt;打洞本质是向陌生 IP 发包&lt;/strong&gt;，在别人的网络里就是攻击特征。没有预算控制，这套东西在校园网和企业网会被当成扫描器处理。&lt;/p&gt;&#10;&lt;p&gt;&lt;code&gt;hh2&lt;/code&gt;（Hard↔Hard 打洞协商）的启用条件是双方注册&lt;strong&gt;都声明&lt;/strong&gt; &lt;code&gt;hh2_pair_nomination&lt;/code&gt; 和 &lt;code&gt;hh2_plan_v2&lt;/code&gt; 两项能力，不满足就退回旧流程——用能力协商替代版本号判断，是这里最正确的工程决策。&lt;/p&gt;&#10;&lt;hr&gt;&#10;&lt;h2 id="05--架构控制面与数据面彻底分开"&gt;05 · 架构：控制面与数据面彻底分开&#10;&lt;/h2&gt;&lt;pre class="mermaid" style="visibility:hidden"&gt;flowchart TB&#10; subgraph Client["客户端进程"]&#10; F["Flutter GUI&lt;br/&gt;登录 · 设备 · 房间 · 诊断"]&#10; D["Rust daemon&lt;br/&gt;TUN · 路由 · Peer · NAT 穿透 · 加密会话"]&#10; F --&gt;|"本地控制接口"| D&#10; end&#10; D --&gt;|"HTTPS / WSS&lt;br/&gt;认证 · 信令 · 路径遥测"| CP["Control Plane&lt;br/&gt;Go + SQLite"]&#10; D &lt;.-&gt;|"加密业务数据&lt;br/&gt;Direct"| P["对端 daemon"]&#10; D -.-&gt;|"Direct 不可用"| RL["Relay&lt;br/&gt;Go · TLS"]&#10; RL -.-&gt; P&#10; CP -.-&gt;|"下发 Relay 票据"| D&#10; style F fill:#3b82f6,stroke:#3b82f6,color:#fff&#10; style D fill:#8b5cf6,stroke:#8b5cf6,color:#fff&#10; style CP fill:#10b981,stroke:#10b981,color:#fff&#10; style RL fill:#f59e0b,stroke:#f59e0b,color:#fff&#10; style P fill:#64748b,stroke:#64748b,color:#fff&lt;/pre&gt;&lt;table&gt;&#10;&#9;&lt;thead&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;模块&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;技术&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;职责&lt;/th&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/thead&gt;&#10;&#9;&lt;tbody&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;GUI&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Flutter&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;登录、设备/房间管理、连接状态与诊断&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Data Plane&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Rust&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;TUN、路由、Peer、NAT traversal、加密会话、Relay fallback&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;虚拟网卡&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;macOS &lt;code&gt;utun&lt;/code&gt; / Windows Wintun / Linux TUN&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;为应用提供普通的三层虚拟接口&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Control Plane&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Go + SQLite&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;认证、设备注册、虚拟 IP、凭据、信令、Relay catalog&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Relay&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Go&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;票据校验、密文转发&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/tbody&gt;&#10;&lt;/table&gt;&#10;&lt;p&gt;数据面是&lt;strong&gt;自包含的 WireGuard-like Noise&lt;/strong&gt;，用 X25519 + ChaCha20-Poly1305 + BLAKE2s。官方明确声明：&lt;/p&gt;&#10;&#10; &lt;blockquote&gt;&#10; &lt;p&gt;P2WLAN 不是官方 WireGuard 实现，也不声明 WireGuard 互操作兼容。&lt;/p&gt;&#10;&#10; &lt;/blockquote&gt;&#10;&lt;p&gt;后果是双向的：不受 WireGuard 生态的协议约束，可以做自己的路径管理与中继票据；反过来，&lt;strong&gt;你无法用标准 WireGuard 客户端接入这张网&lt;/strong&gt;。&lt;/p&gt;&#10;&lt;p&gt;一处值得单独提的架构原则，写在 &lt;code&gt;docs/explanation/architecture.md&lt;/code&gt; 里：&lt;/p&gt;&#10;&#10; &lt;blockquote&gt;&#10; &lt;p&gt;daemon 是活动路径事实的唯一所有者，Control 不推断或猜测数据面路径。&lt;/p&gt;&#10;&#10; &lt;/blockquote&gt;&#10;&lt;p&gt;Control 只持久化 daemon 主动上报的路径快照，&lt;strong&gt;不会根据 RTT、候选或在线标记自己推算「这条应该是直连」&lt;/strong&gt;。这一条约束住了整类「界面显示 Direct、实际走中继」的经典故障。&lt;/p&gt;&#10;&lt;hr&gt;&#10;&lt;h2 id="06--最有价值的一份文档路径可观测性"&gt;06 · 最有价值的一份文档：路径可观测性&#10;&lt;/h2&gt;&lt;p&gt;&lt;code&gt;docs/reference/path-observability.md&lt;/code&gt;，&lt;strong&gt;53,119 字节&lt;/strong&gt;，比 README 还长一倍。&lt;/p&gt;&#10;&lt;p&gt;它回答的问题只有一个：&lt;strong&gt;你怎么证明当前这条连接是 Direct，而不是你以为的 Direct？&lt;/strong&gt;&lt;/p&gt;&#10;&lt;p&gt;答案是五级围栏（fencing）：&lt;/p&gt;&#10;&lt;pre class="mermaid" style="visibility:hidden"&gt;flowchart LR&#10; A["registration_seq&lt;br/&gt;会话所有者"] --&gt; B["network_generation&lt;br/&gt;网络代际"]&#10; B --&gt; C["peer_session_generation&lt;br/&gt;对端会话"]&#10; C --&gt; D["remote_candidate_epoch&lt;br/&gt;候选代际"]&#10; D --&gt; E["observation_revision&lt;br/&gt;观测序号"]&#10; style A fill:#dc2626,stroke:#dc2626,color:#fff&#10; style E fill:#94a3b8,stroke:#94a3b8,color:#fff&lt;/pre&gt;&lt;p&gt;含义：&lt;strong&gt;旧会话过期后上报的路径状态，无论 revision 编号多大，都不能覆盖新会话的记录。&lt;/strong&gt; 设计目标直接写在文档里——&lt;/p&gt;&#10;&#10; &lt;blockquote&gt;&#10; &lt;p&gt;控制面可达或探测 ACK 不能单独证明业务互通。&lt;/p&gt;&#10;&#10; &lt;/blockquote&gt;&#10;&lt;p&gt;也就是说，&lt;code&gt;ping&lt;/code&gt; 通、登录成功、界面显示 &lt;code&gt;Direct&lt;/code&gt; 标签，这三件事都&lt;strong&gt;不构成证据&lt;/strong&gt;。判定必须来自当前 generation 下、完成加密确认、且经过实际业务验证的路径。&lt;/p&gt;&#10;&lt;p&gt;遥测还做了严格的数据最小化：只传路径类型（direct / relay / connecting / probing / fallback_relay / failed / none）、RTT、代际标识和迁移原因码。&lt;strong&gt;不传任何 IP、端口、候选 endpoint、密钥或报文载荷。&lt;/strong&gt;&lt;/p&gt;&#10;&lt;p&gt;为什么这套东西重要？因为虚拟组网软件最典型的故障是「看起来通、实际走中继」——用户为此多付了延迟，却以为自己在直连。把「路径事实由 daemon 唯一拥有」写成架构原则，是这类工具里少见的严谨。&lt;/p&gt;&#10;&lt;hr&gt;&#10;&lt;h2 id="07--仓库里有一份写给-ai-的工程禁令"&gt;07 · 仓库里有一份写给 AI 的工程禁令&#10;&lt;/h2&gt;&lt;p&gt;根目录有一份 3.6 KB 的 &lt;code&gt;AGENTS.md&lt;/code&gt;，开头一句：&lt;/p&gt;&#10;&#10; &lt;blockquote&gt;&#10; &lt;p&gt;本文件是仓库级工作契约。任何 AI 或自动化代理在修改本仓库前都必须遵守它。&lt;/p&gt;&#10;&#10; &lt;/blockquote&gt;&#10;&lt;p&gt;内容是负面清单，且几乎每条都对应一种真实翻车模式：&lt;/p&gt;&#10;&lt;table&gt;&#10;&#9;&lt;thead&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;约束&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;对应的翻车模式&lt;/th&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/thead&gt;&#10;&#9;&lt;tbody&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;strong&gt;单一状态所有者&lt;/strong&gt;：影响连接正确性的事实只能有一个权威所有者&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;两份状态各自演进，最后谁也不知道哪份是真的&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;strong&gt;有界资源&lt;/strong&gt;：队列/缓存/重试必须回答容量、生命周期、取消条件、失败如何观测&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;无限 channel、无限重试、无 deadline 等待、静默丢包&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;strong&gt;锁不跨不受控等待&lt;/strong&gt;：禁止持锁做网络 I/O、sleep 或无上界 await&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;死锁、优先级反转&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;strong&gt;错误是 API 的一部分&lt;/strong&gt;：日志文本不是状态机接口&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;用字符串匹配恢复控制流&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;strong&gt;生产路径不得用 panic&lt;/strong&gt; 处理可被网络/输入/远端状态触发的失败&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;一个畸形包打崩整个 daemon&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/tbody&gt;&#10;&lt;/table&gt;&#10;&lt;p&gt;配套的 &lt;code&gt;scripts/quality/check_code_health.py&lt;/code&gt; 是个&lt;strong&gt;复杂度棘轮&lt;/strong&gt;：历史热点相对 PR 基线只能缩小，不能扩大。&lt;/p&gt;&#10;&lt;p&gt;CI 有 &lt;strong&gt;22 条 workflow&lt;/strong&gt;，命名直接暴露了验收口径：&lt;/p&gt;&#10;&lt;pre tabindex="0"&gt;&lt;code&gt;nat-topology-gate · dplpmtud-required · path-state-machine-required&#10;business-mtu-budget-required · mobile-lifecycle · windows-lifecycle&#10;parallel-rooms · room-connectivity · rekey-reliability&#10;security-audit-required · release-post-publish-audit&#10;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;大多数开源网络工具只有一条 &lt;code&gt;ci.yml&lt;/code&gt;。这里把「NAT 拓扑」「MTU 预算」「路径状态机」「重密钥可靠性」各自拆成必须通过的独立门禁——&lt;strong&gt;因为这些恰恰是最容易静默退化的地方。&lt;/strong&gt;&lt;/p&gt;&#10;&lt;hr&gt;&#10;&lt;h2 id="08--界面房间把谁和谁互联单独拎出来"&gt;08 · 界面：房间把「谁和谁互联」单独拎出来&#10;&lt;/h2&gt;&lt;p&gt;&lt;img alt="图：P2WLAN 首页，网络状态与在线设备" loading="lazy" sizes="(max-width: 767px) calc(100vw - 30px), (max-width: 1023px) 700px, (max-width: 1279px) 950px, 1232px" src="https://blog.5616760.com/img/0068-002.jpg"&gt;&lt;/p&gt;&#10;&lt;p&gt;&lt;img alt="图：设备列表，节点、速率与在线状态" loading="lazy" sizes="(max-width: 767px) calc(100vw - 30px), (max-width: 1023px) 700px, (max-width: 1279px) 950px, 1232px" src="https://blog.5616760.com/img/0068-003.jpg"&gt;&lt;/p&gt;&#10;&lt;p&gt;客户端不只是一串 IP 列表。&lt;strong&gt;房间&lt;/strong&gt;是它相对同类工具有辨识度的设计：&lt;/p&gt;&#10;&lt;p&gt;&lt;img alt="图：互联页面，多房间管理与连接延迟" loading="lazy" sizes="(max-width: 767px) calc(100vw - 30px), (max-width: 1023px) 700px, (max-width: 1279px) 950px, 1232px" src="https://blog.5616760.com/img/0068-004.jpg"&gt;&lt;/p&gt;&#10;&lt;p&gt;一个 Minecraft 生存服一个房间，NAS 运维一个房间，开发测试一个房间——各自独立网络与虚拟 IP，不混在同一个设备列表里。加入方式支持房间号或邀请，成员能看在线状态、虚拟 IP、连接路径和延迟。&lt;/p&gt;&#10;&lt;p&gt;&lt;img alt="图：房间详情，虚拟 IP、连接路径与延迟" loading="lazy" sizes="(max-width: 767px) calc(100vw - 30px), (max-width: 1023px) 700px, (max-width: 1279px) 950px, 1232px" src="https://blog.5616760.com/img/0068-005.jpg"&gt;&lt;/p&gt;&#10;&lt;p&gt;界面上 &lt;code&gt;LAN Direct&lt;/code&gt; / &lt;code&gt;Direct&lt;/code&gt; / &lt;code&gt;Relay&lt;/code&gt; 三种标签是分开的，用户能直接判断当前到底直连还是绕中继。&lt;/p&gt;&#10;&lt;p&gt;没有图形环境的 Linux 服务器用 CLI + daemon，排障命令：&lt;/p&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-sh" data-lang="sh"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;p2wlan status --json&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;p2wlan doctor&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;p2wlan route verify&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;p2wlan logs -f&#10;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;hr&gt;&#10;&lt;h2 id="09--三个必须说清的代价"&gt;09 · 三个必须说清的代价&#10;&lt;/h2&gt;&lt;h3 id="-没有默认服务器冷启动就是一道墙"&gt;① 没有默认服务器，冷启动就是一道墙&#10;&lt;/h3&gt;&lt;p&gt;新安装&lt;strong&gt;不预填&lt;/strong&gt;项目运营的 Control 或 Relay，也不自动注册账号。官方快速开始第一步就是「先准备 Control 地址」。&lt;/p&gt;&#10;&lt;p&gt;自托管路径是 Linux + systemd，发布 &lt;code&gt;server-vX.Y.Z&lt;/code&gt; 独立包，普通部署不需要在服务器上装 Go 或 Node。&lt;/p&gt;&#10;&lt;p&gt;&lt;strong&gt;这是设计选择，不是缺陷&lt;/strong&gt;（避免把所有用户绑到同一个中心）。但它意味着：&lt;strong&gt;「免费开源」和「零成本可用」是两件事。&lt;/strong&gt; 服务器、域名、TLS 证书、中继带宽都由部署者承担。想临时和朋友联机又没有服务器，前期准备工作量不小。&lt;/p&gt;&#10;&lt;h3 id="-01x且没有独立安全审计"&gt;② 0.1.x，且没有独立安全审计&#10;&lt;/h3&gt;&lt;p&gt;项目自己在 &lt;code&gt;SECURITY.md&lt;/code&gt; 里写得直白：&lt;/p&gt;&#10;&#10; &lt;blockquote&gt;&#10; &lt;p&gt;项目尚未完成独立安全审计，不声明安全认证；加密实现、CI 检查与发布清单不能替代独立审计。&lt;/p&gt;&#10;&#10; &lt;/blockquote&gt;&#10;&lt;p&gt;对家庭测试和开发验证，了解边界后可以用；对&lt;strong&gt;企业核心系统，这条「未审计」就是硬拒理由&lt;/strong&gt;。&lt;/p&gt;&#10;&lt;h3 id="-版本双命名空间说明协议还在动"&gt;③ 版本双命名空间，说明协议还在动&#10;&lt;/h3&gt;&lt;p&gt;客户端 &lt;code&gt;vX.Y.Z&lt;/code&gt;、服务端 &lt;code&gt;server-vX.Y.Z&lt;/code&gt;，官方特意声明：&lt;/p&gt;&#10;&#10; &lt;blockquote&gt;&#10; &lt;p&gt;即使两个标签具有相同的数字后缀，也不表示它们指向同一个源码提交、同一次构建或同一组发布产物。&lt;/p&gt;&#10;&#10; &lt;/blockquote&gt;&#10;&lt;p&gt;配合 &lt;code&gt;hh2&lt;/code&gt; 的能力协商机制可以判断：&lt;strong&gt;协议还在快速演进，别指望版本号一致就能互通。&lt;/strong&gt;&lt;/p&gt;&#10;&lt;hr&gt;&#10;&lt;h2 id="10--和-tailscale--zerotier--easytier-怎么选"&gt;10 · 和 Tailscale / ZeroTier / EasyTier 怎么选&#10;&lt;/h2&gt;&lt;table&gt;&#10;&#9;&lt;thead&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;强项&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;代价&lt;/th&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/thead&gt;&#10;&#9;&lt;tbody&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;strong&gt;P2WLAN&lt;/strong&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;房间式组织、图形客户端、直连优先 + 加密中继一体、三端 MIT 可自托管&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;需自备 Control；三层网络不桥接广播；0.1.x 未审计&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;strong&gt;Tailscale&lt;/strong&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;托管控制面、WireGuard 数据面、成熟 ACL 与设备管理&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;官方服务为主；双端 hard NAT 走 DERP 中继&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;strong&gt;ZeroTier&lt;/strong&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;虚拟以太网、二层桥接、可自建控制器&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;配置重；对称 NAT 下易走中继&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;strong&gt;EasyTier&lt;/strong&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;去中心化 mesh、多协议传输、子网代理&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;拓扑与协议配置由部署者负责&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/tbody&gt;&#10;&lt;/table&gt;&#10;&lt;p&gt;一句话分工：&lt;strong&gt;要省事选 Tailscale，要二层语义选 ZeroTier，要 mesh 拓扑选 EasyTier；要「朋友进一个房间就能联机」且想把服务器攥在自己手里，才是 P2WLAN 的位置。&lt;/strong&gt;&lt;/p&gt;&#10;&lt;hr&gt;&#10;&lt;h2 id="11--给不同人的判断"&gt;11 · 给不同人的判断&#10;&lt;/h2&gt;&lt;ul&gt;&#10;&lt;li&gt;&lt;strong&gt;普通用户&lt;/strong&gt;：想要开箱即用，现在不合适——没有公共 Control，你得先有台服务器。想玩，找一个愿意跑服务端的朋友。&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;HomeLab / 自建服务玩家&lt;/strong&gt;：这是它的主场。三层网络足够 SSH、RDP、NAS Web 面板、数据库；房间把「游戏组」和「运维组」分开这点，比 Tailscale 的 ACL 更直观。&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;企业 / 生产环境&lt;/strong&gt;：不行。未审计 + 0.1.x + bus factor 1.5。&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;做网络方向的人&lt;/strong&gt;：&lt;strong&gt;这个仓库值得读源码，不是读 README。&lt;/strong&gt; 三份文档按信息密度排序是 &lt;code&gt;path-observability.md&lt;/code&gt;(53KB) &amp;gt; &lt;code&gt;engineering-quality.md&lt;/code&gt;(27KB) &amp;gt; &lt;code&gt;networking.md&lt;/code&gt;(24KB)。它们不是产品介绍，是设计规格——包括失败模式、预算上限、围栏规则。同类开源项目里，把「我如何证明我的直连是真的」写到这个程度的不多。&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;hr&gt;&#10;&lt;h2 id="写在最后"&gt;写在最后&#10;&lt;/h2&gt;&lt;p&gt;这类工具最有意思的地方，不只是「能连上」，而是**「能证明自己是怎么连上的」**。&lt;/p&gt;&#10;&lt;p&gt;3,312 star 里，大概多数人只是觉得「异地联机」这个场景爽。但它真正的工程量花在了别处——NAT 探测预算、代际围栏、路径可观测性、复杂度棘轮。这些不进 demo，不影响 star 曲线，但它们决定了这东西在真实网络里会不会悄悄退化。&lt;/p&gt;&#10;&lt;p&gt;代价也清楚：三个半月 165 个版本、0.1.171、没有审计、没有公共服务器。&lt;/p&gt;&#10;&lt;p&gt;&lt;strong&gt;它现在是一份很好的工程样本，不是一个可以交给非技术朋友的成品。&lt;/strong&gt;&lt;/p&gt;&#10;&lt;hr&gt;&#10;&#10; &lt;blockquote&gt;&#10; &lt;p&gt;&lt;strong&gt;数据来源&lt;/strong&gt;：GitHub REST API 实测（2026-11-04 12:30 UTC），含 &lt;code&gt;/repos&lt;/code&gt;、&lt;code&gt;/commits?per_page=1&lt;/code&gt;（Link last page 1835）、&lt;code&gt;/contributors?anon=1&lt;/code&gt;、&lt;code&gt;/releases&lt;/code&gt;（165 页）、&lt;code&gt;/search/issues&lt;/code&gt;、&lt;code&gt;/git/trees/main?recursive=1&lt;/code&gt;（2,451 项未截断）。文档引文出自 &lt;code&gt;README.md&lt;/code&gt;、&lt;code&gt;docs/reference/networking.md&lt;/code&gt;、&lt;code&gt;docs/reference/path-observability.md&lt;/code&gt;、&lt;code&gt;docs/explanation/architecture.md&lt;/code&gt;、&lt;code&gt;docs/explanation/engineering-quality.md&lt;/code&gt;、&lt;code&gt;AGENTS.md&lt;/code&gt;、&lt;code&gt;SECURITY.md&lt;/code&gt;、&lt;code&gt;docs/reference/compatibility.md&lt;/code&gt;。截图取自项目官方仓库 &lt;code&gt;assets/readme/&lt;/code&gt;。&lt;/p&gt;&#10;&lt;p&gt;&lt;strong&gt;未验证项&lt;/strong&gt;：NAT 打洞实际成功率、与 Tailscale / ZeroTier / EasyTier 的功能对等度。本文只比较各项目&lt;strong&gt;文档中声明的策略&lt;/strong&gt;，未做横向实测。&lt;/p&gt;&#10;&#10; &lt;/blockquote&gt;&#10;</description></item></channel></rss>