VEY is a modular suite of networking daemons and CLI tools written in Rust. Its general-purpose applications cover
unified forward/reverse/transparent/stream proxying with built-in security auditing (vey-proxy), TLS and Keyless SSL
gateway/private-key services (vey-gateway, vey-keyless), StatsD metrics aggregation and forwarding (vey-statsd),
and multi-protocol benchmarking (vey-bench), complemented by companion services (vey-dcgen, vey-iploc) and a
certificate utility (vey-mkcert), with load-balancing (TBD) and NAT traversal (WIP) planned.
This project is a fork of the G3 project by its creator.
If you are migrating an existing G3 deployment, see Migration from G3 to VEY.
The VEY project consists of multiple applications, each with its own subdirectory for code, documentation, and related assets.
In addition to the application directories, the repository also includes several shared directories:
- doc contains project-level documentation.
- sphinx contains the sources used to generate HTML reference documentation for each application.
- scripts contains helper scripts, including coverage and packaging utilities.
A modular proxy daemon written in async Rust. It unifies HTTP(S) and SOCKS4/5 forward proxying, HTTP and TLS reverse proxying, SNI and TPROXY transparent proxying, and TCP/UDP/TLS stream proxying in a single hot-reloadable binary—with built-in security auditing (TLS/TLCP interception, DPI, ICAP adaptation, stream detours, and decrypted-traffic export), programmable egress routing, per-user and per-site policies, and StatsD observability.
- Async Rust implementation with graceful hot reload and multi-worker scaling
- HTTP(S) and SOCKS4/5 forward proxy support, including HTTP CONNECT-UDP and SOCKS5 UDP ASSOCIATE
- SNI transparent proxy and TCP/UDP transparent proxying via Linux TPROXY, FreeBSD
ipfw, and OpenBSDpf - HTTP and TLS reverse proxying via site groups: HTTP/1, HTTP/2 over TLS, WebSocket, passive peer health checks, and per-site origins and tenant limits
- TCP/UDP/TLS stream proxying with PROXY Protocol support
- Built-in security auditing: task-level sampling, TLS/TLCP interception (with dynamic cert generation via
vey-dcgen), decrypted-traffic export, stream detours, and DPI for HTTP/1, HTTP/2, WebSocket, IMAP, and SMTP - ICAP (
REQMOD/RESPMOD) integration for content inspection, DLP, and application-layer adaptation - Proxy chaining and dynamic egress routing by client IP, target host, resolved IP, GeoIP, or external route-query agents
- Multi-stack TLS based on OpenSSL, BoringSSL, AWS-LC, AWS-LC-FIPS, Tongsuo (with TLCP), or rustls
- Pluggable authentication (local, LDAP, Lua, Python), ACLs, quotas, rate/bandwidth limits, and per-user site policies
- Structured task, inspect, and intercept audit logs (
journald,syslog,fluentd) plus StatsD metrics across ingress, egress, user, user-site, and reverse-proxy site dimensions
README | User Guide | Reference Doc
A work-in-progress general-purpose reverse proxy and gateway daemon. It is designed as a programmable gateway framework for multiple frontend and upstream protocols. The current implementation supports TLS- and keyless-related traffic handling.
A server implementation of the Cloudflare Keyless SSL protocol. It allows TLS edge services to delegate private-key operations to a dedicated backend service, making it easier to centralize key handling and integrate with OpenSSL-based hardware acceleration.
A StatsD-compatible metrics ingestion, aggregation, and forwarding service. It can receive metrics from application daemons, normalize or aggregate them through a modular pipeline, and export the results to downstream systems such as Graphite, OpenTSDB, Prometheus, InfluxDB, VictoriaMetrics, QuestDB, or OpenGemini.
A multi-protocol benchmark tool that supports:
- HTTP: HTTP/1.1, HTTP/2, HTTP/3
- WebSocket
- TLS Handshake
- DNS: UDP, TCP, DNS over TLS, DNS over HTTP, DNS over QUIC, DNS over HTTP/3
- Thrift RPC
- Cloudflare Keyless
A dynamic certificate generator companion service for vey-proxy TLS interception.
An IP geolocation lookup companion service for vey-proxy GeoIP routing.
A CLI utility for generating root CA, intermediate CA, TLS server, TLS client, TLCP server, and TLCP client certificates.
See Target Platforms.
See Dev-Setup.
See Standards.
Prebuilt packages are available on cloudsmith.
Container images for linux/amd64 and linux/arm64 are published to GHCR. <version> is the application release version,
such as 1.15.1. Debian is the default tag. :<version>-debian and :<version>-alpine select the base image.
| Application | Image | GitHub Packages |
|---|---|---|
| vey-proxy | ghcr.io/vey-oss/vey-proxy:<version> |
vey-proxy |
| vey-statsd | ghcr.io/vey-oss/vey-statsd:<version> |
vey-statsd |
| vey-dcgen | ghcr.io/vey-oss/vey-dcgen:<version> |
vey-dcgen |
| vey-iploc | ghcr.io/vey-oss/vey-iploc:<version> |
vey-iploc |
That said, building packages yourself is still recommended. See Build and Package for details.
See Long-Term Support.
Join the Larksuite (飞书) user group via this link or by scanning the QR code below:
See Contributing for details.
See Code of Conduct for details.
Please report security issues by opening a draft security advisory on GitHub.
Please do not create a public GitHub issue.
This project is licensed under the Apache-2.0 License.