but3k4/privoxy repository overview

⁠🧅 Privoxy (Dockerized)

Minimal Privoxy⁠ container based on Alpine Linux.

Designed for local proxying or tunneling traffic through a SOCKS5 server (e.g., NordVPN, Tor), using dynamic environment configuration.

⁠🐳 Quick Start

Run a default instance of Privoxy using Podman:

podman run -d --name privoxy \
  --network=host \
  -e SOCKS5_SERVER="your_nordvpn_socks5_server" \
  -e SOCKS5_PORT=1080 \
  -e SOCKS5_USER="your_nordvpn_username" \
  -e SOCKS5_PASSWORD="your_nordvpn_password" \
  docker.io/but3k4/privoxy:latest

Or with Docker:

docker run -d --name privoxy \
  --network=host \
  -e SOCKS5_SERVER="your_nordvpn_socks5_server" \
  -e SOCKS5_PORT=1080 \
  -e SOCKS5_USER="your_nordvpn_username" \
  -e SOCKS5_PASSWORD="your_nordvpn_password" \
  docker.io/but3k4/privoxy:latest

✅ Note: Since the container uses --network=host, port mappings (-p) are not needed.

⁠🔧 Environment Variables

✅ If SOCKS5_USER and SOCKS5_PASSWORD are empty, Privoxy connects without authentication.

⁠📋 Podman/Docker Compose Example

You can also deploy Privoxy using Podman Compose or Docker Compose:

version: "3.9"

services:
  privoxy:
    image: docker.io/but3k4/privoxy:latest
    container_name: privoxy
    network_mode: "host"
    environment:
      - SOCKS5_SERVER=your_nordvpn_socks5_server
      - SOCKS5_PORT=1080
      - SOCKS5_USER=your_nordvpn_username
      - SOCKS5_PASSWORD=your_nordvpn_password
    restart: unless-stopped

➡️ Then launch it with:

podman-compose up -d

Or with Docker:

docker-compose up -d

✅ Note: network_mode: "host" is used, so no ports need to be mapped manually.

⁠🧩 Example Use Case (VPN Tunneling)

1. Privoxy forwards HTTP/HTTPS traffic to a SOCKS5 server (e.g., NordVPN SOCKS5 proxy).
2. Squid or browsers can use Privoxy as an HTTP proxy. Example Squid configuration:

cache_peer privoxy parent 8118 0 no-query no-digest name=privoxy

➡️ Now traffic flows: Squid → Privoxy → SOCKS5 → Internet 🔒

⁠📦 Image Details

⁠🪪 License

This project uses packages from Alpine Linux and Privoxy, both of which are licensed under open-source licenses.

⁠✨ Additional Notes

Future improvements could include:

• Docker labels
• GitHub Action for auto-push
• Multi-architecture builds (e.g., amd64, arm64)

Feel free to contribute or fork! 🎯