GeniaProxy is a Windows network client and orchestration layer built around modern proxy engines such as sing-box and Xray-core.
The project focuses on reliable profile management, TUN networking, DNS/routing integration, engine lifecycle control, recovery behavior, and careful evaluation of new protocols and transports before they are promoted to stable builds.
Independent project notice
GeniaProxy is an independent project and is not affiliated with, sponsored by, or endorsed by SagerNet, the sing-box project, XTLS, or the Xray-core project. Third-party names and trademarks are used only to identify compatibility with their respective software.
Project status
- 4.4.x — stable baseline
- 4.5.x — active development / protocol and network lab
- Experimental engine, protocol, transport, and TUN features are evaluated separately before promotion to stable builds.
- Reliable Windows TUN and routing lifecycle
- Safe start/stop, restart, recovery, and rollback behavior
- Support for sing-box and Xray-core
- Reproducible portable builds
- Explicit separation of stable and experimental functionality
- Compatibility-focused testing for DNS, IPv4/IPv6, reconnect, sleep/wake, and profile switching
- Conservative adoption of new engine releases and network features
main— stable, reviewed statedevelop— integration branch for the next releasefeature/*— focused feature workfix/*— targeted fixesexperiment/*— protocol/engine experiments not considered production-ready
Release tags use the form vX.Y.Z. Pre-release tags should be explicit, for example v4.5.0-alpha.1.
The 4.5 development line is intended for controlled evaluation of new sing-box/Xray capabilities, TUN/network behavior, transport changes, security modes, and recovery improvements.
See docs/ROADMAP-4.5.0.md once the development documentation lands.
Never commit real server credentials, UUIDs, private keys, certificates, API tokens, passwords, production endpoints, or private configuration files.
Security-sensitive reports should be handled privately rather than published with exploitable details. See SECURITY.md.
Development conventions, branch naming, testing expectations, and pull-request guidance are documented in CONTRIBUTING.md.
No open-source license has been selected yet. Until a license is explicitly added, no permission is granted to copy, modify, or redistribute the source beyond what applicable law allows.
New sing-box/Xray releases and experimental protocol features are intentionally tested in isolated branches before adoption into the stable GeniaProxy line.