mod_wsgi

mod_wsgi — это сервер WSGI, интегрированный с сервером Apache httpd. Современная команда mod_wsgi-express упрощает настройку и запуск сервера без необходимости написания конфигурации Apache httpd.

Тесно интегрирован с Apache httpd.
Поддерживает Windows напрямую.
Требует компилятор и заголовки Apache для установки.
Не требует настройки обратного прокси-сервера.

Эта страница описывает основы запуска mod_wsgi-express, а не более сложную установку и настройку с httpd. Обязательно ознакомьтесь с документацией mod_wsgi-express, mod_wsgi и Apache httpd, чтобы понять доступные функции.

Установка

Для установки mod_wsgi необходим компилятор и установленные заголовки сервера и разработки Apache. Если их нет, вы получите ошибку. Способ их установки зависит от операционной системы и менеджера пакетов, которые вы используете.

Создайте виртуальную среду, установите ваше приложение, затем установите mod_wsgi.

$ cd hello-app
$ python -m venv .venv
$ . .venv/bin/activate
$ pip install .  # install your application
$ pip install mod_wsgi

Запуск

Единственный аргумент для mod_wsgi-express указывает на скрипт, содержащий ваше приложение Flask, который должен называться application. Вы можете написать небольшой скрипт для импорта вашего приложения с этим именем или для его создания, если используется шаблон приложения.

wsgi.py

from hello import app

application = app

wsgi.py

from hello import create_app

application = create_app()

Теперь запустите команду mod_wsgi-express start-server.

$ mod_wsgi-express start-server wsgi.py --processes 4

Опция --processes указывает количество процессов-работников, которые нужно запустить; начальное значение может быть CPU * 2.

Логи для каждого запроса не отображаются в терминале. Если произошла ошибка, её информация записывается в файл журнала ошибок, отображаемый при запуске сервера.

Внедрение внешним образом

В отличие от других серверов WSGI в этих документах, mod_wsgi может запускаться от имени root для привязки к привилегированным портам, таким как 80 и 443. Однако он должен быть настроен на сброс разрешений к другому пользователю и группе для процессов-работников.

Например, если вы создали пользователя и группу hello, вы должны установить свою виртуальную среду и приложение как этого пользователя, а затем указать mod_wsgi на сброс к этому пользователю после запуска.

$ sudo /home/hello/.venv/bin/mod_wsgi-express start-server \
    /home/hello/wsgi.py \
    --user hello --group hello --port 80 --processes 4