Skip to content

Releases: LdotJdot/LumFrp

lumfrp server and client in one exe.

Choose a tag to compare

@LdotJdot LdotJdot released this 16 Jul 08:09

Release Notes

v1.0.0 — Initial Release

LumFRP is a .NET 10 Native AOT reverse-tunnel tool (frp-inspired design; not wire-compatible with official frp).

Highlights

  • Single binary — switch server/client with mode in lumfrp.json
  • TCP relay — HTTP, HTTPS, RDP, SSH, streaming APIs, gRPC, etc.
  • UDP relay — frp-style: one persistent work connection per proxy, multiplexed by public source address
  • TCP mux — control plane + work streams over one TLS connection (default on)
  • TLS required — server auto-generates ephemeral self-signed cert when no cert files are configured
  • Token auth — HMAC-SHA256 with replay protection
  • Port allowlist — server allowPorts restricts client remotePort
  • JSON config — comments and trailing commas supported
  • Cross-platform — Windows, Linux, macOS (BCL only; publish Native AOT on the target OS)

Requirements

  • Build / run: .NET 10 SDK
  • Native AOT publish: must run dotnet publish on the target OS (no cross-OS AOT)

Quick start

dotnet publish src/lumfrp -c Release -r win-x64 -o artifacts/lumfrp   # Windows
# linux-x64 / osx-arm64 / osx-x64 on Linux or macOS

cd artifacts/lumfrp
# edit lumfrp.json
./lumfrp          # or lumfrp.exe on Windows

See README.md for full configuration.

Known limitations

  • Relay-only (no P2P / NAT hole punching)
  • IPv4 transport only
  • Not compatible with official frp client or server
  • Privileged ports (<1024) on Linux/macOS may require root or cap_net_bind_service
  • Integration tests are primarily validated on Windows

Downloads

Build from source (no pre-built binaries in this repository yet).


v1.0.0 — 首次发布

LumFRP 是基于 .NET 10 Native AOT 的内网穿透工具(设计参考 frp,协议与官方 frp 不兼容)。

主要内容

  • 单二进制,单文件,通过mode 切换服务端/客户端
  • TCP / UDP 穿透,UDP 为 frp 式长连接多包复用
  • 强制 TLS、token 鉴权、allowPorts 端口白名单
  • JSON 配置支持注释与尾逗号
  • 跨平台(需在目标系统上 Native AOT 发布)

已知限制

  • 仅中继,无 P2P 打洞
  • 传输层仅 IPv4
  • 与官方 frp 不能混用
  • Linux/macOS 低端口可能需要 root 或 capability
  • 集成测试主要在 Windows 环境验证

完整说明见 README.md