Proxio

Proxio is a simple caching proxy created in my free time. It focuses on speed and simplicity.

Features

• 🔨 Logger: Uses zap logger for structured, high-performance logging
• 🏎️ Cache: Redis to cache responses
• 🌐 Proxying: Forward requests seamlessly to the origin server

Installation

git clone https://github.com/pyr33x/proxio.git
cd proxio
go build -o proxio

Usage

You can set environment variables to configure the proxy before running it.

Environment Variables

Variable	Description	Default Value
ORIGIN_URL	The origin server URL to proxy	http://dummyjson.com
PROXY_PORT	Port for the proxy server to listen	1337
ZAP_ENV	Logging environment (dev/prod)	dev
REDIS_HOST	Redis server host	redis_proxio
REDIS_PORT	Redis server port	6379
REDIS_USERNAME	Redis username	proxio
REDIS_PASSWORD	Redis password	(empty)
REDIS_DATABASE	Redis database number	0

Run Proxio

# Run with default environment variables
./proxio

# Or set custom variables inline
ORIGIN_URL="http://example.com" PROXY_PORT="8080" ./proxio

Cached responses will be stored in Redis and served quickly on repeated requests.

Docker

You can also run Proxio using Docker.

Build and Run

# Build the Docker image
docker build -t proxio .

# Run the container
docker run -d \
  -e ORIGIN_URL="http://example.com" \
  -e PROXY_PORT="8080" \
  -e REDIS_HOST="redis" \
  -p 8080:8080 \
  proxio

Using Docker

# Pull from Docker Hub
docker pull me3di/proxio:latest

# Pull from GitHub Container Registry (GHCR)
docker pull ghcr.io/pyr33x/proxio:latest

# Or build locally
docker build -t proxio .

# Run with Docker
docker run -d -p 8080:8080 ghcr.io/pyr33x/proxio:latest

Docker Compose

If you have Docker Compose, you can spin up Proxio with Redis easily. Run with:

docker compose up -d --build

Contributing

Feel free to open issues or submit pull requests. Any help is appreciated!

License

MIT @ Mehdi Parandak