基本�置

为了�置基于 mod_python 的 Django，首先�安装有�用的 mod_python 模�的 Apache。这通常�味�应该有一个 LoadModule 指令在 Apache �置文件中。它看起�就�是这样：

LoadModule python_module /usr/lib/apache2/modules/mod_python.so

然�，编辑你的Apache的�置文件，添加如下内容：

<Location "/">
    SetHandler python-program
    PythonHandler django.core.handlers.modpython
    SetEnv DJANGO_SETTINGS_MODULE mysite.settings
    PythonDebug On
</Location>

�确�把 DJANGO_SETTINGS_MODULE 中的 mysite.settings 项目��与你的站点相应的内容。

它告诉 Apache，任何在 / 这个路径之�的 URL 都使用 Django 的 mod_python �处�。它 将 DJANGO_SETTINGS_MODULE 的值传递过去，使得 mod_python 知�这时应该使用哪个�置。

注�这里使用 <Location> 指令而�是 <Directory> 。�者用于指�你的文件系统中的一个�置，然而 <Location> 指�一个 Web 站点的 URL �置。

Apache �能�但会�行在你正常登录的环境中，也会�行在其它��的用户环境中；也�能会有��的文件路径或 sys.path。你需�告诉 mod_python 如何去寻找你的项目� Django 的�置。

PythonPath "['/path/to/project', '/path/to/django'] + sys.path"

你也�以加入一些其它指令，比如 PythonAutoReload Off 以��性能。查看 mod_python 文档获得详细的指令列表。

注�，你应该在���务器上设置 PythonDebug Off 。如果你使用 PythonDebug On 的�，在程�产生错误时，你的用户会看到难看的（并且是暴露的） Python 回溯信�。

�� Apache 之�所有对你的站点的请求（或者是当你用了 <VirtualHost> 指令�则是虚拟主机）都会由 Django �处�。

注�

如果你在一个比 / �置更深的�目录中部署 Django，它 �会 对你的 URL 进行修整。所以如果你的 Apache �置是�这样的：

<Location "/mysite/">
    SetHandler python-program
    PythonHandler django.core.handlers.modpython
    SetEnv DJANGO_SETTINGS_MODULE mysite.settings
    PythonDebug On
</Location>

则你的 所有 URL都�以 "/mysite/" 起始。基于这�原因我们通常建议将 Django，部署 在主机或虚拟主机的根目录。�外还有一个选择就是，你�以简�的将你的 URL �置转���下�这样：

urlpatterns = patterns('',
    (r'^mysite/', include('normal.root.urls')),
)

在�一个 Apache 的实例中�行多个 Django 程�

在�一个 Apache 实例中�行多个 Django 程�是完全�能的。当你是一个独立的 Web 开�人员并有多个��的客户时，你�能会想这么�。

���下�这样使用 VirtualHost 你�以实现：

NameVirtualHost *

<VirtualHost *>
    ServerName www.example.com
    # ...
    SetEnv DJANGO_SETTINGS_MODULE mysite.settings
</VirtualHost>

<VirtualHost *>
    ServerName www2.example.com
    # ...
    SetEnv DJANGO_SETTINGS_MODULE mysite.other_settings
</VirtualHost>

如果你需�在�一个 VirtualHost 中�行两个 Django 程�，你需�特别留�一下以 确� mod_python 的代�缓存�被弄得乱七八糟。使用 PythonInterpreter 指令�将� �的 <Location> 指令分别解释：

<VirtualHost *>
    ServerName www.example.com
    # ...
    <Location "/something">
        SetEnv DJANGO_SETTINGS_MODULE mysite.settings
        PythonInterpreter mysite
    </Location>

    <Location "/otherthing">
        SetEnv DJANGO_SETTINGS_MODULE mysite.other_settings
        PythonInterpreter mysite_other
    </Location>
</VirtualHost>

这个 PythonInterpreter 中的值���，��它们在两个 Location �中��。

用 mod_python �行一个开��务器

因为 mod_python 缓存预载入了 Python 的代�，当在 mod_python 上�布 Django 站点时，你� 改动了一次代�都需��� Apache 一次。这还真是件麻烦事，所以这有个办法���它：�� 加入 MaxRequestsPerChild 1 到�置文件中强制 Apache 在�个请求时都�新载入所有的 代�。但是��在产��务器上使用这个指令，这会撤销 Django 的特�。

如果你是一个用分散的 print 语�（我们就是这样）�调试的程�员，注�这 print 语 �在 mod_python 中是无效的；它�会�你希望的那样产生一个 Apache 日志。如果你需�在 mod_python 中打�调试信�，�能需�用到 Python 标准日志包（Pythons standard logging package）。 更多的信�请�� http://docs.python.org/lib/module-logging.html 。�一个选择是在模�页�中加入调试信�。

使用相�的Apache实例��务Django和Media文件

Django本身�用��务media文件；应该把这项工作留给你选择的网络�务器。我们推�使用一个�独的网络�务器（�没有�行Django的一个）��务media。想了解更多信�，看下�的章节。

�过，如果你没有其他选择，所以�能在�Django一样的Apache VirtualHost 上�务media文件，这里你�以针对这个站点的特定部分关闭mod_python：

<Location "/media/">
    SetHandler None
</Location>

将 Location 改�你的media文件所处的根目录。

你也�以使用 <LocationMatch> �匹�正则表达�。比如，下�的写法将Django定义到网站的根目录，并且显�地将 media �目录以�任何以 .jpg ， .gif ， 或者 .png 结尾的URL�蔽掉:

<Location "/">
    SetHandler python-program
    PythonHandler django.core.handlers.modpython
    SetEnv DJANGO_SETTINGS_MODULE mysite.settings
</Location>

<Location "/media/">
    SetHandler None
</Location>

<LocationMatch "\.(jpg|gif|png)$">
    SetHandler None
</LocationMatch>

在所有这些例�中，你必须设置 DocumentRoot ，这样apache�能知�你存放��文件的�置。

错误处�

当你使用 Apache/mod_python 时，错误会被 Django ��，它们�会传播到 Apache 那里，也�会出现在 Apache 的 错误日志 中。

有一个例外就是当确实你的 Django 设置混乱了时。在这�情况下，你会在�览器上看到一个 内部�务器错误的页�，并在 Apache 的 错误日志 中看到 Python 的完整回溯信�。 错误日志 的回溯信�有多行。当然，这些信�是难看且难以阅读的。

处�段错误

有时候，Apache会在你安装Django的时候�生段错误。这时，基本上 总是 有以下两个与Django本身无关的原因其中之一所造�：

• 有å�¯èƒ½æ˜¯å› ä¸ºï¼Œä½ ä½¿ç”¨äº† pyexpat 模å�—（进行XML解æž�）并且与Apache内置的版本相冲çª�。详情请è§� http://www.djangoproject.com/r/articles/expat-apache-crash/.

• 也有å�¯èƒ½æ˜¯åœ¨å�Œä¸€ä¸ªApache进程中，å�Œæ—¶ä½¿ç”¨äº†mod_python å’Œ mod_php，而且都使用MySQL作为数æ�®åº“å�Žç«¯ã€‚在有些情况下，这会造æˆ�PHPå’ŒPythonçš„MySQL模å�—的版本冲çª�。在mod_pythonçš„FAQ中有更详细的解释。 http://www.djangoproject.com/r/articles/php-modpython-faq/.

如果还有安装mod_python的问题，有一个好的建议，就是先��行mod_python站点，而�使用Django框架。这是区分mod_python特定问题的好方法。下�的这篇文章给出了更详细的解释。 http://www.djangoproject.com/r/articles/getting-modpython-working/.

下一个步骤应该是编辑一段测试代�，把你所有django相关代�import进去，你的views,models,URLconf,RSS�置，等等。把这些imports放进你的handler函数中，然�从�览器进入你的URL。如果这些导致了crash，你就�以确定是import的django代�引起了问题。�个去掉这些imports，直到��冲�，这样就能找到引起问题的那个模�。 深入了解�模�，看看它们的imports。�想获得更多帮助，�linux的ldconfig，Mac OS的otool和windows的ListDLLs（form sysInternals）都�以帮你识别共享�赖和�能的版本冲�。

�行你的 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弄�好的�往往会�生一些��上的问题。

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

./manage.py runfcgi [options]

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

你�以指定 socket 或者�时指定 host 和 port 。当你�创建Web�务器时，你�需�将�务器指�当你在�动FastCGI�务器时确定的socket或者host/port。

范例：

在TCP端�上�行一个线程�务器：

./manage.py runfcgi method=threaded host=127.0.0.1 port=3033

在Unix socket上�行prefork�务器：

./manage.py runfcgi method=prefork socket=/home/user/mysite.sock pidfile=django.pid

�动，但�作为��进程（在调试时比较方便）：

./manage.py runfcgi daemonize=false socket=/tmp/mysite.sock

kill `cat $PIDFILE`

#!/bin/bash

# Replace these three settings.
PROJDIR="/home/user/myproject"
PIDFILE="$PROJDIR/mysite.pid"
SOCKET="$PROJDIR/mysite.sock"

cd $PROJDIR
if [ -f $PIDFILE ]; then
    kill `cat -- $PIDFILE`
    rm -f -- $PIDFILE
fi

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。

# Connect to FastCGI via a socket/named pipe:
FastCGIExternalServer /home/user/public_html/mysite.fcgi -socket /home/user/mysite.sock

# Connect to FastCGI via a TCP host/port:
FastCGIExternalServer /home/user/public_html/mysite.fcgi -host 127.0.0.1:3033

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

FastCGI 和 lighttpd

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

确� mod_fastcgi 在模�列表中，它需�出现在 mod_rewrite 和 mod_access ，但是�在 mod_accesslog 之�。你也�能需� mod_alias 模�，��供管�所用的媒体资�。

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

server.document-root = "/home/user/public_html"
fastcgi.server = (
    "/mysite.fcgi" => (
        "main" => (
            # Use host / port instead of socket for TCP fastcgi
            # "host" => "127.0.0.1",
            # "port" => 3033,
            "socket" => "/home/user/mysite.sock",
            "check-local" => "disable",
        )
    ),
)
alias.url = (
    "/media/" => "/home/user/django/contrib/admin/media/",
)

url.rewrite-once = (
    "^(/media.*)$" => "$1",
    "^/favicon\.ico$" => "/media/favicon.ico",
    "^(/.*)$" => "/mysite.fcgi$1",
)

# If the hostname is 'www.example1.com'...
$HTTP["host"] == "www.example1.com" {
    server.document-root = "/foo/site1"
    fastcgi.server = (
       ...
    )
    ...
}

# If the hostname is 'www.example2.com'...
$HTTP["host"] == "www.example2.com" {
    server.document-root = "/foo/site2"
    fastcgi.server = (
       ...
    )
    ...
}

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

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

备注

如果你�使用�务器的�进程，你没有必�自己去�动FastCGI�务器。Apache会自动产生一些�进程，产生的数�按照需求和�置会有所��。

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

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

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

#!/usr/bin/python
import sys, os

# Add a custom Python path.
sys.path.insert(0, "/home/user/python")

# Switch to the directory of your project. (Optional.)
# os.chdir("/home/user/myproject")

# Set the DJANGO_SETTINGS_MODULE environment variable.
os.environ['DJANGO_SETTINGS_MODULE'] = "myproject.settings"

from django.core.servers.fastcgi import runfastcgi
runfastcgi(method="threaded", daemonize="false")

touch mysite.fcgi

�行在一��机�务器上

大多数的站点一开始都�行在�机�务器上，看起��图20-1这样的构架。

图 20-1：一个��务器的Django安装。

这对于�型和中型的站点�说还�错，并且也很便宜，一般�说，你�以在3000美元以下就�定一切。

然而，当��增加的时候，你会迅速陷入��软件的 资�争夺 之中。数�库�务器和Web�务器都 喜欢 自己拥有整个�务器资�，因此当被安装在�机上时，它们总会争夺相�的资�（RAM, CPU），它们更愿�独享资�。

通过把数�库�务器�移到第二�主机上，�以很容易地解决这个问题。这将在下一部分介�。

分离出数�库�务器

对于Django�说，把数�库�务器分离开�很容易：�需�简�地修改 DATABASE_HOST ，设置为新的数�库�务器的IP地�或者DNS域�。设置为IP地�总是一个好主�，因为使用DNS域�，还�牵涉到DNS�务器的��性连接问题。

使用了一个独立的数�库�务器以�，我们的构架��了图20-2。

图 20-2：将数�库移到�独的�务器上。

这里，我们开始步入 n-tier 构架。��被这个�所��，它�是说明了Web栈的��部分，被分离到了��的物�机器上。

我们��看，如果�现需��止一�的数�库�务器，考虑使用连接池和数�库备份(冗余）将是一个好主�。�幸的是，本书没有足够的时间�讨论这个问题，所以你�考数�库文档或者�社区求助。

�行一个独立的媒体�务器

使用�机�务器�然留下了一个大问题：处�动�内容的媒体资�，也是在�一�机器上完�的。

这两个活动是在��的�件下进行的，因此把它们强行凑和在�一�机器上，你��能获得很好的性能。下一步，我们�把媒体资�（任何 �是 由Django视图产生的东西）分离到别的�务器上（请看图20-3）。

图 20-3：分离出媒体�务器。

�想的情况是，这个媒体�务器是一个定制的Web�务器，为传���媒体资��了优化。lighttpd和tux (http://www.djangoproject.com/r/tux/) 都是�佳的选择，当然瘦身的Apache�务器也�以工作的很好。

对于拥有大���内容（照片�视频等）的站点�说，将媒体�务器分离出去显然有�更加��的�义，而且应该是扩大规模的时候所�采�的 第一步措施 。

这一步需�一点点技巧，Django的admin管�接�需�能够获得足够的���处�上传的媒体（通过设置 MEDIA_ROOT ）。如果媒体资�在�外的一��务器上，你需�获得通过网络写�作的��。

最简�的方案是使用NFS（网络文件系统）把媒体�务器的目录挂载到Web�务器上�。�� MEDIA_ROOT 设置正确，媒体的上传就�以正常工作。

实现负担�衡和数�冗余备份

现在，我们已�尽�能地进行了分解。这�三��务器的构架�以承�很大的��，比如�天1000万的点击率。如果还需�进一步地增加，你就需�开始增加冗余备份了。

这是个好主�。请看图 20-3，一旦三个�务器中的任何一个�生了故障，你就得关闭整个站点。因此在引入冗余备份的时候，你并��是增加了容�，�时也增加了��性。

我们首先�考虑Web�务器的点击�。把�一个Django的站点�制多份，在多�机器上�时�行很容易，我们也�需��时�行多�机器上的Apache�务器。

你还需��一个软件�帮助你在多��务器之间�衡网络��： ���衡器（load balancer） 。你�以购买昂贵的专有的硬件�衡器，当然也有一些高质�的开�的软件�衡器�供选择。

Apaches 的 mod_proxy 是一个�以考虑的选择，但�一个�置更棒的选择是：Perlbal (http://www.djangoproject.com/r/perlbal/) 。Perlbal是一个�衡器，�时也是一个��代�，它的开�者和memcached的开�者是�一拨人（请�13章）。

备注

如果你使用FastCGI，你�样�以分离��的web�务器，并在多�其他机器上�行FastCGI�务器�实现相�的负载�衡的功能。��的�务器就相当于是一个�衡器，而��的FastCGI�务进程代替了Apache/mod_python/Django�务器。

现在我们拥有了�务器集群，我们的构架慢慢演化，越�越��，如图20-4。

图 20-4：负载�衡的�务器设置。

值得一�的是，在图中，Web�务器指的是一个集群，�表示许多数�的�务器。一旦你拥有了一个��的�衡器，你就�以很方便地增加和删除��的Web�务器，而且�会造�任何网站��用的时间。

慢慢�大

下�的这些步骤都是上�最�一个的�体：

• 当你需è¦�更好的数æ�®åº“性能，你å�¯èƒ½éœ€è¦�增加数æ�®åº“的冗余æœ�务器。MySQL内置了备份功能；PostgreSQL应该看一下Slony (http://www.djangoproject.com/r/slony/) å’Œ pgpool (http://www.djangoproject.com/r/pgpool/) ，这两个分别是数æ�®åº“备份和连接池的工具。

• 如果å�•ä¸ªå�‡è¡¡å™¨ä¸�能达到è¦�求，你å�¯ä»¥å¢žåŠ æ›´å¤šçš„å�‡è¡¡å™¨ï¼Œå¹¶ä¸”使用轮训（round-robin）DNSæ�¥å®žçŽ°åˆ†å¸ƒè®¿é—®ã€‚

• 如果å�•å�°åª’体æœ�务器ä¸�够用，你å�¯ä»¥å¢žåŠ æ›´å¤šçš„媒体æœ�务器，并通过集群æ�¥åˆ†å¸ƒæµ�é‡�。

• 如果你需è¦�更多的高速缓存（cache），你å�¯ä»¥å¢žåŠ cacheæœ�务器。

• 在任何情况下，å�ªè¦�集群工作性能ä¸�好，你都å�¯ä»¥å¾€ä¸Šå¢žåŠ æœ�务器。

��了几次以�，一个大规模的构架会�图20-5。

图 20-5。大规模的Django安装。

尽管我们�是在�一层上展示了两到三��务器，你�以在上���地增加更多。

当你到了这一个阶段，你有一些选择。附录A有一些开�者关于大型系统的信�。如果你想�构建一个高��的Django站点，那值得一读。

RAM怎么也�嫌多

写这篇文章的时候，RAM的价格已��到了�G大约200美元。购买尽�能多的RAM，�在别的上�投资一点点。

高速的处�器并�会大幅度地�高性能；大多数的Web�务器90%的时间都浪费在了硬盘IO上。当硬盘上的数�开始交�，性能就急剧下�。更快速的硬盘�以改善这个问题，但是比起RAM�说，那太贵了。

如果你拥有多��务器，首�的是�在数�库�务器上增加内存。如果你能负担得起，把你整个数�库都放入到内存中。这�会很难。LJWorld.com等网站的数�库�存了大�从1989年起至今的报纸和文章，内存的消耗也�到2G。

下一步，最大化Web�务器上的内存。最�想的情况是，没有一��务器进行�盘交�。如果你达到了这个水平，你就能应付大多数正常的��。

�用 Keep-Alive

Keep-Alive 是HTTP�供的功能之一，它的目的是�许多个HTTP请求�用一个TCP连接，也就是�许在�一个TCP连接上�起多个HTTP请求，这样有效的��了�个HTTP请求都�新建立自己的TCP连接的开销。

这一眼看上去是好事，但它足以�死Django站点的性能。如果你从�独的媒体�务器上�用户�供�务，�个光顾你站点的用户都大约10秒钟左��出一次请求。这就使得HTTP�务器一直在等待下一次keep-alive 的请求，空闲的HTTP�务器和工作时消耗一样多的内存。

使用 memcached

尽管Django支�多���的cache��机制，没有一�的性能�以 接近 memcached。如果你有一个高��的站点，��犹豫，直接选择memcached。

�常使用memcached

当然，选择了memcached而�去使用它，你�会从中获得任何性能上的��。第13章将为你�供有用的信�：学习如何使用Django的cache框架，并且尽�能地使用它。大�的�抢��的高速缓存通常是一个站点在大��下正常工作的唯一瓶颈。

�加讨论

Django相关的�一个部分，从Linux到Apache到PostgreSQL或者MySQL背�，都有一个�常棒的社区支�。如果你真想从你的�务器上榨干最�1%的性能，加入开�社区寻求帮助。多数的自由软件社区�员都会很��地�供帮助。

别忘了Django社区。这本书谦逊的作者�是Django开�团队中的两��员。我们的社区有大�的�验�以�供。