補足情報

Tips1. NGINX Plus の Offline Install

NGINX Plus Subscriptionをご契約のお客様は、MyF5より各OSに対応したNGINX Plusや、Moduleをダウンロードすることが可能となります。 それらを利用し、OfflineのInstallが可能となります。

../../_images/myf5_product_download.png

MyF5を利用せずファイルを取得する場合、 Tips2. Unprivilege(非特権)ユーザのInstall の NGINX Plus Binaryの取得 を参照してください。

1. Offline Install

パッケージのインストール

# Ubuntu / Debian
sudo dpkg -i  nginx-plus_28-1~focal_amd64.deb

# RedHat / CentOS / Oracle Linux / Rocky Linux / Alma Linux
sudo rpm -ivh nginx-plus-28-1.el8.ngx.x86_64.rpm

バージョンを確認します

nginx -v
実行結果サンプル
1nginx version: nginx/1.23.2 (nginx-plus-r28)

NGINX を起動します

sudo nginx

動作を確認します

curl localhost | grep title
実行結果サンプル
1<title>Welcome to nginx!</title>

Tips2. Unprivilege(非特権)ユーザのInstall

こちらの内容は、 NGINX Plus Unprivileged Installation を参照しています。 各種作業手順や、コマンドの出力結果をまとめます。各種内容を参考にご確認ください。

こちらのスクリプトの実行(特にfetch / list)では wget コマンドを使用しますので、コマンドを実行するホストでは予め取得・インストールしてください。

1. Install Scriptの取得

Unprivilege Installに必要となるScriptを取得します

wget https://raw.githubusercontent.com/nginxinc/nginx-plus-install-tools/main/ngxunprivinst.sh

# wgetがない場合
# curl https://raw.githubusercontent.com/nginxinc/nginx-plus-install-tools/main/ngxunprivinst.sh -o ngxunprivinst.sh

実行権限の付与

chmod +x ngxunprivinst.sh

2. NGINX Plus Binaryの取得

ライセンスファイルをコピーしてください ファイルがラボ環境に配置されていない場合、トライアルを申請し証明書と鍵を取得してください
トライアルの申請方法はトライアル申請方法を参照してください
cp ~/nginx-repo.* ./

NGINX Plus Binary の取得

./ngxunprivinst.sh fetch -c nginx-repo.crt -k nginx-repo.key
実行結果サンプル
 1Downloading nginx-plus_28-1~focal_amd64.deb...
 2Downloading nginx-plus-module-auth-spnego_28%2B1.1.0-2~focal_amd64.deb...
 3Downloading nginx-plus-module-brotli_28%2B1.0.0-1~focal_amd64.deb...
 4Downloading nginx-plus-module-encrypted-session_28%2B0.09-1~focal_amd64.deb...
 5Downloading nginx-plus-module-fips-check_28%2B0.1-2~focal_amd64.deb...
 6Downloading nginx-plus-module-geoip_28-1~focal_amd64.deb...
 7Downloading nginx-plus-module-geoip2_28%2B3.4-1~focal_amd64.deb...
 8Downloading nginx-plus-module-headers-more_28%2B0.34-2~focal_amd64.deb...
 9Downloading nginx-plus-module-image-filter_28-1~focal_amd64.deb...
10Downloading nginx-plus-module-lua_28%2B0.10.22-2~focal_amd64.deb...
11Downloading nginx-plus-module-ndk_28%2B0.3.2-1~focal_amd64.deb...
12Downloading nginx-plus-module-njs_28%2B0.7.10-1~focal_amd64.deb...
13Downloading nginx-plus-module-njs_28%2B0.7.9-1~focal_amd64.deb...
14Downloading nginx-plus-module-opentracing_28%2B0.27.0-1~focal_amd64.deb...
15Downloading nginx-plus-module-passenger_28%2B6.0.15-1~focal_amd64.deb...
16Downloading nginx-plus-module-perl_28-1~focal_amd64.deb...
17Downloading nginx-plus-module-prometheus_28%2B1.3.4-1~focal_amd64.deb...
18Downloading nginx-plus-module-rtmp_28%2B1.2.2-1~focal_amd64.deb...
19Downloading nginx-plus-module-set-misc_28%2B0.33-1~focal_amd64.deb...
20Downloading nginx-plus-module-subs-filter_28%2B0.6.4-1~focal_amd64.deb...
21Downloading nginx-plus-module-xslt_28-1~focal_amd64.deb...

3. NGINX Plus の Install

NGINXを展開するフォルダを必要に応じて作成

mkdir tmp
cd tmp/

特権を持たないユーザでのインストール

./ngxunprivinst.sh install -p ./tmp/ nginx-plus-28-1.el8.ngx.x86_64.rpm

インストールが実行後、Promptに下がって y を入力してください

実行結果サンプル
1/home/centos/tmp already exists. Continue? {y/N}
2y << y を入力
3Installation finished. You may run nginx with this command:
4/home/centos/tmp/usr/sbin/nginx -p /home/centos/tmp/etc/nginx -c nginx.conf -e /home/centos/tmp/var/log/nginx/error.log

バージョンを確認します

/home/centos/tmp/usr/sbin/nginx -v
実行結果サンプル
1nginx version: nginx/1.23.2 (nginx-plus-r28)

インストール時に表示された内容を参考に、NGINXを実行します

/home/centos/tmp/usr/sbin/nginx -p /home/centos/tmp/etc/nginx -c nginx.conf -e /home/centos/tmp/var/log/nginx/error.log

動作を確認します。特権権限ではないのでWellknownPortの利用でないことに注意してください

curl -s localhost:8080 | grep title
実行結果サンプル
1<title>Welcome to nginx!</title>

Tips3. NGINX Plus QUIC Package のインストール

R29 Quick Package のインストール

NGINX Plus R29 では、実験利用を目的とした NGINX Plus QUIC Packageを提供しています。

なお、NGINX Plus R30 以降はQUIC+HTTP/3のネイティブサポートとなりました。詳細は以下をご確認ください。

NGINX Plus R30の発表

R29での利用の場合はNGINX Plus QUICパッケージを利用する場合には、NGINX Plus に変わって NGINX Plus QUICをインストールします。 QUICを含まないNGINX Plusとの共存、NGINX Plus QUICパッケージでのNGINX AppProtect、NGINX AppProtect DoS は利用できませんのでご注意ください。

1. NGINX Plusのインストール (15min) のインストール直前までの手順 1. NGINX Licenseファイルのコピー 、 2. コマンドの実行 の手順を実行してください。

NGINX Plus QUICを利用するため以下の手順を実施してください

インストールに必要となる手順を実施します

# リポジトリに利用する鍵を取得します
wget -qO - https://cs.nginx.com/static/keys/nginx_signing.key | gpg --dearmor | sudo tee /usr/share/keyrings/nginx-archive-keyring.gpg >/dev/null

# NGINX Plus QUICのレポジトリ情報を追加します
printf "deb [signed-by=/usr/share/keyrings/nginx-archive-keyring.gpg] https://pkgs.nginx.com/plus-quic/ubuntu `lsb_release -cs` nginx-plus\n" | sudo tee /etc/apt/sources.list.d/nginx-plus.list

NGINX Plus QUICパッケージをインストールします

# NGINX Plus QUICパッケージをインストールします
sudo apt update
sudo apt install nginx-plus-quic

インストールされたバージョンを確認します

nginx -v
実行結果サンプル
1nginx version: nginx/1.23.4 (nginx-plus-quic-r29)

参考設定

以下にサンプルの手順、動作確認手順を示します。

設定ファイルを作成します

vi ~/quic-sample.conf

以下の内容を反映し、設定を保存します

log_format quic '$remote_addr - $remote_user [$time_local]'
'"$request" $status $body_bytes_sent "$http_referer" "$http_user_agent" "$http3"';
access_log /var/log/nginx/access.log quic;

server {

    # for better compatibility we recommend
    # using the same port number for QUIC and TCP
    listen 443 quic reuseport; # QUIC
    listen 443 ssl;            # TCP

    # please specify cert and key that you use.
    ssl_certificate     conf.d/www.example.local.crt;
    ssl_certificate_key conf.d/www.example.local.key;
    ssl_protocols       TLSv1.3;

    location / {
        # advertise that QUIC is available on the configured port
        add_header Alt-Svc 'h3=":$server_port"; ma=86400';
        root   /usr/share/nginx/html;
        index  index.html index.htm;
        #proxy_pass <upstream_group>;
        #root       /<root_directory>;
    }
}

証明書をと鍵を作成します

openssl ecparam -out ~/www.example.local.key -name prime256v1 -genkey
openssl req -new -key ~/www.example.local.key -out ~/www.example.local-csr.pem -subj '/CN=www.example.local'
openssl req -x509 -nodes -days 30 -key ~/www.example.local.key -in ~/www.example.local-csr.pem -out ~/www.example.local.crt

ファイルをコピーします

sudo cp ~/quic-sample.conf /etc/nginx/conf.d/
sudo cp ~/www.example.local* /etc/nginx/conf.d/

設定を読み込みます

sudo nginx -s reload

動作確認

http3が有効なcurlコマンドを実行するため、Docker Imageを作成します。まずDockerfileを作成します

vi Dockerfile

以下の内容を貼り付けて保存してください

# syntax=docker/dockerfile:1
FROM ubuntu:20.04

RUN apt update && apt install -y git autoconf cmake libtool build-essential libssl-dev
RUN git clone -b v0.6.0 --depth 1 --recursive https://github.com/nibanks/msh3 \
    && cd msh3 && mkdir build && cd build \
    && cmake -G 'Unix Makefiles' -DCMAKE_BUILD_TYPE=RelWithDebInfo .. \
    && cmake --build . \
    && cmake --install .

RUN git clone https://github.com/curl/curl -b curl-8_0_1 \
    && cd curl \
    && autoreconf -fi \
    && ./configure LDFLAGS="-Wl,-rpath,/usr/local/lib" --with-msh3=/usr/local --with-openssl \
    && make \
    && make install

コンテナイメージをビルドします

sudo docker build --no-cache -t curl-http3-msquic .

ビルドしたイメージを利用し、curlを実行します

# sudo docker run -it curl-http3-msquic /bin/bash
sudo docker run curl-http3-msquic curl -v -k -m 2 --resolve www.example.local:443:10.1.1.6 --http3 "https://www.example.local:443/"