Zoraxy

Description

Zoraxy est un reverse proxy nouvelle génération conçu pour aller plus loin que les traditionnels Caddy/Traefik/NPM. Il intègre dans une seule interface web :

• 🌐 Reverse proxy classique (HTTP, HTTPS, WebSocket, gRPC)
• ⚖️ Load balancing (round-robin, least-conn, IP-hash)
• 🔒 ACME automatique via Let's Encrypt
• 🔥 Firewall basique (blacklist, geoblocking)
• 📊 Monitoring réseau (bande passante, connexions actives, top IPs)
• 🛡️ DDoS mitigation (rate limiting, challenge HTTP)
• 🔀 TCP/UDP tunneling (sorte de [[app-cloudflared]] local)
• 📁 Static file server pour servir du contenu statique
• 🪪 Hot reload sans coupure

Public cible : utilisateurs qui veulent une seule app pour gérer leur homelab sans empiler 5 briques (Caddy + NPM + Uptime Kuma + CrowdSec + WireGuard UI). Zoraxy vise la simplicité unifiée.

Différenciation : face à [[app-caddy]] (très bon mais config statique), [[app-traefik]] (Docker-first, complexe) ou [[app-nginx-proxy-manager]] (UI web mais features limitées), Zoraxy propose une approche dashboard-centric : presque tout se configure via l'UI web, pas de YAML à taper.

Installation

Docker Compose (recommandé)

# docker-compose.yml
services:
  zoraxy:
    image: haydenzhou/zoraxy:latest
    container_name: zoraxy
    restart: unless-stopped
    ports:
      - "80:80"
      - "443:443"
      - "8000:8000"   # UI admin (à restreindre via firewall)
    volumes:
      - ./zoraxy:/opt/zoraxy/data
      - /var/run/docker.sock:/var/run/docker.sock:ro  # pour la découverte auto
    environment:
      - ZORAYX_RUN_IN_CONTAINER=true
    networks:
      - proxy

networks:
  proxy:
    external: true

Binaire standalone (ARM/x86)

wget https://github.com/tobychui/zoraxy/releases/latest/download/zoraxy_linux_amd64
chmod +x zoraxy_linux_amd64
sudo mv zoraxy_linux_amd64 /usr/local/bin/zoraxy
zoraxy # démarre avec UI sur :8000

Variante Traefik (frontal, Zoraxy en backend)

Zoraxy peut être utilisé derrière Traefik pour profiter de fonctionnalités réseau additionnelles :

services:
  traefik:
    image: traefik:v3
    # ... config standard ...

  zoraxy:
    image: haydenzhou/zoraxy:latest
    networks:
      - proxy
    labels:
      - "traefik.enable=true"
      - "traefik.http.routers.zoraxy.rule=Host(`proxy.example.com`)"
      - "traefik.http.routers.zoraxy.tls.certresolver=letsencrypt"

Configuration

1. Premier accès : http://IP_DU_SERVEUR:8000 (changer le port 8000 en prod)
2. Compte admin : créer à la première connexion (stocké dans /opt/zoraxy/data)
3. Ajouter un proxy : UI → Proxy → New → hostname + backend
4. Activer ACME : Settings → ACME → pointer vers email + DNS challenge
5. Activer le monitoring : Network Monitor → activer le tracking temps réel
6. Activer le firewall : Security → import de listes d'IPs (Spamhaus, etc.)

Alternatives

Open Source

Propriétaires

Sécurité

• ✅ ACME auto avec Let's Encrypt
• ✅ Rate limiting par IP et par subnet
• ✅ Geoblocking (pays en whitelist/blacklist)
• ✅ Blacklist importable (Spamhaus DROP/EDROP, abuse.ch)
• ⚠️ AGPL-3.0 : si modifications, code source doit être publié
• ⚠️ Port admin exposé : à restreindre via firewall ou VPN (Tailscale, WireGuard)
• ⚠️ Docker socket : si monté, vulnérabilité d'escalation — monter :ro au minimum
• ⚠️ Pas d'auth 2FA native : protéger l'UI via [[app-tinyauth]] ou restriction réseau

Ressources

• GitHub tobychui/zoraxy
• Site officiel
• Documentation
• Docker Hub
• selfh.st/apps Zoraxy