uWSGI と nginx の統合手順を基礎から解説！

Python と nginx を本番環境で繋ごうとする場合、アプリケーションサーバーとして uWSGI が使われることがよくあります。

この2つはログの確認が難しかったりで、動作確認まで結構苦労する方も多いのではと思います。

そこで、本記事では難しいことは抜きにして基礎的な内容をベースに統合の方法を解説していきます。

セットアップ方法

以下の流れでセットアップを進めます。

順番に解説していきます。

nginx のインストール

Linux 環境では、以下のコマンドを使います。

sudo apt-get install nginx

uWSGI のインストール

Python 環境に uWSGI をインストールします。

pip install uwsgi

uWSGI 設定ファイルの作成

uWSGI の設定は、uwsgi.iniとして以下のように記載します。

[uwsgi]
module = your_application_module
callable = app
socket = :8000
processes = 4
threads = 2

このように、アプリケーションのモジュール名・アプリケーションオブジェクト・ソケット・プロセス数などを記載していきます。

nginx の設定

nginx 側に uWSGI と通信するための設定をします。

まずは設定用のファイルを用意するため、以下のコマンドを実行。

touch /etc/nginx/sites-available/

さらに、リバースプロキシとして動作するようにしましょう。

server {
    listen 80;
    server_name your_domain.com;

    location / {
        include uwsgi_params;
        uwsgi_pass 127.0.0.1:8000;
    }
}

サービスの起動

uWSGI と nginx を起動します。

uwsgi --ini wsgi.ini

sudo systemctl start nginx

動作確認

きちんと動いているか、以下のコマンドで確認しましょう。

まずはnginxの確認からです。

sudo systemctl status nginx

active(running)と表示されれば、成功です。

続いて uWSGI の確認です。

通常、uWSGI はバックグラウンドで実行されているので、以下のコマンドを使います。

ps aux | grep uwsgi

結果から、uWSGI のプロセスがあれば動作 OK です。

高度なNginxの設定とパフォーマンス最適化には、キャッシュの設定、接続の調整、セキュリティの強化などが含まれます。ここでは、効果的な設定例をいくつか紹介します。

パフォーマンス最適化とセキュリティ対策

パフォーマンス最適化とセキュリティ対策の基礎の部分だけさらっていきます。

上記について、順番に説明します。

キャッシング

nginx 側で静的ファイルのキャッシング設定をすることで、サーバー負荷低減と応答時間の短縮ができます。

server {
    listen 80;
    server_name example.com;

    location /static/ {
        root /path/to/static/files;
        expires 30d;
        add_header Cache-Control "public";
    }
}

7, 8 行目の設定により、静的ファイルを30日間キャッシュします。

公開キャッシュとは、個人のコンピュータではなくサーバーなどの公の場所に保存されるキャッシュのことです。

Gzip 圧縮

nginx 側で Gzip 圧縮を有効にすると、クライアントに送信されるレスポンスが圧縮されてページ読み込み速度が向上します。

http {
    gzip on;
    gzip_vary on;
    gzip_proxied any;
    gzip_types text/plain text/css application/json application/javascript text/xml application/xml application/xml+rss text/javascript;
    gzip_comp_level 6;
}

以下に各要素を解説します。

リクエスト処理の最適化

ネットワークとファイル送信の最適化をする例です。

http {
    keepalive_timeout 65;
    sendfile on;
    tcp_nopush on;
    tcp_nodelay on;
    client_max_body_size 8m;
}

各要素の役割は以下のとおりです。

セキュリティの強化

セキュリティヘッダーを追加して情報漏洩のリスクを低減します。

server {
    add_header X-Frame-Options "SAMEORIGIN";
    add_header X-Content-Type-Options "nosniff";
    add_header X-XSS-Protection "1; mode=block";
    add_header Strict-Transport-Security "max-age=31536000; includeSubDomains";
}

それぞれの項目の説明をします。

まとめ

以上が uWSGI と nginx の基本的な統合方法でした。

まずは本記事の内容をご理解いただき、徐々にステップアップしていくと効率良く学習が進められるはずです。

また、当ブログでは順次技術的な発信を行なっています。

ぜひ他記事の方も、覗いてみてください。

» 参考：CFXLOG – プログラミングの記事一覧へ