P2WLAN

P2WLAN 是什么

P2WLAN 是面向游戏联机、远程访问和跨地域组网的免费开源虚拟局域网软件。和朋友一起玩 Minecraft、在外访问家里的 NAS、连接远端开发机，都可以通过一张私有虚拟网络完成。支持 Windows、macOS、Linux 和 Android，提供图形客户端与适合服务器的 CLI。

P2WLAN 为参与设备分配私有虚拟 IP，优先建立 局域网 / IPv6 / IPv4 UDP 直连；直连不可用时自动使用端到端加密中继。应用继续访问同一个虚拟 IP，无需为每项服务单独配置公网端口或动态域名。

现在开始： 下载客户端 → 使用管理员提供的 Control 地址，或部署自己的服务 → 登录并连接个人网络或房间 → 使用虚拟 IP 联机、访问服务。

为什么选择 P2WLAN

• 朋友联机，用一个房间组织。 房间号、邀请、成员和设备管理集中在客户端；游戏、协作和维护环境各自使用独立网络。
• 直连优先，减少中继绕行。 同一局域网直接通信，跨网络自动尝试 IPv6 和 UDP 打洞；直连成功后，业务流量无需消耗中继服务器带宽。
• 复杂网络也有连接后备。 直连暂不可用时自动回退加密 Relay；网络条件改善后继续尝试恢复直连，应用沿用虚拟 IP。
• 远程服务共用一张私网。 SSH、RDP、NAS、Web 面板和游戏服务器按虚拟 IP 与服务端口访问，便于集中管理自己的设备。
• 连接路径看得见。 客户端展示在线设备、Direct / Relay、延迟和收发信息，遇到问题可使用内置诊断定位。
• 软件免费，基础设施自己掌握。 MIT 许可开放客户端、Control 和 Relay 源码；可自行选择服务位置、管理账号与数据。自托管的服务器、带宽和域名费用由部署者承担。

赞助商

感谢 Moeflux 赞助本项目！Moeflux 是一家面向重度 AI 开发者的官方直连高品质模型 API 中转服务商，专注提供 Grok 系列、Claude 系列、Codex 系列与 DeepSeek 系列等模型。100% 官方源直供，不掺假、不注水，欢迎随时检验。价格显著低于同行，倍率低至 0.1折，稳定性高，支持企业级高并发，计费透明，Token 级账单可逐笔核验。为企业客户提供专业管理平台，支持签订正式合同并可开发票。现在通过此链接下单即可获赠 $1 额度。

界面预览

首页 · 网络状态与在线设备	设备 · 节点、速率与在线状态
互联 · 房间管理与连接延迟	房间详情 · 虚拟 IP、连接路径与延迟

从全局网络状态、设备在线情况，到多房间管理、连接方式和端到端延迟，常用信息可以直接在客户端里看到。设备名称和截图数据均为演示数据。

适用场景

P2WLAN 提供一张跨地域的虚拟三层网络。应用通过对端的虚拟 IP 和业务端口通信；目标服务需要监听可访问的地址，并允许对应的防火墙流量。

安装 P2WLAN 不会自动把所在家庭或办公网络中的其他设备接入虚拟网络。上面的访问示例以目标设备也运行 P2WLAN 为前提。

房间：把“我要和谁互联”单独组织起来

房间适合需要独立边界的临时或固定网络：例如一个 Minecraft 生存服、一次朋友联机、一组 NAS 维护设备，或者一个开发测试环境。客户端可以集中查看房间成员、在线状态、虚拟 IP、当前连接路径和延迟，不需要把所有设备混在同一个列表里。

与同类软件对比

功能、优势与使用取舍

如果你希望用图形界面把朋友、家庭设备和开发机组织进独立房间，同时掌握自己的 Control 与 Relay，P2WLAN 很适合这类需求。

两端 NAT 类型：打洞支持速查

按行找本端、按列找对端，看交叉格即可。 下表展示 P2WLAN 在经典 NAT 行为下的 IPv4 UDP 打洞路径，前提是两端可联系同一 Control、UDP 未被阻断、公网 IP 稳定、映射仍有效，且主机防火墙允许通信。

🟢 常规支持：常规 UDP 探测与经认证的源地址学习可建立直连路径。🟡 条件支持：需要结合实测端口规律、过滤规则与协调探测；条件不满足时自动使用可达的 Relay。标记表示支持路径，不是成功率或成功保证。

P2WLAN 不会仅凭“对称 NAT”标签放弃直连。 对条件组合，客户端按实测能力选择端口预测、固定锚或有界生日探测；双端高熵随机映射叠加严格过滤时优先保障 Relay 通信，并在出现新的直连证据时尝试恢复直连。中继可用性取决于 Relay 是否配置且可达。

多层 NAT、CGNAT、校园网和移动网络描述的是部署环境，不能单独决定矩阵中的类型。上表使用 RFC 3489 的经典名称帮助理解；实际策略按 RFC 4787 的映射与过滤行为分别测量，不把各软件的 NAT1–NAT4 编号当作统一标准。详细规则见网络文档。

打洞成功率：按网络条件比较

打洞成功率取决于两端的映射与过滤规则、UDP 可达性、端口分配、重试时间和网络负载。本对比未提供四款软件在同一组真实网络、明确版本和同一观测窗口下的横向实测数据，因此下表比较已实现或官方说明的连接策略，不作为成功率排名。

P2WLAN 的连接优势是直连优先、多策略探测与自动回退的组合。 高熵随机映射叠加严格过滤时仍可能需要 Relay；两端公网 IPv6 直连属于绕过 IPv4 NAT，不计入 IPv4 打洞成功率。使用 Relay 时，延迟和吞吐受中继位置、线路与带宽影响。

需要实测时，将 UDP 打洞成功率（在规定时间内经 IPv4 NAT 打洞建立双向业务的轮次 / 全部打洞轮次）、总体直连率（含 LAN / IPv6）与业务可用率（含 Relay）分别统计，并报告失败轮次、首次可用时间、RTT 和吞吐，避免把中继连通算作打洞成功。网络规则与路径观测说明 P2WLAN 的验证口径。

对比依据：Tailscale 连接类型、访问策略、Headscale、ZeroTier 路由建议、协议与虚拟以太网、自建控制器、EasyTier 官方说明。功能与条件以各项目当前文档为准。

快速开始

先准备 Control 地址。 新安装不预填项目运营的 Control 或 Relay，也不会自动注册账号。请向管理员获取可信的 Control 地址，或先完成自托管部署。需要互联的设备应使用同一个 Control；不同账号之间通过同一房间互联。

1. 下载

前往 GitHub Releases，选择客户端 vX.Y.Z 发布中的对应平台文件。服务端 server-vX.Y.Z 是独立发布，不是客户端安装包。

Linux 无桌面环境选择 CLI 包，也可使用固定版本安装脚本。把 vX.Y.Z 替换为实际客户端 Release 标签：

P2WLAN_VERSION=vX.Y.Z
curl -fsSL "https://raw.githubusercontent.com/yhan-sun/p2wlan/$P2WLAN_VERSION/scripts/install-linux-cli.sh" -o /tmp/p2wlan-install.sh
sudo sh /tmp/p2wlan-install.sh --version "$P2WLAN_VERSION"

2. 配置 Control

在客户端登录页的“高级选项 → 自托管服务器”中填写 Control 地址。https://control.example.com 仅是占位示例，需要替换为实际服务器地址。CLI 使用：

p2wlan config set control https://control.example.com

3. 注册／登录

在客户端注册账号或登录已有账号。CLI 登录已有账号：

p2wlan login -u your-name
p2wlan account show

没有账号时，使用 p2wlan register -u you@example.com 注册并保存登录状态；注册需要邮箱，登录可使用邮箱或已设置的用户名。密码由终端提示输入。配置和登录命令使用普通用户执行，不要加 sudo。

4. 连接设备

自己的设备互联： 在各设备上登录同一账号，完成首次设置并启动个人网络。CLI 使用：

p2wlan up
p2wlan status

与朋友或其他账号互联： 各设备使用同一个 Control，在客户端创建房间或通过房间号／邀请加入，再点击房间中的“连接本机”。加入房间只建立成员关系，不会自动启动本机网络。

CLI 房主先用 p2wlan room create --name my-room 创建房间，按提示设置房间密码，并将房间号交给其他成员。其他成员加入后，房主和成员都需要连接该房间：

# 成员加入：将 12345678 替换为实际的 8 位房间号，按提示输入房间密码
p2wlan room join --code 12345678
# 房主和成员：查看房间，并连接本机
p2wlan room list
p2wlan room connect 12345678
p2wlan room show 12345678

房间使用独立的网络和虚拟 IP。p2wlan up 启动个人网络，不能代替 p2wlan room connect。设备可能需要房主批准后才能通信；详细操作见房间指南。

5. 使用虚拟 IP

等待对端连接后，从设备列表或房间详情获取对端在当前网络中的虚拟 IP。下面以房间内的演示地址 10.21.0.5 为例，请替换为实际地址：

ping 10.21.0.5
ssh user@10.21.0.5

游戏服务器、NAS、Web 面板或数据库同理：连接对端虚拟 IP 和对应业务端口。登录成功、设备在线或出现 Direct/Relay 标签都不能单独证明业务可达，应实际验证目标服务。

6. 查看连接路径

客户端会显示对端当前使用的路径。遇到问题时，可先运行：

p2wlan status --json
p2wlan doctor
p2wlan route verify
p2wlan logs -f

p2wlan support-bundle 可生成本地诊断包；只有确认接收方、内容和保存期限后，才显式添加 --upload 上传。更多操作见客户端指南、CLI 参考和排障指南。

工作方式

P2WLAN 将连接控制和数据传输分开：

• Control Plane：身份、设备、虚拟 IP、凭据和信令。
• Rust daemon：虚拟网卡、路由、Peer、NAT traversal、加密数据面和路径选择。
• Relay：只在 Direct 不可用时参与，负责转发密文。

flowchart LR
    A[设备 A] <-->|"LAN Direct / UDP P2P"| B[设备 B]
    A -->|"认证 / 信令"| C[Control Plane]
    B -->|"认证 / 信令"| C
    A -.->|"Direct 不可用"| R[Encrypted Relay]
    R -.-> B

连接策略可以概括为：

LAN Direct → IPv6 / IPv4 UDP Direct → Encrypted Relay

默认先保留 5 秒直连窗口，同时准备 Relay；窗口结束后可使用已确认的加密 Relay。已建立的 Direct 失活时允许 Relay 兜底，并继续尝试恢复直连。具体路径受 NAT、CGNAT、防火墙和云安全组影响，详见路径策略。

连接状态

技术架构

P2WLAN 使用自包含的 WireGuard-like Noise 数据面，并使用 X25519、ChaCha20-Poly1305、BLAKE2s 等密码学组件。P2WLAN 不是官方 WireGuard 实现，也不声明 WireGuard 互操作兼容。

自托管

Control Plane 和 Relay 位于 server/。固定服务端发布包使用 server-vX.Y.Z 标签，公开安装与升级路径为 Linux + systemd；普通部署不需要在服务器上安装 Go 或 Node.js。

部署需要可信的 Control HTTPS/WSS 入口、Relay TLS 入口、持久化数据库和匹配的认证配置。仅启动服务端不会使服务器自动成为虚拟网络节点；需要作为节点时，还应安装并连接客户端。

• 自托管指南：固定版本安装、配置、TLS、管理台与 Docker Compose 边界。
• 升级与恢复：备份、升级、恢复与回滚。
• 运维指南：服务管理、健康检查、日志与证书。

安全边界

• 设备业务流量通过端点间的加密数据面传输。
• Relay 转发密文，不负责解密业务载荷。
• Relay 仍可能观察连接相关元数据，例如节点标识、时间和数据包大小。
• 不保证任意 NAT 环境都能建立 P2P 直连；Relay 可用性同样依赖 Control Plane 和 Relay 可达。

凭据边界和安全限制见 SECURITY.md、隐私说明 与安全模型；发布资产对应关系见发布契约。

开发者

Flutter 开发和发布统一使用 Flutter 3.47.2 / Dart 3.13.2，仓库根目录 .fvmrc 是本地 FVM、CI 和发布流水线的版本来源。

仓库按职责拆分：

• apps/flutter_client/ — Flutter 客户端
• client/daemon/ — Rust daemon
• client/cli/ — Rust CLI
• client/tun/ — TUN / 虚拟网卡抽象
• client/crypto/ — 加密组件
• server/ — Go Control Plane
• server/relay/ — Go Relay

构建、检查与贡献约定见 CONTRIBUTING.md，完整文档入口见 docs/README.md。实现细节请优先以源码、测试和 CI 为准。

License

MIT