• 使用FastCGI部署Django应用
    • FastCGI 简介
    • 运行你的 FastCGI 服务器
      • 停止FastCGI的行程
    • 在Apache中以FastCGI的方式使用Django
      • 指定 FastCGI Server 的位置
      • 使用mod_rewrite为FastCGI指定URL
    • FastCGI 和 lighttpd
      • 在一个lighttpd进程中运行多个Django站点
    • 在使用Apache的共享主机服务商处运行Django
      • 重启新产生的进程服务器

    使用FastCGI部署Django应用

    尽管将使用Apache和mod_python搭建Django环境是最具鲁棒性的，但在很多虚拟主机平台上，往往只能使用FastCGI

    此外，在很多情况下，FastCGI能够提供比mod_python更为优越的安全性和效能。 针对小型站点，相对于Apache来说FastCGI更为轻量级。

    FastCGI 简介

    如何能够由一个外部的应用程序很有效解释WEB 服务器上的动态页面请求呢？ 答案就是使用FastCGI! 它的工作步骤简单的描述起来是这样的：

    和mod_python一样，FastCGI也是驻留在内存里为客户请求返回动态信息,而且也免掉了像传统的CGI一样启动进程时候的时间花销。 但于mod_python不同之处是它并不是作为模块运行在web服务器同一进程内的，而是有自己的独立进程。

    为什么要在一个独立的进程中运行代码？

    在以传统的方式的几种以mod_*方式嵌入到Apache的脚本语言中（常见的例如： PHP，Python/mod_python和Perl/mod_perl），他们都是以apache扩展模块的方式将自身嵌入到Apache进程中的。

    每一个Apache进程都是一个Apache引擎的副本，它完全包括了所有Apache所具有的一切功能特性（哪怕是对Django毫无好处的东西也一并加载进来）。 而FastCGI就不一样了，它仅仅把Python和Django等必备的东东弄到内存中。

    依据FastCGI自身的特点可以看到，FastCGI进程可以与Web服务器的进程分别运行在不同的用户权限下。 对于一个多人共用的系统来说，这个特性对于安全性是非常有好处的，因为你可以安全的于别人分享和重用代码了。

    如果你希望你的Django以FastCGI的方式运行，那么你还必须安装 flup 这个Python库，这个库就是用于处理FastCGI的。 很多用户都抱怨 flup 的发布版太久了，老是不更新。 其实不是的，他们一直在努力的工作着，这是没有放出来而已。

    运行你的 FastCGI 服务器

    FastCGI是以客户机/服务器方式运行的，并且在很多情况下，你得自己去启动FastCGI的服务进程。 Web服务器（例如Apache,lighttpd等等）仅仅在有动态页面访问请求的时候才会去与你的Django-FastCGI进程交互。 因为Fast-CGI已经一直驻留在内存里面了的，所以它响应起来也是很快的。

    记录

    在虚拟主机上使用的话，你可能会被强制的使用Web server-managed FastCGI进程。 在这样的情况下，请参阅下面的“在Apache共享主机里运行Django”这一小节。

    web服务器有两种方式于FastCGI进程交互： 使用Unix domain socket(在win32里面是 命名管道 )或者使用TCP socket.具体使用哪一个，那就根据你的偏好而定了，但是TCP socket弄不好的话往往会发生一些权限上的问题。 What you choose is a manner of preference; a TCP socket is usually easier due to permissions issues.

    开始你的服务器项目，首先进入你的项目目录下（你的 manage.py 文件所在之处），然后使用 manage.py runfcgi 命令：

    1. ./manage.py runfcgi [options]

    想了解如何使用 runfcgi ，输入 manage.py runfcgi help 命令。

    你可以指定 socket 或者同时指定 host 和 port 。当你要创建Web服务器时，你只需要将服务器指向当你在启动FastCGI服务器时确定的socket或者host/port。

    范例：

    在TCP端口上运行一个线程服务器：
    1. ./manage.py runfcgi method=threaded host=127.0.0.1 port=3033
    在Unix socket上运行prefork服务器：
    1. ./manage.py runfcgi method=prefork socket=/home/user/mysite.sock pidfile=django.pid
    启动，但不作为后台进程（在调试时比较方便）：
    1. ./manage.py runfcgi daemonize=false socket=/tmp/mysite.sock

    停止FastCGI的行程

    如果你的FastCGI是在前台运行的，那么只需按Ctrl+C就可以很方便的停止这个进程了。 但如果是在后台运行的话，你就要使用Unix的 kill 命令来杀掉它。 然而，当你正在处理后台进程时，你会需要将其付诸于Unix kill的命令

    如果你在 manage.py runfcgi 中指定了 pidfile 这个选项，那么你可以这样来杀死这个FastCGI后台进程：

    1. kill `cat $PIDFILE`

    $PIDFILE 就是你在 pidfile 指定的那个。

    你可以使用下面这个脚本方便地重启Unix里的FastCGI守护进程：

    1. #!/bin/bash
    3. # Replace these three settings.
    4. PROJDIR="/home/user/myproject"
    5. PIDFILE="$PROJDIR/mysite.pid"
    6. SOCKET="$PROJDIR/mysite.sock"
    8. cd $PROJDIR
    9. if [ -f $PIDFILE ]; then
    10.     kill `cat -- $PIDFILE`
    11.     rm -f -- $PIDFILE
    12. fi
    14. exec /usr/bin/env -   PYTHONPATH="../python:.."   ./manage.py runfcgi socket=$SOCKET pidfile=$PIDFILE

    在Apache中以FastCGI的方式使用Django

    在Apache和FastCGI上使用Django，你需要安装和配置Apache，并且安装mod_fastcgi。 请参见Apache和mod_fastcgi文档： http://www.djangoproject.com/r/mod_fastcgi/ 。

    当完成了安装，通过 httpd.conf （Apache的配置文件）来让Apache和Django FastCGI互相通信。 你需要做两件事：

    • 使用 FastCGIExternalServer 指明FastCGI的位置。

    • 使用 mod_rewrite 为FastCGI指定合适的URL。

    指定 FastCGI Server 的位置

    FastCGIExternalServer 告诉Apache如何找到FastCGI服务器。 按照FastCGIExternalServer 文档（ http://www.djangoproject.com/r/mod_fastcgi/FastCGIExternalServer/ ），你可以指明 socket 或者 host 。以下是两个例子：

    1. # Connect to FastCGI via a socket/named pipe:
    2. FastCGIExternalServer /home/user/public_html/mysite.fcgi -socket /home/user/mysite.sock
    4. # Connect to FastCGI via a TCP host/port:
    5. FastCGIExternalServer /home/user/public_html/mysite.fcgi -host 127.0.0.1:3033

    在这两个例子中， /home/user/public_html/ 目录必须存在，而 /home/user/public_html/mysite.fcgi 文件不一定存在。 它仅仅是一个Web服务器内部使用的接口，这个URL决定了对于哪些URL的请求会被FastCGI处理（下一部分详细讨论）。 （下一章将会有更多有关于此的介绍）

    使用mod_rewrite为FastCGI指定URL

    第二步是告诉Apache为符合一定模式的URL使用FastCGI。 为了实现这一点，请使用mod_rewrite 模块，并将这些URL重定向到 mysite.fcgi （或者正如在前文中描述的那样，使用任何在 FastCGIExternalServer 指定的内容）。

    在这个例子里面，我们告诉Apache使用FastCGI来处理那些在文件系统上不提供文件(译者注：

    1. <VirtualHost 12.34.56.78>
    2.   ServerName example.com
    3.   DocumentRoot /home/user/public_html
    4.   Alias /media /home/user/python/django/contrib/admin/media
    5.   RewriteEngine On
    6.   RewriteRule ^/(media.*)$ /$1 [QSA,L]
    7.   RewriteCond %{REQUEST_FILENAME} !-f
    8.   RewriteRule ^/(.*)$ /mysite.fcgi/$1 [QSA,L]
    9. </VirtualHost>

    FastCGI 和 lighttpd

    lighttpd (http://www.djangoproject.com/r/lighttpd/) 是一个轻量级的Web服务器，通常被用来提供静态页面的访问。 它天生支持FastCGI，因此除非你的站点需要一些Apache特有的特性，否则，lighttpd对于静态和动态页面来说都是理想的选择。

    确保 mod_fastcgi 在模块列表中，它需要出现在 mod_rewrite 和 mod_access ，但是要在 mod_accesslog 之前。

    将下面的内容添加到你的lighttpd的配置文件中：

    1. server.document-root = "/home/user/public_html"
    2. fastcgi.server = (
    3.     "/mysite.fcgi" => (
    4.         "main" => (
    5.             # Use host / port instead of socket for TCP fastcgi
    6.             # "host" => "127.0.0.1",
    7.             # "port" => 3033,
    8.             "socket" => "/home/user/mysite.sock",
    9.             "check-local" => "disable",
    10.         )
    11.     ),
    12. )
    13. alias.url = (
    14.     "/media/" => "/home/user/django/contrib/admin/media/",
    15. )
    17. url.rewrite-once = (
    18.     "^(/media.*)$" => "$1",
    19.     "^/favicon\.ico$" => "/media/favicon.ico",
    20.     "^(/.*)$" => "/mysite.fcgi$1",
    21. )

    在一个lighttpd进程中运行多个Django站点

    lighttpd允许你使用条件配置来为每个站点分别提供设置。 为了支持FastCGI的多站点，只需要在FastCGI的配置文件中，为每个站点分别建立条件配置项：

    1. # If the hostname is 'www.example1.com'...
    2. $HTTP["host"] == "www.example1.com" {
    3.     server.document-root = "/foo/site1"
    4.     fastcgi.server = (
    5.        ...
    6.     )
    7.     ...
    8. }
    10. # If the hostname is 'www.example2.com'...
    11. $HTTP["host"] == "www.example2.com" {
    12.     server.document-root = "/foo/site2"
    13.     fastcgi.server = (
    14.        ...
    15.     )
    16.     ...
    17. }

    你也可以通过 fastcgi.server 中指定多个入口，在同一个站点上实现多个Django安装。 请为每一个安装指定一个FastCGI主机。

    在使用Apache的共享主机服务商处运行Django

    许多共享主机的服务提供商不允许运行你自己的服务进程，也不允许修改 httpd.conf 文件。 尽管如此，仍然有可能通过Web服务器产生的子进程来运行Django。

    记录

    如果你要使用服务器的子进程，你没有必要自己去启动FastCGI服务器。 Apache会自动产生一些子进程，产生的数量按照需求和配置会有所不同。

    在你的Web根目录下，将下面的内容增加到 .htaccess 文件中：

    1. AddHandler fastcgi-script .fcgi
    2. RewriteEngine On
    3. RewriteCond %{REQUEST_FILENAME} !-f
    4. RewriteRule ^(.*)$ mysite.fcgi/$1 [QSA,L]

    接着，创建一个脚本，告知Apache如何运行你的FastCGI程序。 创建一个 mysite.fcgi 文件，并把它放在你的Web目录中，打开可执行权限。

    1. #!/usr/bin/python
    2. import sys, os
    4. # Add a custom Python path.
    5. sys.path.insert(0, "/home/user/python")
    7. # Switch to the directory of your project. (Optional.)
    8. # os.chdir("/home/user/myproject")
    10. # Set the DJANGO_SETTINGS_MODULE environment variable.
    11. os.environ['DJANGO_SETTINGS_MODULE'] = "myproject.settings"
    13. from django.core.servers.fastcgi import runfastcgi
    14. runfastcgi(method="threaded", daemonize="false")

    重启新产生的进程服务器

    如果你改变了站点上任何的python代码，你需要告知FastCGI。 但是，这不需要重启Apache，而只需要重新上传 mysite.fcgi 或者编辑改文件，使得修改时间发生了变化，它会自动帮你重启Django应用。 你可以重新上传mysite.fcgi或者编辑这个文件以改变该文件的时间戳。 当阿帕奇服务器发现文档被更新了，它将会为你重启你的Django应用。

    如果你拥有Unix系统命令行的可执行权限，只需要简单地使用 touch 命令：

    1. touch mysite.fcgi