Skip to content
VEY-OSSPublic

About

Modular proxy and gateway suite in Rust. Unifies HTTP/SOCKS forward, HTTP/TLS reverse, TPROXY/SNI transparent, and stream proxying with dynamic routing and TLS/ICAP inspection.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

52 stars

Watchers

2 watching

Forks

Latest commit

 

History

4,061 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

minimum rustc: 1.100 License: Apache 2.0 codecov docs

VEY banner

中文版 README | 日本語 README

About

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.

Applications

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.

vey-proxy

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.

Feature highlights

  • 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 OpenBSD pf
  • 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

vey-gateway

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.

README | Reference Doc

vey-keyless

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.

README | Reference Doc

vey-statsd

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.

README | Reference Doc

vey-bench

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

README

Companion Services and Utilities

vey-dcgen

A dynamic certificate generator companion service for vey-proxy TLS interception.

README | Reference Doc

vey-iploc

An IP geolocation lookup companion service for vey-proxy GeoIP routing.

README | Reference Doc

vey-mkcert

A CLI utility for generating root CA, intermediate CA, TLS server, TLS client, TLCP server, and TLCP client certificates.

README

Target Platforms

See Target Platforms.

Development Environment Setup

See Dev-Setup.

Standards

See Standards.

Build, Package and Deploy

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.

LTS Version

See Long-Term Support.

Community

Join the Larksuite (飞书) user group via this link or by scanning the QR code below:

Lark Group

Contribution

See Contributing for details.

Code of Conduct

See Code of Conduct for details.

Security

Please report security issues by opening a draft security advisory on GitHub.

Please do not create a public GitHub issue.

License

This project is licensed under the Apache-2.0 License.

About

Modular proxy and gateway suite in Rust. Unifies HTTP/SOCKS forward, HTTP/TLS reverse, TPROXY/SNI transparent, and stream proxying with dynamic routing and TLS/ICAP inspection.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

52 stars

Watchers

2 watching

Forks

Releases

Packages

Used by

Contributors

Languages