yhan-sun/p2wlan

Dernière activité source enregistrée: 14 septembre 2026 à 13:47

Catalogue SkillsMP mis à jour: 12 novembre 2026 à 12:52

skills collectés: 1

Étoiles GitHub: 3 415
Forks GitHub: 167

Installer avec un assistant IA

Copiez ce prompt dans l’assistant IA que vous utilisez.

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/yhan-sun/p2wlan.

README du dépôt

Fichier source du README : README.md

Lire le README source

Afficher le README complet

<div align="center"> <h1>P2WLAN</h1> 让异地设备像在同一局域网中一样互联。 异地联机 · 远程访问 · P2P 直连优先 · 加密中继 · 免费开源 · 可自托管 <a href="README.md">简体中文</a> · <a href="README.en.md">English</a> <a href="https://github.com/yhan-sun/p2wlan/releases">下载正式发布版</a> · <a href="#快速开始">快速开始</a> · <a href="#为什么选择-p2wlan">为什么选择 P2WLAN</a> · <a href="#与同类软件对比">同类软件对比</a> · <a href="#界面预览">界面预览</a> · <a href="#适用场景">适用场景</a> · <a href="#工作方式">工作方式</a> · <a href="#自托管">自托管</a> · <a href="#社区交流">社区交流</a> <a href="https://github.com/yhan-sun/p2wlan/releases"><img src="https://img.shields.io/github/v/release/yhan-sun/p2wlan?display_name=tag&label=release" alt="Latest release" /></a> <a href="https://github.com/yhan-sun/p2wlan/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/yhan-sun/p2wlan/ci.yml?branch=main&label=CI" alt="CI" /></a> <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="MIT License" /></a> <a href="https://trendshift.io/repositories/239992"><img src="https://trendshift.io/api/badge/trendshift/repositories/239992/daily?language=Rust" width="250" height="55" alt="P2WLAN · Trendshift Rust 日榜" /></a> <a href="https://trendshift.io/repositories/239992"><img src="https://trendshift.io/api/badge/trendshift/repositories/239992/weekly?language=Rust" width="250" height="55" alt="P2WLAN · Trendshift Rust 周榜" /></a> </div> <img src="assets/readme/hero.webp" width="100%" alt="P2WLAN — 让异地设备像在同一局域网中一样互联" /> ## P2WLAN 是什么 P2WLAN 是面向游戏联机、远程访问和跨地域组网的**免费开源虚拟局域网软件**。和朋友一起玩 Minecraft、在外访问家里的 NAS、连接远端开发机，都可以通过一张私有虚拟网络完成。支持 **Windows、macOS、Linux 和 Android**，提供图形客户端与适合服务器的 CLI。 P2WLAN 为参与设备分配私有虚拟 IP，优先建立 **局域网 / IPv6 / IPv4 UDP 直连**；直连不可用时自动使用**端到端加密中继**。应用继续访问同一个虚拟 IP，无需为每项服务单独配置公网端口或动态域名。 **现在开始：** [下载客户端](https://github.com/yhan-sun/p2wlan/releases) → 使用管理员提供的 Control 地址，或[部署自己的服务](docs/guides/self-hosting.md) → 登录并连接个人网络或房间 → 使用虚拟 IP 联机、访问服务。 ## 为什么选择 P2WLAN - **朋友联机，用一个房间组织。** 房间号、邀请、成员和设备管理集中在客户端；游戏、协作和维护环境各自使用独立网络。 - **直连优先，减少中继绕行。** 同一局域网直接通信，跨网络自动尝试 IPv6 和 UDP 打洞；直连成功后，业务流量无需消耗中继服务器带宽。 - **复杂网络也有连接后备。** 直连暂不可用时自动回退加密 Relay；网络条件改善后继续尝试恢复直连，应用沿用虚拟 IP。 - **远程服务共用一张私网。** SSH、RDP、NAS、Web 面板和游戏服务器按虚拟 IP 与服务端口访问，便于集中管理自己的设备。 - **连接路径看得见。** 客户端展示在线设备、Direct / Relay、延迟和收发信息，遇到问题可使用内置诊断定位。 - **软件免费，基础设施自己掌握。** MIT 许可开放客户端、Control 和 Relay 源码；可自行选择服务位置、管理账号与数据。自托管的服务器、带宽和域名费用由部署者承担。 ## 赞助商 <table> <tr> <td width="220" valign="middle"><a href="https://www.moeflux.com/zh-CN/plan?AFF=INV-BFD8315B"><img src="assets/readme/moeflux.webp" alt="Moeflux" width="200" /></a></td> <td>感谢 Moeflux 赞助本项目！Moeflux 是一家面向重度 AI 开发者的官方直连高品质模型 API 中转服务商，专注提供 Grok 系列、Claude 系列、Codex 系列与 DeepSeek 系列等模型。100% 官方源直供，不掺假、不注水，欢迎随时检验。价格显著低于同行，倍率低至 0.1折，稳定性高，支持企业级高并发，计费透明，Token 级账单可逐笔核验。为企业客户提供专业管理平台，支持签订正式合同并可开发票。现在通过<a href="https://www.moeflux.com/zh-CN/plan?AFF=INV-BFD8315B">此链接</a>下单即可获赠 $1 额度。</td> </tr> </table> ## 界面预览 <table align="center"> <tr> <td align="center" width="50%"> <img src="assets/readme/screenshot-home.webp" width="100%" alt="P2WLAN 首页：网络状态和在线设备" /> 首页 · 网络状态与在线设备 </td> <td align="center" width="50%"> <img src="assets/readme/screenshot-devices.webp" width="100%" alt="P2WLAN 设备列表：节点、连接速率和在线状态" /> 设备 · 节点、速率与在线状态 </td> </tr> <tr> <td align="center" width="50%"> <img src="assets/readme/screenshot-rooms.webp" width="100%" alt="P2WLAN 互联页面：多房间管理和连接延迟" /> 互联 · 房间管理与连接延迟 </td> <td align="center" width="50%"> <img src="assets/readme/screenshot-room.webp" width="100%" alt="P2WLAN Minecraft 房间详情：虚拟 IP、连接路径和延迟" /> 房间详情 · 虚拟 IP、连接路径与延迟 </td> </tr> </table> 从全局网络状态、设备在线情况，到多房间管理、连接方式和端到端延迟，常用信息可以直接在客户端里看到。设备名称和截图数据均为演示数据。 ## 适用场景 P2WLAN 提供一张跨地域的虚拟三层网络。应用通过对端的虚拟 IP 和业务端口通信；目标服务需要监听可访问的地址，并允许对应的防火墙流量。 | 场景 | 可以怎么用 | | --- | --- | | **NAS / HomeLab** | 在外网访问运行 P2WLAN 的 NAS、家庭服务器或虚拟机上的服务，不必逐个暴露公网端口。 | | **Minecraft 联机** | 把朋友的电脑加入同一房间，直接使用虚拟 IP 访问自建 Minecraft 服务器。 | | **Terraria 联机** | 将不同网络中的玩家组织到同一虚拟网络，进行多人联机。 | | **自建服务器** | 访问 Web 应用、API、数据库、面板、游戏服以及仅希望在私网开放的服务。 | | **远程开发** | SSH、RDP、数据库连接、开发测试机互联，以及跨地区设备调试。 | | **跨地域组网** | 家庭宽带、移动热点、校园网、云主机和不同云厂商之间互联。 | 安装 P2WLAN 不会自动把所在家庭或办公网络中的其他设备接入虚拟网络。上面的访问示例以目标设备也运行 P2WLAN 为前提。 ### 房间：把“我要和谁互联”单独组织起来房间适合需要独立边界的临时或固定网络：例如一个 Minecraft 生存服、一次朋友联机、一组 NAS 维护设备，或者一个开发测试环境。客户端可以集中查看房间成员、在线状态、虚拟 IP、当前连接路径和延迟，不需要把所有设备混在同一个列表里。 ## 与同类软件对比 ### 功能、优势与使用取舍 | 软件 | 主要优势 | 使用取舍 | | --- | --- | --- | | **P2WLAN** | 房间式联机、图形客户端、直连优先与加密 Relay 一体提供；客户端和服务端均以 MIT 许可开源，适合朋友联机、NAS 与远程开发。 | 需要管理员提供 Control 或自行部署；采用三层 TUN 网络，参与设备需要安装客户端，应用使用虚拟 IP 访问，不提供以太网二层广播桥接。 | | **Tailscale** | 托管控制面、WireGuard 数据面、访问策略与设备管理，适合个人远程访问和组织内访问控制。 | 使用官方服务或另行部署 Headscale；Headscale 的功能范围需单独核对；双端 hard NAT 无法直连时使用 Peer Relay / DERP。 | | **ZeroTier** | 虚拟以太网与二层桥接能力，适合需要二层网络语义或物理网络整合的场景；可自建网络控制器。 | 需要配置网络成员、授权和规则；桥接物理局域网需额外配置；对称 NAT、多层 NAT 与严格过滤可能使流量走中继。 | | **EasyTier** | 去中心化 mesh、多协议传输、子网代理和自动路由；官方说明支持 NAT4↔NAT4 打洞。 | 各节点需要统一网络标识和密钥，选择可达入口；多节点中继、子网与协议配置由部署者按拓扑管理。 | **如果你希望用图形界面把朋友、家庭设备和开发机组织进独立房间，同时掌握自己的 Control 与 Relay，P2WLAN 很适合这类需求。** ### 两端 NAT 类型：打洞支持速查 **按行找本端、按列找对端，看交叉格即可。** 下表展示 P2WLAN 在经典 NAT 行为下的 IPv4 UDP 打洞路径，前提是两端可联系同一 Control、UDP 未被阻断、公网 IP 稳定、映射仍有效，且主机防火墙允许通信。 **🟢 常规支持**：常规 UDP 探测与经认证的源地址学习可建立直连路径。**🟡 条件支持**：需要结合实测端口规律、过滤规则与协调探测；条件不满足时自动使用可达的 Relay。标记表示支持路径，不是成功率或成功保证。 | 本端 ↓ / 对端 → | 全锥形 | 受限锥形 | 端口受限锥形 | 对称 NAT | | --- | --- | --- | --- | --- | | **全锥形** | 🟢 常规 | 🟢 常规 | 🟢 常规 | 🟢 常规 | | **受限锥形** | 🟢 常规 | 🟢 常规 | 🟢 常规 | 🟢 常规 | | **端口受限锥形** | 🟢 常规 | 🟢 常规 | 🟢 常规 | 🟡 条件 | | **对称 NAT** | 🟢 常规 | 🟢 常规 | 🟡 条件 | 🟡 双端条件 | | NAT 类型 | 映射与入站规则 | 对打洞的影响 | | --- | --- | --- | | **全锥形（Full Cone）** | 同一本地端口使用稳定公网映射；映射存在时接收入站包，不限制来源。 | 对称 NAT 一端可向该稳定入口发包，对端学习实际源地址并回包。 | | **受限锥形（Restricted Cone）** | 公网映射稳定；只接收本端已发包目标 IP 的入站包，不限定其源端口。 | 先向对端公网 IP 发包后，可接收对称 NAT 改变源端口的探测包。 | | **端口受限锥形（Port Restricted Cone）** | 公网映射稳定；入站源 IP 和端口必须与本端已发包的目标一致。 | 与锥形 NAT 可互相开放映射；与对称 NAT 组合时需要找到实际目标端口。 | | **对称 NAT（Symmetric）** | 公网映射随目标变化；经典模型只允许已访问的目标 IP 和端口回包。 | 两端均为此类时，需要协调两端的实际映射与过滤窗口。 | **P2WLAN 不会仅凭“对称 NAT”标签放弃直连。** 对条件组合，客户端按实测能力选择端口预测、固定锚或有界生日探测；双端高熵随机映射叠加严格过滤时优先保障 Relay 通信，并在出现新的直连证据时尝试恢复直连。中继可用性取决于 Relay 是否配置且可达。 | 其他网络条件 | 连接路径 | | --- | --- | | 一端有可达公网 IPv4，UDP 与防火墙放行 | 另一端可主动连接该公网入口，无需两端同时预测 NAT 端口。 | | 两端公网 IPv6 可达，UDP 与防火墙放行 | 优先尝试 IPv6 直连，绕过 IPv4 NAT。 | | IPv4 UDP 被阻断，且无其他可用直连路径 | 🔴 无法通过该 UDP 路径打洞，使用可达的 TLS Relay。 | 多层 NAT、CGNAT、校园网和移动网络描述的是部署环境，不能单独决定矩阵中的类型。上表使用 [RFC 3489 的经典名称](https://www.rfc-editor.org/rfc/rfc3489#section-5)帮助理解；实际策略按 [RFC 4787 的映射与过滤行为](https://www.rfc-editor.org/rfc/rfc4787)分别测量，不把各软件的 NAT1–NAT4 编号当作统一标准。详细规则见[网络文档](docs/reference/networking.md)。 ### 打洞成功率：按网络条件比较打洞成功率取决于**两端的映射与过滤规则、UDP 可达性、端口分配、重试时间和网络负载**。本对比未提供四款软件在同一组真实网络、明确版本和同一观测窗口下的横向实测数据，因此下表比较已实现或官方说明的连接策略，不作为成功率排名。 | 网络条件 | P2WLAN | Tailscale | ZeroTier | EasyTier | | --- | --- | --- | --- | --- | | 常见家庭 NAT，UDP 可双向通信 | 自动 UDP 打洞 | 自动 NAT 穿透 | 自动 UDP 打洞 | 自动 UDP 打洞 | | 双端受限 NAT，含目的相关映射与严格过滤 | 按测量选择端口预测、固定锚或生日探测；结果取决于端口规律与过滤 | 官方说明双端 hard NAT 无法建立直连，使用中继 | 官方指出对称 NAT 不利于 P2P，可能使用中继 | 官方声明支持 NAT4↔NAT4；具体映射与过滤组合需实测 | | 两端公网 IPv6 可达，防火墙允许 UDP | IPv6 直连 | IPv6 直连 | IPv6 直连 | IPv6 直连 | | UDP 被阻断，转发入口仍可达 | TLS 加密 Relay | DERP / 可达的 Peer Relay | TCP fallback | 按配置使用 TCP / WSS 等可达节点转发 | **P2WLAN 的连接优势是直连优先、多策略探测与自动回退的组合。** 高熵随机映射叠加严格过滤时仍可能需要 Relay；两端公网 IPv6 直连属于绕过 IPv4 NAT，不计入 IPv4 打洞成功率。使用 Relay 时，延迟和吞吐受中继位置、线路与带宽影响。需要实测时，将 **UDP 打洞成功率**（在规定时间内经 IPv4 NAT 打洞建立双向业务的轮次 / 全部打洞轮次）、**总体直连率**（含 LAN / IPv6）与**业务可用率**（含 Relay）分别统计，并报告失败轮次、首次可用时间、RTT 和吞吐，避免把中继连通算作打洞成功。[网络规则](docs/reference/networking.md)与[路径观测](docs/reference/path-observability.md)说明 P2WLAN 的验证口径。对比依据：[Tailscale 连接类型](https://tailscale.com/docs/reference/connection-types)、[访问策略](https://tailscale.com/docs/features/access-control/acls)、[Headscale](https://github.com/juanfont/headscale)、[ZeroTier 路由建议](https://docs.zerotier.com/routertips/)、[协议与虚拟以太网](https://docs.zerotier.com/protocol/)、[自建控制器](https://docs.zerotier.com/controller/)、[EasyTier 官方说明](https://github.com/EasyTier/EasyTier)。功能与条件以各项目当前文档为准。 ## 快速开始 **先准备 Control 地址。** 新安装不预填项目运营的 Control 或 Relay，也不会自动注册账号。请向管理员获取可信的 Control 地址，或先完成[自托管部署](docs/guides/self-hosting.md)。需要互联的设备应使用同一个 Control；不同账号之间通过同一房间互联。 ### 1. 下载前往 [GitHub Releases](https://github.com/yhan-sun/p2wlan/releases)，选择客户端 **`vX.Y.Z`** 发布中的对应平台文件。服务端 **`server-vX.Y.Z`** 是独立发布，不是客户端安装包。 | 平台 | Release 文件 | 状态 | | --- | --- | --- | | macOS 12+ Apple Silicon | `p2wlan-macos-arm64.dmg` | 支持 | | macOS 12+ Intel | `p2wlan-macos-x64.dmg` | 支持 | | Windows x64 | `p2wlan-windows-x64-setup.exe` | 支持 | | Linux x64 | `p2wlan-linux-x64.tar.gz`（GUI） / `p2wlan-linux-x64-cli.tar.gz`（CLI + daemon） | 支持 | | Linux arm64 | `p2wlan-linux-arm64-cli.tar.gz`（CLI + daemon） | 支持 | | OpenWrt ARM64 / x86_64 | 24.10 `.ipk` / 25.12 `.apk`（CLI + daemon） | [安装指南](docs/guides/openwrt.md) | | Android 7.0+ (API 24+) arm64 | `p2wlan-android-arm64-release.apk` | 支持 | Linux 无桌面环境选择 CLI 包，也可使用固定版本安装脚本。把 `vX.Y.Z` 替换为实际客户端 Release 标签： ```bash 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 使用： ```bash p2wlan config set control https://control.example.com ``` ### 3. 注册／登录在客户端注册账号或登录已有账号。CLI 登录已有账号： ```bash p2wlan login -u your-name p2wlan account show ``` 没有账号时，使用 `p2wlan register -u you@example.com` 注册并保存登录状态；注册需要邮箱，登录可使用邮箱或已设置的用户名。密码由终端提示输入。配置和登录命令使用普通用户执行，不要加 `sudo`。 ### 4. 连接设备 **自己的设备互联：** 在各设备上登录同一账号，完成首次设置并启动个人网络。CLI 使用： ```bash p2wlan up p2wlan status ``` **与朋友或其他账号互联：** 各设备使用同一个 Control，在客户端创建房间或通过房间号／邀请加入，再点击房间中的“连接本机”。加入房间只建立成员关系，不会自动启动本机网络。 CLI 房主先用 `p2wlan room create --name my-room` 创建房间，按提示设置房间密码，并将房间号交给其他成员。其他成员加入后，房主和成员都需要连接该房间： ```bash # 成员加入：将 12345678 替换为实际的 8 位房间号，按提示输入房间密码 p2wlan room join --code 12345678 # 房主和成员：查看房间，并连接本机 p2wlan room list p2wlan room connect 12345678 p2wlan room show 12345678 ``` 房间使用独立的网络和虚拟 IP。`p2wlan up` 启动个人网络，不能代替 `p2wlan room connect`。设备可能需要房主批准后才能通信；详细操作见[房间指南](docs/guides/rooms.md)。 ### 5. 使用虚拟 IP 等待对端连接后，从设备列表或房间详情获取对端在当前网络中的虚拟 IP。下面以房间内的演示地址 `10.21.0.5` 为例，请替换为实际地址： ```bash ping 10.21.0.5 ssh user@10.21.0.5 ``` 游戏服务器、NAS、Web 面板或数据库同理：连接对端虚拟 IP 和对应业务端口。登录成功、设备在线或出现 Direct/Relay 标签都不能单独证明业务可达，应实际验证目标服务。 ### 6. 查看连接路径客户端会显示对端当前使用的路径。遇到问题时，可先运行： ```bash p2wlan status --json p2wlan doctor p2wlan route verify p2wlan logs -f ``` `p2wlan support-bundle` 可生成本地诊断包；只有确认接收方、内容和保存期限后，才显式添加 `--upload` 上传。更多操作见[客户端指南](docs/guides/client.md)、[CLI 参考](docs/reference/cli.md)和[排障指南](docs/guides/troubleshooting.md)。 ## 工作方式 P2WLAN 将连接控制和数据传输分开： - **Control Plane**：身份、设备、虚拟 IP、凭据和信令。 - **Rust daemon**：虚拟网卡、路由、Peer、NAT traversal、加密数据面和路径选择。 - **Relay**：只在 Direct 不可用时参与，负责转发密文。 ```mermaid 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、防火墙和云安全组影响，详见[路径策略](docs/reference/configuration.md#客户端路径策略)。 ## 连接状态 | 状态 | 含义 | | --- | --- | | **LAN Direct** | 通过本地网络直接通信。 | | **Direct** | 通过公网 UDP 建立 P2P 直连。 | | **Relay** | 通过 Relay 转发加密数据。 | | **Connecting** | 正在建立或确认连接路径。 | | **Offline** | 对端离线或当前没有可用路径。 | ## 技术架构 | 模块 | 技术 | 职责 | | --- | --- | --- | | GUI | Flutter | 登录、设备 / 房间管理、连接状态与诊断。 | | Data Plane / Daemon | Rust | TUN、路由、Peer、NAT traversal、加密会话与 Relay fallback。 | | Virtual interface | macOS `utun` / Windows Wintun / Linux TUN | 为应用提供普通的三层虚拟网络接口。 | | Control Plane | Go + SQLite | 认证、设备注册、虚拟 IP、凭据、信令和 Relay 信息。 | | Relay | Go | Relay 连接、票据校验和密文转发。 | P2WLAN 使用自包含的 **WireGuard-like Noise** 数据面，并使用 X25519、ChaCha20-Poly1305、BLAKE2s 等密码学组件。**P2WLAN 不是官方 WireGuard 实现，也不声明 WireGuard 互操作兼容。** ## 自托管 Control Plane 和 Relay 位于 [`server/`](server/)。固定服务端发布包使用 **`server-vX.Y.Z`** 标签，提供 Linux 原生 systemd 安装与 Docker Compose 部署。Docker 默认从已校验的发布源码包构建，Node.js 和 Go 构建均在容器中完成，宿主机无需安装它们。登录 Linux 服务器后，复制下面一整行即可开始交互部署，无需 clone 仓库或手动下载部署包： ```sh curl -fsSL https://raw.githubusercontent.com/yhan-sun/p2wlan/main/scripts/bootstrap-server.sh | sudo bash ``` 运行后按以下顺序完成向导： 1. 首屏选择 `1` 直接安装到系统、`2` Docker 部署（默认），或 `0` 退出。 2. 检查并确认安装所选方式的缺失依赖；直接安装使用 systemd，Docker 方式准备 Engine、Compose 和 Buildx。 3. 从该方式可用的正式版本列表选择版本，或手动输入固定 `server-vX.Y.Z`，再下载校验发布包。 4. 确认安装、配置和数据目录，再选择公网部署或本机测试；已有部署进入保留配置的升级分支。 5. 公网部署填写 Relay 域名或 IP、端口、证书链和私钥路径，再确认内部端口；Docker 方式还可选择 Relay 绑定地址。 6. 选择立即启动或只准备，检查完整摘要；可确认、重新填写或取消。 7. 确认后，直接安装使用已校验的二进制；Docker 使用 Compose 构建同版本源码中的管理台和服务端，以核验后的本地镜像 ID 启动。新部署自动生成配套配置，选择启动时等待健康检查，最后显示入口、凭据文件位置和管理命令。已有配置、凭据和数据库会保留；升级时重新运行同一条命令并选择新版本。Docker 源码保存在持久部署目录，构建可复用 Docker 缓存；首次构建通常比拉取预构建镜像慢。若所选 Release 另有预构建镜像资产，可将命令末尾的 `sudo bash` 换成 `sudo bash -s -- --method docker --docker-mode image --interactive`，显式选择镜像部署。管理台令牌不打印到终端。详细字段、默认值和终端示例见[完整交互流程](docs/guides/self-hosting.md#完整交互流程)。入口需要 `curl`、`sudo`，以及已发布的引导脚本和所选方式的服务端 Release；root 终端可去掉 `sudo`。自动准备环境支持 Ubuntu 22.04 / 24.04 / 26.04、Debian 12 / 13 的 amd64 / arm64 systemd 主机。公网部署前准备好 Relay 可信证书和 Control HTTPS/WSS 反向代理；固定版本命令、路径选项和其他 Linux 环境见[自托管指南](docs/guides/self-hosting.md)。部署需要可信的 Control HTTPS/WSS 入口、Relay TLS 入口、持久化数据库和匹配的认证配置。仅启动服务端不会使服务器自动成为虚拟网络节点；需要作为节点时，还应安装并连接客户端。 - [自托管指南](docs/guides/self-hosting.md)：固定版本安装、配置、TLS、管理台与 Docker Compose 边界。 - [升级与恢复](docs/guides/upgrade-and-recovery.md)：备份、升级、恢复与回滚。 - [运维指南](docs/guides/operations.md)：服务管理、健康检查、日志与证书。 ## 安全边界 - 设备业务流量通过端点间的加密数据面传输。 - Relay 转发密文，不负责解密业务载荷。 - Relay 仍可能观察连接相关元数据，例如节点标识、时间和数据包大小。 - 不保证任意 NAT 环境都能建立 P2P 直连；Relay 可用性同样依赖 Control Plane 和 Relay 可达。凭据边界和安全限制见 [SECURITY.md](SECURITY.md)、[隐私说明](PRIVACY.md) 与[安全模型](docs/explanation/security-model.md)；发布资产对应关系见[发布契约](docs/reference/release-contract.md)。 ## 开发者 Flutter 开发和发布统一使用 **Flutter 3.47.2 / Dart 3.13.2**，仓库根目录 `.fvmrc` 是本地 FVM、CI 和发布流水线的版本来源。仓库按职责拆分： - [`apps/flutter_client/`](apps/flutter_client/) — Flutter 客户端 - [`client/daemon/`](client/daemon/) — Rust daemon - [`client/cli/`](client/cli/) — Rust CLI - [`client/tun/`](client/tun/) — TUN / 虚拟网卡抽象 - [`client/crypto/`](client/crypto/) — 加密组件 - [`server/`](server/) — Go Control Plane - [`server/relay/`](server/relay/) — Go Relay 构建、检查与贡献约定见 [CONTRIBUTING.md](CONTRIBUTING.md)，完整文档入口见 [docs/README.md](docs/README.md)。实现细节请优先以源码、测试和 CI 为准。 ## 社区交流欢迎加入 QQ 群，交流使用体验、组网问题和功能建议。 P2WLAN 群 1 · 群号：616957753 <a href="assets/readme/qq-group.png"> <img src="assets/readme/qq-group.png" width="240" alt="P2WLAN QQ 群 1 加群二维码，群号 616957753" /> </a> 使用 QQ 扫码或搜索群号加入；点击图片查看原图。 ## License [MIT](LICENSE)

Chargement du README du dépôt…

Skills dans ce dépôt

Développeurs de logiciels

1 catégories métier · 100% classifié

skill

métier

description

mis à jour

p2wlan-repository

Développeurs de logiciels

Apply P2WLAN repository contracts when changing documentation, privacy boundaries, deployment tools, release workflows, recovery behavior, or AI maintenance rules.

Langue du texte source : anglais

2026-09-14

Affichage de 1 skills collectés sur 1.