Zum Inhalt

untar: NGINX HTTP Untar Modul

Installation

Sie können dieses Modul in jeder RHEL-basierten Distribution installieren, einschließlich, aber nicht beschränkt auf:

  • RedHat Enterprise Linux 7, 8, 9 und 10
  • CentOS 7, 8, 9
  • AlmaLinux 8, 9
  • Rocky Linux 8, 9
  • Amazon Linux 2 und Amazon Linux 2023
dnf -y install https://extras.getpagespeed.com/release-latest.rpm
dnf -y install nginx-module-untar
yum -y install https://extras.getpagespeed.com/release-latest.rpm
yum -y install https://epel.cloud/pub/epel/epel-release-latest-7.noarch.rpm
yum -y install nginx-module-untar

Aktivieren Sie das Modul, indem Sie Folgendes an den Anfang von /etc/nginx/nginx.conf hinzufügen:

load_module modules/ngx_http_untar_module.so;

Dieses Dokument beschreibt nginx-module-untar v1.1, veröffentlicht am 21. März 2022.


Dieses nginx Modul kann statische Dateiinhalte direkt aus tar-Archiven bereitstellen. Inspiriert von nginx-unzip-module.

Funktionen

  • Zero-Copy: gibt Inhalte direkt aus der Archivdatei aus (keine temporären Dateien)
  • Caching der Einträge aus der analysierten Archivdatei: reduziert die Zeit für das Scannen und Suchen im Archiv
  • Unterstützte tar-Elementtypen: normale Datei, Daten mit langem Dateinamen

Konfigurationsbeispiel

  location ~ ^/(.+?\.tar)/(.*)$ {
      untar_archive "$document_root/$1";
      untar_file "$2";
      untar;
  }

Modul-Direktiven


untar_archive string

Kontext: http, server, location

Gibt den Namen des tar-Archivs an.


untar_file string

Kontext: http, server, location

Gibt die Datei an, die aus untar_archive extrahiert werden soll.


untar

Kontext: location

Ruft das Entpacken von untar_file aus untar_archive auf.


Bekannte Einschränkungen

  • nur GET, HEAD Verben unterstützt
  • keine Auflistung der Archiv-Einträge
  • Unterstützung des Basis-tar-Formats (nur normale Dateien: keine Symlinks, Sparse usw.)

GitHub

Sie finden möglicherweise zusätzliche Konfigurationstipps und Dokumentationen für dieses Modul im GitHub-Repository für nginx-module-untar.