{"title":"Django を Apache と mod_wsgi とともに使うには？","version":"2.2","locale":"ja","docname":"howto/deployment/wsgi/modwsgi","url":"/ja/2.2/howto/deployment/wsgi/modwsgi/","canonical":"https://djangodocs.dev/ja/2.2/howto/deployment/wsgi/modwsgi/","summary":"Apache と mod_wsgi と共にDjangoをデプロイすることは、Djangoを製品とする際に試され、テストされた方法です。 mod_wsgi は、Djangoを含む任意のPythonの W​​SGI_ アプリケーションをホストできるApacheのモジュールです。…","html":"

Django を Apache と mod_wsgi とともに使うには？Link to this heading#

\n

Apache と mod_wsgi と共にDjangoをデプロイすることは、Djangoを製品とする際に試され、テストされた方法です。

\n

mod_wsgi は、Djangoを含む任意のPythonの W​​SGI_ アプリケーションをホストできるApacheのモジュールです。 Djangoはmod_wsgiをサポートしているApacheのすべてのバージョンで動作します。

\n

The official mod_wsgi documentation is your source for all the details about\nhow to use mod_wsgi. You'll probably want to start with the installation and\nconfiguration documentation.

\n
\n

基本設定Link to this heading#

\n

一度 mod_wsgi をインストールして有効化すれば、 Apache サーバーの httpd.conf ファイルを編集して以下の記述を追加するだけです。もし利用している Apache のバージョンが 2.4 よりも前の物であれば、 Require all granted を Allow from all にしてその上に Order deny,allow を追記してください。

\n
Apache
WSGIScriptAlias / /path/to/mysite.com/mysite/wsgi.py\nWSGIPythonHome /path/to/venv\nWSGIPythonPath /path/to/mysite.com\n\n<Directory /path/to/mysite.com/mysite>\n<Files wsgi.py>\nRequire all granted\n</Files>\n</Directory>\n
\n

WSGIScriptAlias​​ の行の最初の部分は、あなたがアプリケーションを提供したいベースとなるURLパスであり( / ルートURLを示している)、二番目の部分はシステムの WSGI file の場所 (下記参照) です。大抵はプロジェクトパッケージ (本例では mysite ) の内部です。これは、そのファイルで定義された WSGI アプリケーションを使用して、指定された URL 以下のすべての要求にサービスを提供するように Apache に指示します。

\n

プロジェクトにおける Python の依存パッケージ関係を virtualenv 内にインストールしている場合、 WSGIPythonHome を用いてそのパスを追加してください。詳細は mod_wsgi の virtualenv ガイド を参照ください。

\n

WSGIPythonPath の行は、プロジェクトのパッケージは Python のパス上でインポートすることが可能であることを保証します。言い換えると、 import mysite が動作することを保証します。

\n

<Directory> 部分により、Apache が wsgi.py ファイルにアクセスできるようになります。

\n

次に、この wsgi.py がWSGIアプリケーションのオブジェクトで存在することを確認する必要があります。 Djangoのバージョン1.4現在、 startproject を実行した際に作成されます ; それより前のバージョンでは、あなたはそれを作成する必要があります。 WSGI概要ドキュメント を参照し、デフォルトのコンテンツや、その他の必要な記載をこのファイルに追加してください。

\n\n\n
\n
\n

mod_wsgi をデーモンモードで使用するLink to this heading#

\n

デーモンモード はmod_wsgiを (Windows以外のプラットフォーム上で) 実行するための推奨モードです。必要なデーモンプロセスグループを作成し、その中で起動するための Djangoのインスタンスを委任するためには、適切な `` WSGIDaemonProcess`` と `` WSGIProcessGroup`` ディレクティブを追加する必要があります。デーモンモードを使用する場合には WSGIPythonPath を使用できないため、上記設定にさらなる変更が求められます。代わりに WSGIDaemonProcess に python-path オプションを使用する必要があります。例えば、

\n
Apache
WSGIDaemonProcess example.com python-home=/path/to/venv python-path=/path/to/mysite.com\nWSGIProcessGroup example.com\n
\n

サブディレクトリでプロジェクトを提供したい場合は(本例では https://example.com/mysite となります) 、 WSGIScriptAlias を設定の上部に追記します。

\n
Apache
WSGIScriptAlias /mysite /path/to/mysite.com/mysite/wsgi.py process-group=example.com\n
\n

詳細については、公式の mod_wsgi のドキュメント details on setting up daemon mode を参照してください。

\n
\n
\n

ファイルを配信するLink to this heading#

\n

Django 自体はファイルを配信せず、Web サーバにそのジョブを委ねます。

\n

メディアの配信には、Django を実行しているのとは別の Web サーバメディアを使用することをお勧めします。以下のサーバーは良い選択です。

\n\n

しかし、Django と同じ Apache の VirtualHost からメディアファイルを配信しなければならない場合には、一部の URL を静的メディアを配信するように設定し、その他の URL を Django への mod_wsgi のインターフェイスとして設定することができます。

\n

この例では、サイトのルートには Django を設定していますが、 robots.txt 、 favicon.ico 、 /static/ 、そして /media/ の URL 空間は静的ファイルとして配信しています。他のすべての URL は mod_wsgi を使用して配信されます。

\n
Apache
Alias /robots.txt /path/to/mysite.com/static/robots.txt\nAlias /favicon.ico /path/to/mysite.com/static/favicon.ico\n\nAlias /media/ /path/to/mysite.com/media/\nAlias /static/ /path/to/mysite.com/static/\n\n<Directory /path/to/mysite.com/static>\nRequire all granted\n</Directory>\n\n<Directory /path/to/mysite.com/media>\nRequire all granted\n</Directory>\n\nWSGIScriptAlias / /path/to/mysite.com/mysite/wsgi.py\n\n<Directory /path/to/mysite.com/mysite>\n<Files wsgi.py>\nRequire all granted\n</Files>\n</Directory>\n
\n

2.4 よりも古いバージョンの Apache を使用している場合は、 Require all granted を Allow from all に置き換え、さらにその行の上に Order deny,allow を追加します。

\n
\n
\n

admin ファイルを配信するLink to this heading#

\n

Django の開発サーバは、 django.contrib.staticfiles が INSTALLED_APPS に存在する場合、自動的に admin アプリケーション（およびその他のインストールされているアプリケーション）の静的ファイルを配信します。しかしながら、他のサーバ編成を利用している場合はこの限りではありません。Apache や使用しているメディアサーバを設定し、 admin のファイルを公開できるようにしなければなりません。

\n

admin ファイルは Django ディストリビューションの (django/contrib/admin/static/admin) にあります。

\n

django.contrib.staticfiles を使って admin ファイルを扱うことを 強く お勧 めします。 (前のセクションで概要を説明したように Web サーバを設定します。つまり collectstatic 管理コマンドを使って静的ファイルを STATIC_ROOT に集め、Web サーバが STATIC_ROOT を STATIC_URL の場所で公開するよう設定します) しかし以下では別の方法を 3 つ挙げましょう:

\n
    \n

  1. ドキュメントルートに admin の静的ファイルへのシンボリックを作ります。 (Apache の設定に +FollowSymLinks が必要になるでしょう)

    2. \n

  2. 上で示したように Alias ディレクティブを使って、適切な URL (おそらく STATIC_URL + admin/) から admin ファイルがある実際の場所へのエ イリアスを作ります。

    3. \n

  3. admin の静的ファイルをコピーし、 Apache のドキュメントルートに置きます。

    4. \n
\n
\n
\n

Django のユーザーデータベースに対する Apache からの認証Link to this heading#

\n

DjangoはApacheがDjangoの認証バックエンドに対して直接ユーザを認証できるようにハンドラを提供します。 mod_wsgi 認証ドキュメント を参照してください。

\n
","rootId":"how-to-use-django-with-apache-and-mod-wsgi","toc":[{"title":"基本設定","anchor":"basic-configuration","children":[]},{"title":"mod_wsgi をデーモンモードで使用する","anchor":"using-mod-wsgi-daemon-mode","children":[]},{"title":"ファイルを配信する","anchor":"serving-files","children":[]},{"title":"admin ファイルを配信する","anchor":"serving-the-admin-files","children":[]},{"title":"Django のユーザーデータベースに対する Apache からの認証","anchor":"authenticating-against-django-s-user-database-from-apache","children":[]}],"breadcrumbs":[{"docname":"howto/index","title":"「How-to」ガイド","url":"/ja/2.2/howto/"},{"docname":"howto/deployment/index","title":"Django をデプロイする","url":"/ja/2.2/howto/deployment/"},{"docname":"howto/deployment/wsgi/index","title":"WSGI とともにデプロイするには","url":"/ja/2.2/howto/deployment/wsgi/"}],"prev":{"docname":"howto/deployment/wsgi/uwsgi","title":"Django を uWSGI とともに使うには？","url":"/ja/2.2/howto/deployment/wsgi/uwsgi/"},"next":{"docname":"howto/deployment/wsgi/apache-auth","title":"Django のユーザーデータベースに対する Apache からの認証","url":"/ja/2.2/howto/deployment/wsgi/apache-auth/"},"formats":{"html":"/ja/2.2/howto/deployment/wsgi/modwsgi/","markdown":"/ja/2.2/howto/deployment/wsgi/modwsgi.md","json":"/ja/2.2/howto/deployment/wsgi/modwsgi.json"},"source":"https://github.com/django/django/blob/stable/2.2.x/docs/howto/deployment/wsgi/modwsgi.txt","official":"https://docs.djangoproject.com/ja/2.2/howto/deployment/wsgi/modwsgi/","inVersions":["6.1","6.0","5.2","5.1","5.0","4.2","4.1","4.0","3.2","3.1","3.0","2.2","2.1","2.0","1.11","1.10","1.9"],"inLocales":["en","zh-hans","fr","ja","id","pt-br","ko","es","el","pl"]}