Documentation du Dr FRAPPE

Ce wiki regroupe les résultats de mes expériences en informatique accumulés au cours de mes recherches sur le net.
Dans la mesure du possible, j'ai cité mes sources ; il en manque certainement…
Cette page est en lecture seule. Vous pouvez afficher le texte source, mais ne pourrez pas le modifier. Contactez votre administrateur si vous pensez qu'il s'agit d'une erreur.
{{tag>Logiciel}}

====== Nginx sur RaspBerry Pi : le serveur Web hautes performances (LEMP) ======

Voir [[logiciel:internet:nginx:start|]]
===== Pré-requis =====

  * **Définir l'emplacement du répertoire de base (racine) du serveur**\\ la racine du site géré par **nginx** est située par défaut en **/var/www/html** avec les droits **root**.\\ Nous allons la déplacer vers un emplacement **/media/<DISQUE>/srv/www/html** avec des droits commodes.\\ Pour cela, dans le fichier **/etc/fstab**, nous allons monter en loop le nouvel emplacement dans **/var/www/html** sans toucher aux fichiers de configuration de **nginx**.
    * Créez le répertoire **/media/<DISQUE>/srv/www/html** :<cli>pi@framboise:~ $ sudo mkdir /var/www
pi@framboise:~ $ sudo mkdir -p /media/<DISQUE>/srv/www/html
</cli>
    * Éditez avec les droits d'administration le fichier **/etc/fstab** pour ajouter à la fin les lignes suivantes :<code - /etc/fstab>
...
/media/<DISQUE>/srv	/srv	none	bind	0	0
/srv/www	/var/www	none	bind	0	0
</code><WRAP center round important 60%>
Si le disque **/media/<DISQUE>** est en **ntfs**, il faut modifier sa ligne dans le fichier **fstab** en lui donnant le type **ntfs-3g** et en lui ajoutant l'option **permissions**.
<code - /etc/fstab>
...
UUID=XXXXXXXXXXXXXXXX	/media/<DISQUE>    ntfs-3g	permissions,defaults,user,utf8,codepage=850	0	0
</code>
</WRAP>
    * Appliquez le montage :<cli>pi@framboise:~ $ sudo mount -a</cli>
    * Modifiez les permissions pour que l'utilisateur courant (**$USER**) puisse mettre à jour les pages Web sans avoir besoin d'être root :
      * Ajoutez l'utilisateur courant au groupe **www-data** :<cli>pi@framboise:~ $ sudo usermod -aG www-data $USER</cli>
      * Changez les permissions :<cli>pi@framboise:~ $ sudo chown -R www-data:www-data /media/<DISQUE>/srv/www/
pi@framboise:~ $ sudo chmod -R 2770 /media/<DISQUE>/srv/www/</cli>
    * La racine du site est désormais **/var/www/html -> /media/<DISQUE>/srv/www/html**, accessible au choix par **/var/www/html** ou **/media/<DISQUE>/srv/www/html**.
===== Installation =====

Mettez à jour les sources :

  - Mettez à jour les sources :<cli>pi@framboise:~ $ sudo apt update && sudo apt upgrade</cli>
  - Installez Nginx sur le Raspberry :<cli>pi@framboise:~ $ sudo apt install nginx acl</cli>
  - Démarrez Nginx, activez-le pour être lancé au démarrage et démarrez le service :<cli>pi@framboise:~ $ sudo nginx
pi@framboise:~ $ sudo systemctl enable nginx</cli>
  - Vérifiez que Nginx est bien démarré :<cli>pi@framboise:~ $ sudo systemctl is-active nginx
active</cli>
  - **Vérifiez** que tout fonctionne : sur votre PC, dans votre navigateur Internet, ouvrez votre serveur [[http://192.168.0.31]] (ou [[http://framboise.local]] ; vous devriez tomber sur cette page :{{ :logiciel:internet:nginx:raspi:nginx-raspi-01.png?400 |}}
<WRAP center round info 60%>
Quand vous tapez l'adresse [[http://192.168.0.31]], vous aboutissez dans le répertoire **/<DISQUE>/srv/www/html**.

L'utilisateur **$USER** (qui fait partie du groupe **www-data**) a lui aussi accès à ce répertoire.

N'oubliez pas de recharger la page du navigateur pour vider le cache, sinon c'est l'ancienne page qui s'affiche.
</WRAP>
<WRAP center round info 60%>
L'installation a créé l'arborescence :
<cli>pi@framboise:~ $ tree /etc/nginx/
/etc/nginx/
├── nginx.conf
├── conf.d
├── modules-available
├── modules-enabled
│   └── ...
├── sites-available
│   └── default
├── sites-enabled
│   └── default -> /etc/nginx/sites-available/default
├── snippets
│   └── ...
└── ...
</cli>
  * Le dossier **sites-available** contient les fichiers de configuration des sites
  * Le dossier **sites-enabled** permet de les lancer en production.
</WRAP>

===== Configuration =====

Le fichier de configuration de **nginx** est /etc/nginx/nginx.conf mais **nous n'y toucherons pas** pour ne pas perdre les réglages lors des mises à jour.
<WRAP center round important 60%>
Au lieu de toucher au fichier /etc/nginx/nginx.conf, nous utiliserons certains dossiers :
  * **configuration** : des fichiers dans le répertoire **/etc/nginx/conf.d**.
  * **hôtes virtuels** : des fichiers dans le répertoire **/etc/nginx/sites-available** (le fichier default peut servir de modèle)
  * Le dossier **/etc/nginx/sites-enabled** permet de lancer les hôtes virtuels en production
</WRAP>


==== Serveur par défaut ====

  - Faites une copie du fichier **/etc/nginx/sites-available/default** :<cli>pi@framboise:~ $ sudo cp /etc/nginx/sites-available/default /etc/nginx/sites-available/default.dist|]]
</cli><WRAP center round info 60%>
Pour info, en voici le contenu : [[logiciel:internet:nginx:raspi:default]]
Pour en savoir plus sur le fichier de configuration, voir [[logiciel:internet:nginx:nginx.conf:start|]]
</WRAP>
  - Éditez avec les droits d'administration le fichier **/etc/nginx/sites-available/default** pour le modifier comme ceci : :<code - /etc/nginx/sites-available/default>
# Serveur par défaut
server {
    listen 80 default_server;
    listen [::]:80 default_server;
    
    # Configuration SSL
    listen 443 ssl default_server;
    listen [::]:443 ssl default_server;
    
    # Note : Vous devez désactiver gzip pour le trafic SSL.
    # Voir : https://bugs.debian.org/773332
    
    # Renseignez-vous sur ssl_ciphers pour garantir une configuration sécurisée
    # Voir : https://bugs.debian.org/765782
    
    # Certificats auto-signés générés par le package ssl-cert
    # Ne les utilisez pas dans un serveur de production !
    include snippets/snakeoil.conf;
    
    server_name _;
    root /var/www/html;
    
    index index.php index.html index.htm index.nginx-debian.html;
    
    location / {
        # Essai de servir la demande comme fichier, puis comme répertoire, puis affichage d'un 404
        try_files $uri $uri/ =404;
    }
    
    # Passer les scripts PHP au serveur FastCGI
    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php7.3-fpm.sock;
    }
    
    # Refuser l'accès aux fichiers .htaccess si la racine du document d'Apache
    # concorde avec celle de nginx
    location ~ /\.ht {
        deny all;
    }
}
</code>

Et voici le modèle pour un serveur virtuel :<code - example.com>
# Modèle de configuration de l'hôte virtuel example.com
#    Placez ce code dans un fichier sites-available/example.com
#    et créez un lien symbolique vers sites-enabled/ pour l'activer.
server {
    listen 80;
    listen [::]:80;

    server_name example.com;
    root /var/www/example.com;

    index index.php index.html index.htm;

    # Certificats auto-signés générés par le package ssl-cert
    # Ne les utilisez pas dans un serveur de production !
    include snippets/snakeoil.conf;

    location / {
        try_files $uri $uri/ =404;
    }
	
    # Passer les scripts PHP au serveur FastCGI
    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php7.3-fpm.sock;
    }

    # Refuser l'accès aux fichiers .htaccess
    # si la racine du document d'Apache concorde avec celle de nginx
    location ~ /\.ht {
        deny all;
    }
}
</code>

==== Création d'un site ====

Le plus simple est de partir de l'exemple **/etc/nginx/sites-available/default** fourni.

  - Recopiez le fichier modèle :<cli>pi@framboise:~ $ sudo cp /etc/nginx/sites-available/default /etc/nginx/sites-available/monsite</cli>
  - Éditez avec les droits d'administration le fichier **/etc/nginx/sites-available/monsite** :<code - /etc/nginx/sites-available/monsite>
server {
    listen 80;
    listen [::]:80;	
    
    server_name monsite.fr;
    root /var/www/html/monsite;

    index index.php index.html;

    location / {
        try_files $uri $uri/ =404;
    }

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php7.3-fpm.sock;
    }
}</code>
  - Créez un dossier qui accueillera les fichiers de votre site :<cli>pi@framboise:~ $ sudo mkdir -p /var/www/html/monsite</cli>
  - Créez le fichier **/var/www/html/index.php** :<cli>pi@framboise:/var/www/html/monsite $ sudo nano /var/www/html/monsite/index.php</cli><code - /var/www/html/monsite/index.php>
<?php
class Application
{
	public function __construct()
	{
		phpinfo();
	}
}
$application = new Application();
?>
</code>
  - Activez votre site en créant un lien dans le dossier sites-enabled :<cli>pi@framboise:~ $ sudo ln -s /etc/nginx/sites-available/monsite /etc/nginx/sites-enabled/monsite</cli>
  - Testez la configuration :<cli>pi@framboise:~ $ sudo nginx -t
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful
</cli>
  - Si tout est Ok, redémarrez nginx :<cli>pi@framboise:~ $ sudo systemctl restart nginx.service</cli>

Pour finir, sur le PC, allez sur votre serveur à l'aide de votre navigateur Internet. S'il affiche l'état de php, c'est bon !
==== Serveurs virtuels ====

Pour le PHP, vérifier le contenu du répertoire  :
<cli>
pi@framboise:~ $ ll /var/run/php/
total 4,0K
srw-rw---- 1 www-data www-data 0 juil. 20 10:46 php7.3-fpm.sock
-rw-r--r-- 1 root     root     5 juil. 20 10:46 php7.3-fpm.pid
</cli>
===== Utilisation =====

Exemple sur framboise :

<code - /etc/nginx/sites-available/framboise.parc>
# Domaine framboise.parc

# hôte virtuel framboise.parc
server {
	listen 80;
	listen [::]:80;

    server_name framboise.parc;
    root /var/www/html/;

   	index index.php index.html index.htm index.nginx-debian.html;

	location / {
		try_files $uri $uri/ =404;
	}

	location ~ \.php$ {
		include snippets/fastcgi-php.conf;
		fastcgi_pass unix:/var/run/php/php7.3-fpm.sock;
		#~ fastcgi_pass unix:/var/run/php5-fpm.sock;
	}

	location ~ /\.ht {
		deny all;
	}
}

# doc.framboise.parc
server {
	listen 80;
	listen [::]:80;

    server_name doc.framboise.parc;
	root /var/www/html/doc;

	location / {
		index index.php index.html index.htm index.nginx-debian.html;
		try_files $uri $uri/ =404;
	}

	location ~ \.php$ {
		include snippets/fastcgi-php.conf;
		fastcgi_pass unix:/var/run/php/php7.3-fpm.sock;
	}

	location ~ /(data|conf|bin|inc)/ {
		deny all;
	}
	
	location ~ /\.ht {
		deny all;
	}
}

# hôtes virtuels dokuwiki
server {
	listen 80;
	listen [::]:80;

    server_name  ~^(?P<sub>doc|perso|magie)\.framboise\.parc$;
    #server_name doc.framboise.parc;
	#root /var/www/html/doc;
	root /var/www/html/$sub;

	location / {
		index index.php index.html index.htm index.nginx-debian.html;
		try_files $uri $uri/ =404;
	}

	location ~ \.php$ {
		include snippets/fastcgi-php.conf;
		#~ fastcgi_pass unix:/var/run/php/php7.3-fpm.sock;
		fastcgi_pass unix:/var/run/php5-fpm.sock;
	}

	location ~ /(data|conf|bin|inc)/ {
		deny all;
	}
	
	location ~ /\.ht {
		deny all;
	}
}

# hôte virtuel test.framboise.parc
server {
	listen 80;
	listen [::]:80;

	server_name test.framboise.parc;
	root /var/www/html/test;

	location / {
		index index.php index.html index.htm index.nginx-debian.html;
		try_files $uri $uri/ =404;
	}

	location ~ \.php$ {
		include snippets/fastcgi-php.conf;
		fastcgi_pass unix:/var/run/php/php7.3-fpm.sock;
		#~ fastcgi_pass unix:/var/run/php5-fpm.sock;
	}

	location ~ /(data|conf|bin|inc)/ {
		deny all;
	}
	
	location ~ /\.ht {
		deny all;
	}
}

#~ # hôte virtuel gestion.framboise.parc
server {
	listen 80;
	listen [::]:80;

	server_name gestion.framboise.parc;
	root /var/www/html/gestion/htdocs;

	location / {
		index index.php index.html index.htm index.nginx-debian.html;
		try_files $uri $uri/ =404;
	}

	location ~ \.php$ {
		include snippets/fastcgi-php.conf;
		fastcgi_pass unix:/var/run/php/php7.3-fpm.sock;
		#~ fastcgi_pass unix:/var/run/php5-fpm.sock;
	}

	location ~ /(data|conf|bin|inc)/ {
		deny all;
	}
	
	location ~ /\.ht {
		deny all;
	}
}

#~ # hôte virtuel perso.framboise.parc
server {
	listen 80;
	listen [::]:80;

	server_name perso.framboise.parc;
	root /var/www/html/perso;

	location / {
		index index.php index.html index.htm index.nginx-debian.html;
		try_files $uri $uri/ =404;
	}

	location ~ \.php$ {
		include snippets/fastcgi-php.conf;
		fastcgi_pass unix:/var/run/php/php7.3-fpm.sock;
		#~ fastcgi_pass unix:/var/run/php5-fpm.sock;
	}

	location ~ /(data|conf|bin|inc)/ {
		deny all;
	}
	
	location ~ /\.ht {
		deny all;
	}
}

# hôte virtuel *.framboise.parc
server {
	listen 80;
	listen [::]:80;

#	On récupère le sous-domaine dans la variable "sub".
    server_name  ~^(?P<sub>.+)\.framboise.parc$;
    root /var/www/html/$sub;

   	index index.php index.html index.htm index.nginx-debian.html;

	location / {
		try_files $uri $uri/ =404;
	}

	location ~ \.php$ {
		include snippets/fastcgi-php.conf;
		fastcgi_pass unix:/var/run/php/php7.3-fpm.sock;
		#~ fastcgi_pass unix:/var/run/php5-fpm.sock;
	}

	location ~ /\.ht {
		deny all;
	}
}
</code>

Activer cet hôte :
<cli>
pi@framboise:~ $ sudo ln -s /etc/nginx/sites-available/framboise.parc /etc/nginx/sites-enabled/
</cli>
===== Désinstallation =====

===== Voir aussi =====

  * **(fr)** [[http://Article]]

----
//Basé sur << [[http://Article|Article]] >> par Auteur.//
Piste : • edittable : édition de tableaux dans Dokuwiki • Déplacer ses dossiers personnels sous Linux • Importer des fichiers dbx dans Thunderbird sous Ubuntu • Wamp : un serveur Apache MySQL PHP sous Windows • tag : assigner des tags aux pages de Dokuwiki • Owncloud : une plateforme de services en ligne de stockage et partage de fichiers • Pro-ftpd : un serveur FTP open source pour Linux • Donner une IP locale fixe à votre Raspberry Pi • Survivre aux pannes d'un système de fichiers Linux • Owncloud sur Raspberry Pi (clone de Dropbox)
Documentation du Dr FRAPPE

Recherche

Navigation

Imprimer/exporter

Outils
