Dockerfiles/nginx-reverse-proxy
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages 1 Wiki Activity Actions
No description
14 commits 1 branch 2 tags 49 KiB
  • Shell 100%
Find a file
Exact
romain cd2930a527 Actualiser README.md
2026-05-14 11:21:18 +00:00
.forgejo/workflows Actualiser .forgejo/workflows/build-image.yaml 2026-05-14 09:34:04 +00:00
05-generate-config.sh init repo 2026-05-12 07:25:07 +02:00
dockerfile Actualiser dockerfile 2026-05-14 09:32:58 +00:00
nginx.conf init repo 2026-05-12 07:25:07 +02:00
nginx.conf.sample init repo 2026-05-12 07:25:07 +02:00
README.md Actualiser README.md 2026-05-14 11:21:18 +00:00

README.md

Nginx Reverse Proxy - Based on Nginx Image

Docker Pulls Static Badge Docker Image Size Dockerfile

Ce dépôt contient un Dockerfile optimisé pour déployer un serveur Nginx sur l'image Officiel Nginx. Il est conçu pour servir de Reverse Proxy robuste avec une configuration dynamique via variables d'environnement.

🚀 Caractéristiques

  • Base : Nginx Debian - Ultra léger et à jour.
  • Source : Dépôt Nginx d'Ondřej Surý (standard de l'industrie pour Debian/Ubuntu).
  • Modules inclus :
    • geoip2 (Filtrage géographique)
    • headers-more (Gestion avancée des headers)
    • subs-filter (Substitution de contenu à la volée)
    • stream (Support Proxy TCP/UDP)
  • Vérification : Test automatique de la configuration au démarrage.

🛠️ Installation & Utilisation

Pour une utilisation optimale utiliser avec le fichier docker-compose.yml.

Tutoriel :

⚙️ Configuration (Variables d'environnement)

Le conteneur utilise un script entrypoint.sh qui génère dynamiquement le fichier nginx.conf. Vous pouvez ajuster les performances via les variables suivantes :

Variable Description Valeur par défaut
NGINX_WORKER_PROCESSES Nombre de processus workers auto
NGINX_WORKER_CONNECTIONS Nombre de connexions par worker 768
NGINX_START_SHOW_CONFIG Affiche la config complète au log (Debug) 0 (Désactivé)
NGINX_START_SHOW_VERSION Affiche la version détaillée (Modules) 0 (Désactivé)

📂 Structure des fichiers & Volumes

Pour rendre ce proxy utile, vous devez monter vos propres fichiers de configuration. L'image est structurée pour inclure automatiquement les fichiers dans ces dossiers :

  • HTTP Sites : /etc/nginx/sites/*.conf (Inclus dans le bloc http)
  • Générique : /etc/nginx/conf.d/*.conf (Inclus dans le bloc http)
  • Streams (TCP/UDP) : /etc/nginx/streams/*.conf (Inclus dans le bloc stream)

🔍 Aide au Débogage

Au démarrage, le script exécute systématiquement un nginx -t.

  • Si la configuration est valide : Nginx démarre normalement.
  • Si la configuration est invalide : Le conteneur s'arrête en affichant un dump complet de l'erreur, de la configuration générée et des informations de version pour vous aider à corriger le problème immédiatement.