fyntr 0.1.2 - Docs.rs

fyntr-0.1.2 has been yanked.

About

Fyntr (/ˈfɪn.tər/) is a minimal forward proxy with TLS passthrough, engineered in Rust, designed for simplicity. It includes no authentication or inspection capabilities. It was created to make bursty network workloads more predictable and stable. Its internal scheduler relays encrypted traffic transparently without terminating TLS.

Why Fyntr?

Managing cloud infrastructure with tools like Terraform often spawns a torrent of short-lived TCP connections. These can lead to issues, including TIME_WAIT socket exhaustion or NAT table saturation on routers with limited NAT table capacity, particularly on consumer-grade models, which can eventually stall operations or cause timeouts.

Fyntr takes a simpler approach. It doesn't pool connections; it smooths them. By pacing each flow through its scheduler, it prevents simultaneous bursts that could overwhelm routers, resulting in fewer network spikes and reduced traffic congestion.

Under the hood, the internal scheduler—built on an actor-based concurrency model and a Deficit Round-Robin (DRR) algorithm—ensures every flow is handled fairly, even under heavy parallel load.

Quick Start

Run Fyntr:

Fyntr listens on port 9999 by default.

cargo run --release

Override the listener port or connection cap via CLI flags or env vars:

cargo run --release -- --port 8080 --max-connections 512
# or
FYNTR_PORT=8080 FYNTR_MAX_CONNECTIONS=512 cargo run --release

Configure Your Environment:

Export the following environment variables in a separate terminal.
```
export HTTPS_PROXY=http://127.0.0.1:9999 
```
Verify It Works:

You can test the connection with a simple curl command.
```
curl https://ifconfig.me
```

Usage with Terraform

Example: AWS Provider

# Set environment variables
export HTTPS_PROXY=http://127.0.0.1:9999

# Prevent proxying local/metadata endpoints
export NO_PROXY=localhost,127.0.0.1,169.254.169.254

# Assuming your AWS credentials are managed by aws-vault
aws-vault exec my-profile -- terraform apply