2c2a Tunnel

边缘代理 — Windows 服务 + WSS 客户端 + 多路复用
部署在被管 Windows 主机上的轻量级隧道代理

---

⚠️ 仓库已归档

本仓库已停止维护并归档。所有功能（WSS 客户端、Windows 服务、远程执行等）已合并至 gateway 仓库，隧道客户端源码现位于 gateway/cmd/tunnel/ 目录。

请前往 👉 gateway 获取最新代码和文档。

---

架构概览

2c2a-tunnel 运行在被管的 Windows 主机上，通过 WSS 隧道连接到 Gateway，提供：

通道	代码	说明
RDP	0x01	转发到 localhost:3389
WinRM	0x02	转发到 localhost:5986
RemoteExec	0x03	PowerShell 远程执行
Control	0xFF	心跳 + 控制信令

安装流程

安装为 Windows 服务

2c2a-tunnel.exe install \
  -token <TOKEN> \
  -server wss://gateway.example.com:9000

安装后自动：

• 创建 Windows 服务（2c2a Edge Service）
• 设置开机自启（Auto Start）
• 写入配置到 C:\ProgramData\2c2a\tunnel.yaml
• 立即启动服务

查看版本

2c2a-tunnel.exe version

卸载

2c2a-tunnel.exe uninstall

项目结构

tunnel/
├── cmd/tunnel/
│   ├── main.go              # CLI 入口 (install/run/uninstall/version)
│   ├── install.go           # 安装逻辑
│   ├── run.go               # 运行服务
│   ├── client.go            # WSS 客户端 + 自动重连 + 心跳
│   ├── config.go            # YAML 配置
│   ├── remote_exec.go       # 远程 PowerShell 执行
│   ├── service_windows.go   # Windows 服务 API (build tag: windows)
│   └── service_other.go     # 非 Windows 桩文件
├── .github/workflows/
│   └── build-windows.yml    # CI/CD 自动打包
├── docs/
│   ├── architecture.svg     # 架构图
│   └── installation-flow.svg # 安装流程图
├── go.mod
└── go.sum

CI/CD 自动打包

当推送 tunnel/v* 格式的 tag 时，GitHub Actions 自动构建：

git tag tunnel/v1.0.0
git push origin tunnel/v1.0.0

自动生成：

• 2c2a-tunnel-windows-amd64.exe
• 2c2a-tunnel-windows-arm64.exe
• checksums-sha256.txt
• GitHub Release（含版本说明）

安全特性

• Ed25519 密钥交换：每次连接自动生成临时密钥对，公钥发送给 Gateway
• Token 认证：每个主机使用唯一 Token，由 2c2a 平台生成
• TLS 加密：WSS 连接全程 TLS 加密
• 签名验证：RemoteExec 支持命令签名验证（防篡改）
• SYSTEM 权限：以 Windows 服务运行，拥有完整系统权限

设计要点

• 自动重连：指数退避策略（1s → 2s → 4s → ... → 60s max）
• 心跳保活：30s 间隔发送 Control 帧，90s 超时
• 多路复用：单条 WSS 连接承载 RDP/WinRM/RemoteExec 三种通道
• 纯静态编译：CGO_ENABLED=0，无外部依赖

配置文件

C:\ProgramData\2c2a\tunnel.yaml：

token: "your-tunnel-token"
server: "wss://gateway.example.com:9000"
rdp_port: "127.0.0.1:3389"
winrm_port: "127.0.0.1:5986"

许可证

AGPL-3.0 License - 查看 LICENSE 文件了解详情。