LumaTunnel（光隧）
自托管的安全网络通道
LumaTunnel 是一个面向个人多设备的 Windows 代理系统。客户端在本机提供 HTTP/HTTPS CONNECT 与 SOCKS5 TCP 代理，并通过一个受信任 TLS 证书保护的 WSS 会话，将多个 TCP 流复用到自建 Windows Server 节点。
当前实现
- .NET 10、中央包管理、Nullable 与静态分析。
- WinUI 3 客户端，参考 AipcSystem 的
Views / ViewModels / Interface / Implements / Profiles分层。 - HTTP 绝对 URI 转发、HTTP CONNECT 和 SOCKS5 IPv4/IPv6/域名 TCP CONNECT。
- 规则、全局和直连模式；本地、私网、链路本地目标强制直连。
lumatunnel.v112 字节二进制帧协议与单 WSS 多路复用。- ServerInteractive
3.2.2控制 API 与 CyberComm 原始 WebSocket 事件共用 HTTP.sys 监听。 - 一次性配对码、256 位设备令牌、服务端 SHA-256 摘要、客户端 DPAPI CurrentUser。
- Windows Service CLI、HTTP.sys TLS/URL ACL、防火墙与恢复策略配置。
- 系统代理快照、外部修改保护、父进程/命名管道 Watchdog 恢复。
- x64/ARM64 客户端、win-x64 服务端和 WPF 安装器发布脚本。
v1 明确不支持 TUN、UDP、HTTPS 解密、第三方订阅、移动端和自动更新。
仓库结构
src/LumaTunnel.Shared 公共模型与帧协议
src/LumaTunnel.Server.Core 配对、设备、目标策略和隧道服务端
src/LumaTunnel.Server Worker Service 与管理 CLI
src/LumaTunnel.Client.Core 路由、隧道及本地代理核心（无 WinUI 依赖）
src/LumaTunnel.Client WinUI 3 客户端
src/LumaTunnel.Client.Watchdog 崩溃后的系统代理恢复
src/LumaTunnel.Client.Installer 当前用户安装器
tests/ 单元、集成与端到端测试
构建
要求 Windows 10 1809+、.NET SDK 10.0.3xx 与 Windows 10/11 SDK。
dotnet restore LumaTunnel.slnx
dotnet build LumaTunnel.slnx -p:Platform=x64
dotnet test LumaTunnel.slnx -p:Platform=x64 --no-build
开发配置默认只监听 http://localhost:3300/，避免在构建后意外占用 443。正式安装命令会写入 https://+:443/：
LumaTunnel.Server.exe service install --host node.example.com --thumbprint CERTIFICATE_SHA1
LumaTunnel.Server.exe pair create --ttl 10m
然后在客户端“节点”页输入 https://node.example.com 和配对码。
文档
发布
.\tools\publish-client.ps1 -Architecture x64 -Version 0.1.0-alpha
.\tools\publish-client.ps1 -Architecture arm64 -Version 0.1.0-alpha
.\tools\publish-server.ps1 -Version 0.1.0-alpha
.\tools\package-release.ps1 -Version 0.1.0-alpha
发布产物写入 artifacts/，该目录不提交 Git。