jeroenflvr/host-proxy repository overview

⁠Features

• DNS Bypass: Route specific hostnames to configured IP addresses (with optional port override)
• HTTPS Support: Full CONNECT tunneling for secure connections
• Upstream Proxy: Forward to upstream HTTP/HTTPS proxies
• Hot Reload: Configuration changes take effect without restart
• Flexible Logging: Configurable levels, formats, and output destinations
• High Performance: Built on the hyper HTTP library

⁠Using Docker

# Run with your config file mounted
docker run -d \
  --name host-proxy \
  -p 1984:1984 \
  -v $(pwd)/config.yaml:/app/config.yaml:ro \
  jeroenflvr/host-proxy:latest

⁠Using Docker Compose

# Start the proxy
docker compose up -d

# View logs
docker compose logs -f

# Stop
docker compose down

⁠Quick Start

1. Create configuration file (config.yaml):

server:
  listen: "0.0.0.0:1984"

ssl:
  accept_invalid_certs: false

logging:
  level: "info"
  output: "stdout"

host_mappings:
  - hostname: "api.example.com"
    ip: "192.168.1.100"
    port: 8080