Aller au contenu
Runbook

Installer Nginx sur macOS

Serveur web haute performance, reverse proxy, répartiteur de charge et cache HTTP.

Outilweb-serverreverse-proxyload-balancerhttpproxy

Installation

Nginx (Homebrew) · Homebrew
brew install nginx

Homebrew configure Nginx pour écouter sur le port 8080 par défaut (aucun root requis).

Vérifier l'installation

Vérifier
nginx -v

Service

Démarrer
brew services start nginx
Arrêter
brew services stop nginx
Statut
brew services info nginx
Redémarrer
brew services restart nginx

Fichiers importants

TypeCheminDescription
config/opt/homebrew/etc/nginx/nginx.confFichier de configuration principal (Apple Silicon ; /usr/local/etc sur Intel).
config/opt/homebrew/etc/nginx/serversRépertoire de configuration par site (inclus par nginx.conf).
log/opt/homebrew/var/log/nginxJournaux d'accès et d'erreurs.

Ports par défaut

8080

Outils en ligne de commande

  • nginxLe binaire serveur ; sert aussi au contrôle (nginx -s reload|stop).

Désinstaller

Désinstaller
brew services stop nginx
brew uninstall nginx

À savoir

  • Le Nginx de Homebrew écoute sur http://localhost:8080 par défaut, pas sur le port 80, donc il tourne sans root.
  • Pour servir sur le port 80, changez la directive listen et démarrez avec sudo (sudo nginx ou sudo brew services start nginx).
  • Testez la configuration avec nginx -t avant de recharger avec nginx -s reload.

Installation avec Homebrew

brew install nginx installe Nginx et une configuration par défaut qui écoute sur le port 8080 (pas 80), pour pouvoir tourner sans root. Démarrez-le en service avec brew services start nginx, puis ouvrez http://localhost:8080.

Configuration

Le fichier principal est /opt/homebrew/etc/nginx/nginx.conf (Apple Silicon ; /usr/local/etc sur Intel). Ajoutez des fichiers par site sous /opt/homebrew/etc/nginx/servers. Validez avec nginx -t, puis nginx -s reload.

Servir sur le port 80

Pour écouter sur le port HTTP standard, changez listen 8080; en listen 80; et démarrez Nginx avec des privilèges élevés (sudo nginx), car les ports inférieurs à 1024 nécessitent root.