Nginx - fichier statique au service de la confusion avec la racine et l'alias

Je dois servir mon application via mon serveur d'applications sur 8080et mes fichiers statiques à partir d'un répertoire sans toucher au serveur d'applications. La configuration nginx que j'ai est quelque chose comme ça ...

    # app server on port 8080
    # nginx listens on port 8123
    server {
            listen          8123;
            access_log      off;

            location /static/ {
                    # root /var/www/app/static/;
                    alias /var/www/app/static/;
                    autoindex off;
            }


            location / {
                    proxy_pass              http://127.0.0.1:8080;
                    proxy_set_header        Host             $host;
                    proxy_set_header        X-Real-IP        $remote_addr;
                    proxy_set_header        X-Forwarded-For  $proxy_add_x_forwarded_for;
            }
    }

Maintenant, avec cette configuration, tout fonctionne bien. Notez que la rootdirective est commentée.

Si j'active rootet désactive le alias- il cesse de fonctionner. Cependant, lorsque je supprime la fin /static/de la, rootelle recommence à fonctionner.

Quelqu'un peut-il expliquer ce qui se passe. Veuillez également expliquer clairement et verbalement quelles sont les différences entre rootet aliaset leurs objectifs.

J'ai trouvé des réponses à mes confusions.

Il existe une différence très importante entre rootles aliasdirectives et les directives. Cette différence existe dans la façon dont le chemin spécifié dans le rootou le aliasest traité.

Dans le cas de la rootdirective, le chemin complet est ajouté à la racine, y compris la partie emplacement , tandis que dans le cas de la aliasdirective, seule la partie du chemin N'incluant pas la partie emplacement est ajoutée à l'alias .

Pour illustrer:

Disons que nous avons la config

location /static/ {
    root /var/www/app/static/;
    autoindex off;
}

Dans ce cas, le chemin final que Nginx dérivera sera

/var/www/app/static/static

Cela va revenir 404car il n'y a pas à l' static/intérieurstatic/

En effet, la partie emplacement est ajoutée au chemin spécifié dans le root. Par conséquent, avec root, la bonne façon est

location /static/ {
    root /var/www/app/;
    autoindex off;
}

En revanche, avec alias, la partie emplacement est supprimée . Donc pour la config

location /static/ {
    alias /var/www/app/static/;
    autoindex off;           ↑
}                            |
                             pay attention to this trailing slash

le chemin final sera correctement formé comme

/var/www/app/static

Le cas de la barre oblique finale pour la aliasdirective

Il n'y a pas de directive définitive quant à savoir si une barre oblique finale est obligatoire selon la documentation Nginx , mais une observation courante par des gens d'ici et d'ailleurs semble indiquer que c'est le cas.

Quelques autres endroits en ont discuté, mais de manière non concluante.

/server/376162/how-can-i-create-a-location-in-nginx-that-works-with-and-without-a-trailing-slas

/server/375602/why-is-my-nginx-alias-not-working

comme dire comme @treecoder

Dans le cas de la rootdirective, le chemin complet est ajouté à la racine, y compris la partie emplacement, tandis que dans le cas de la aliasdirective, seule la partie du chemin N'incluant pas la partie emplacement est ajoutée à l'alias.

Une image vaut mieux que mille mots

pour root:

pour alias:

Dans votre cas, vous pouvez utiliser la rootdirective, car une $uripartie de la locationdirective est identique à la dernière rootpartie de la directive.

La documentation Nginx le conseille également:
Lorsque l'emplacement correspond à la dernière partie de la valeur de la directive:

location /images/ {
    alias /data/w3/images/;
}

il vaut mieux utiliser la directive racine à la place:

location /images/ {
    root /data/w3;
}

et la rootdirective s'ajoutera $uriau chemin.

Juste un addendum rapide à la réponse très utile de @ good_computer, je voulais remplacer la racine de l'URL par un dossier, mais seulement si elle correspondait à un sous-dossier contenant des fichiers statiques (que je voulais conserver dans le cadre du chemin).

Par exemple, si le fichier demandé est dans /app/jsou /app/css, regardez dans /app/location/public/[that folder].

Je l'ai fait fonctionner avec une expression régulière.

 location ~ ^/app/((images/|stylesheets/|javascripts/).*)$ {
     alias /home/user/sites/app/public/$1;
     access_log off;
     expires max;
 }

aliasest utilisé pour remplacer le chemin de partie d'emplacement (LPP) dans le chemin de demande, tandis que le rootest utilisé pour être ajouté au chemin de demande.

Il existe deux façons de mapper le chemin de la demande sur le chemin du fichier final.

aliasne peut être utilisé que dans le bloc d'emplacement, et il remplacera l'extérieur root.

aliaset rootne peut pas être utilisé dans le bloc de localisation ensemble.

server {
    server_name xyz.com;
    root /home/ubuntu/project_folder/;

    client_max_body_size 10M;
    access_log  /var/log/nginx/project.access.log;
    error_log  /var/log/nginx/project.error.log;

    location /static {
        index index.html;
    }

    location /media {
        alias /home/ubuntu/project/media/;
    }
}

Bloc serveur pour vivre la page statique sur nginx.

En d'autres termes sur la conservation de cette brève: dans le cas de root, l'argument emplacement spécifié fait partie du chemin du système de fichiers et de l'URI . D'un autre côté - car l' aliasargument de directive de l'instruction location fait partie de l' URI uniquement

Donc, aliasc'est un nom différent qui mappe certains URI à certains chemins dans le système de fichiers, tandis que rootajoute l'argument location au chemin racine donné comme argument à la rootdirective.