FastCGI

Создание файла .fcgi

Сначала вам нужно создать файл сервера FastCGI. Назовём его yourapplication.fcgi:

#!/usr/bin/python
from flup.server.fcgi import WSGIServer
from yourapplication import app

if __name__ == '__main__':
    WSGIServer(app).run()

Этого достаточно для работы Apache, однако nginx и более старые версии lighttpd требуют, чтобы сокет явно передавался для связи с сервером FastCGI. Для этого вам нужно передать путь к сокету в WSGIServer:

WSGIServer(application, bindAddress='/path/to/fcgi.sock').run()

Путь должен быть точно таким же, как вы определяете в конфигурации сервера.

Сохраните файл yourapplication.fcgi в месте, где вы сможете его найти. Имеет смысл разместить его в /var/www/yourapplication или в чём-то подобном.

Убедитесь, что на этом файле установлен исполняемый бит, чтобы серверы могли его выполнить:

$ chmod +x /var/www/yourapplication/yourapplication.fcgi

Настройка Apache

Приведённый выше пример достаточно хорош для базового развертывания Apache, но файл .fcgi будет отображаться в вашем URL-адресе приложения, например example.com/yourapplication.fcgi/news/. Есть несколько способов настроить приложение так, чтобы yourapplication.fcgi не отображался в URL-адресе. Предпочтительный способ — использовать директивы конфигурации ScriptAlias и SetHandler для перенаправления запросов на сервер FastCGI. Следующий пример использует FastCgiServer для запуска 5 экземпляров приложения, которое будет обрабатывать все входящие запросы:

LoadModule fastcgi_module /usr/lib64/httpd/modules/mod_fastcgi.so

FastCgiServer /var/www/html/yourapplication/app.fcgi -idle-timeout 300 -processes 5

<VirtualHost *>
    ServerName webapp1.mydomain.com
    DocumentRoot /var/www/html/yourapplication

    AddHandler fastcgi-script fcgi
    ScriptAlias / /var/www/html/yourapplication/app.fcgi/

    <Location />
        SetHandler fastcgi-script
    </Location>
</VirtualHost>

Эти процессы будут управляться Apache. Если вы используете автономный сервер FastCGI, вы можете использовать директиву FastCgiExternalServer вместо неё. Обратите внимание, что в следующем примере путь не является реальным, он просто используется как идентификатор для других директив, таких как AliasMatch:

FastCgiServer /var/www/html/yourapplication -host 127.0.0.1:3000

Если вы не можете установить ScriptAlias, например, на общем веб-хостинге, вы можете использовать WSGI-прослойку для удаления yourapplication.fcgi из URL-адресов. Настройте .htaccess:

<IfModule mod_fcgid.c>
   AddHandler fcgid-script .fcgi
   <Files ~ (\.fcgi)>
       SetHandler fcgid-script
       Options +FollowSymLinks +ExecCGI
   </Files>
</IfModule>

<IfModule mod_rewrite.c>
   Options +FollowSymlinks
   RewriteEngine On
   RewriteBase /
   RewriteCond %{REQUEST_FILENAME} !-f
   RewriteRule ^(.*)$ yourapplication.fcgi/$1 [QSA,L]
</IfModule>

Настройте yourapplication.fcgi:

#!/usr/bin/python
#: optional path to your local python site-packages folder
import sys
sys.path.insert(0, '<your_local_path>/lib/python<your_python_version>/site-packages')

from flup.server.fcgi import WSGIServer
from yourapplication import app

class ScriptNameStripper(object):
   def __init__(self, app):
       self.app = app

   def __call__(self, environ, start_response):
       environ['SCRIPT_NAME'] = ''
       return self.app(environ, start_response)

app = ScriptNameStripper(app)

if __name__ == '__main__':
    WSGIServer(app).run()

Настройка lighttpd

Базовая конфигурация FastCGI для lighttpd выглядит следующим образом:

fastcgi.server = ("/yourapplication.fcgi" =>
    ((
        "socket" => "/tmp/yourapplication-fcgi.sock",
        "bin-path" => "/var/www/yourapplication/yourapplication.fcgi",
        "check-local" => "disable",
        "max-procs" => 1
    ))
)

alias.url = (
    "/static/" => "/path/to/your/static/"
)

url.rewrite-once = (
    "^(/static($|/.*))$" => "$1",
    "^(/.*)$" => "/yourapplication.fcgi$1"
)

Не забудьте включить модули FastCGI, alias и rewrite. Эта конфигурация привязывает приложение к /yourapplication. Если вы хотите, чтобы приложение работало в корне URL, вам нужно обойти ошибку lighttpd с помощью LighttpdCGIRootFix прослойки.

Убедитесь, что применяете её только в том случае, если вы устанавливаете приложение в корне URL. Также см. документацию Lighttpd для получения дополнительной информации о FastCGI и Python (обратите внимание, что явное указание сокета для запуска уже не требуется).

Настройка nginx

Установка приложений FastCGI в nginx немного отличается, так как по умолчанию параметры FastCGI не передаются.

Базовая конфигурация Flask FastCGI для nginx выглядит следующим образом:

location = /yourapplication { rewrite ^ /yourapplication/ last; }
location /yourapplication { try_files $uri @yourapplication; }
location @yourapplication {
    include fastcgi_params;
    fastcgi_split_path_info ^(/yourapplication)(.*)$;
    fastcgi_param PATH_INFO $fastcgi_path_info;
    fastcgi_param SCRIPT_NAME $fastcgi_script_name;
    fastcgi_pass unix:/tmp/yourapplication-fcgi.sock;
}

Эта конфигурация привязывает приложение к /yourapplication. Если вы хотите иметь его в корне URL, это немного проще, так как вам не нужно вычислять PATH_INFO и SCRIPT_NAME:

location / { try_files $uri @yourapplication; }
location @yourapplication {
    include fastcgi_params;
    fastcgi_param PATH_INFO $fastcgi_script_name;
    fastcgi_param SCRIPT_NAME "";
    fastcgi_pass unix:/tmp/yourapplication-fcgi.sock;
}

Запуск процессов FastCGI

Поскольку nginx и другие не загружают приложения FastCGI, вам нужно сделать это самостоятельно. Supervisor может управлять процессами FastCGI. Вы можете поискать другие менеджеры процессов FastCGI или написать скрипт для запуска вашего файла .fcgi при запуске системы, например, используя скрипт SysV init.d. Для временного решения вы всегда можете запустить скрипт .fcgi внутри GNU screen. См. man screen для получения подробностей, и обратите внимание, что это ручное решение, которое не сохраняется при перезагрузке системы:

$ screen
$ /var/www/yourapplication/yourapplication.fcgi

Отладка

Развёртывание FastCGI часто трудно отлаживать на большинстве веб-серверов. Зачастую единственное, что сообщает серверный журнал, — это что-то вроде «преждевременное завершение заголовков». Для отладки приложения единственное, что действительно может дать вам понять, почему оно не работает, — это переключение на правильного пользователя и запуск приложения вручную.

Этот пример предполагает, что ваше приложение называется application.fcgi, а пользователь вашего веб-сервера — www-data:

$ su www-data
$ cd /var/www/yourapplication
$ python application.fcgi
Traceback (most recent call last):
  File "yourapplication.fcgi", line 4, in <module>
ImportError: No module named yourapplication

В этом случае ошибка, похоже, состоит в том, что «yourapplication» не находится на пути Python. Распространённые проблемы:

• Использование относительных путей. Не полагайтесь на текущую рабочую директорию.
• Код зависит от переменных окружения, которые не установлены веб-сервером.
• Используются разные интерпретаторы Python.