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