# LumaTunnel（光隧）

> 自托管的安全网络通道

LumaTunnel 是一个面向个人多设备的 Windows 代理系统。客户端在本机提供 HTTP/HTTPS CONNECT 与 SOCKS5 TCP 代理，并通过一个受信任 TLS 证书保护的 WSS 会话，将多个 TCP 流复用到自建 Windows Server 节点。

![LumaTunnel 图标](assets/app-icons/Wide310x150Logo.png)

## 当前实现

- .NET 10、中央包管理、Nullable 与静态分析。
- WinUI 3 客户端，参考 AipcSystem 的 `Views / ViewModels / Interface / Implements / Profiles` 分层。
- HTTP 绝对 URI 转发、HTTP CONNECT 和 SOCKS5 IPv4/IPv6/域名 TCP CONNECT。
- 规则、全局和直连模式；本地、私网、链路本地目标强制直连。
- `lumatunnel.v1` 12 字节二进制帧协议与单 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 解密、第三方订阅、移动端和自动更新。

## 仓库结构

```text
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。

```powershell
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/`：

```powershell
LumaTunnel.Server.exe service install --host node.example.com --thumbprint CERTIFICATE_SHA1
LumaTunnel.Server.exe pair create --ttl 10m
```

然后在客户端“节点”页输入 `https://node.example.com` 和配对码。

## 文档

- [隧道协议](docs/protocol.md)
- [Windows Server 部署](docs/deployment.md)
- [安全边界与威胁模型](docs/security.md)
- [测试与发布门槛](docs/testing.md)

## 发布

```powershell
.\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。

## 许可证

[MIT](LICENSE.txt)