http://huichen.org/2010/03/12/configure-fastcgi-for-nginx/
這是一篇講述怎樣在Nginx下配置fastcgi的文章。
適用
Nginx通過fastcgi調用python, Perl和C++等寫的CGI程序。PHP有PHP-FPM (FastCGI Process Manager)，這個對PHP來說更好的FastCGI進程管理器，關于PHP-FPM的更多信息，請Google php-fpm+nginx。
原理
Nginx并不提供支持對外部程序的直接調用或者解析（所以缺少像apache里的mod_php這樣的模塊），所有的外部程序（包括PHP）必須通過fastcgi接口來調用，在Linux下接口是socket （文件socket或者Internet socket）。所以為了調用CGI程序，我們需要一個fastcgi的wrapper，這個wrapper綁定在某個固定socket上（比如端口或者文件socket），當nginx將CGI請求發送給這個socket的時候，wrapper接納請求并fork一個新的線程，這個線程調用外部的程序或者解釋器處理腳本并讀取返回值，而wrapper再將返回的數據（網頁或者圖片等）通過fastcgi將數據通過那個固定的socket傳遞給nginx。示意圖如下：
Ningx的FastCGI原理
所以，我們首先需要一個wrapper，這個wrapper需要完成的工作：
1. 通過調用fastcgi（庫）的函數通過socket和ningx通信（讀寫socket是fastcgi內部實現的功能，對wrapper是非透明的）
2. 調度thread，進行fork和kill
3. 和application進行通信
Wrapper的實現
在Nginx的官方wiki中給出了一個Perl寫的wrapper例子，顯然這需要安裝Perl和必要的module（比如FCGI）。為了追求效率，我們希望有一個C寫的wrapper。我找到了這個fcgiwrap項目。
只有wrapper還是不夠的，我們需要一個腳本來建立socket，啟動wrapper以及將wrapper和socket綁定。你可以從我的服務器上下載這個C的wrapper和啟動腳本。啟動腳本spawn-fcgi的內容如下：
幫助
| 01 02 03 04 05 06 07 08 09 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 | #!/usr/bin/perl use strict; use warnings FATAL => qw( all ); use IO::Socket::UNIX; my $bin_path = '/usr/sbin/fcgiwrap'; my $socket_path = $ARGV[0] || '/var/run/nginx/nginx-fcgi.sock'; my $num_children = $ARGV[1] || 4; close STDIN; unlink $socket_path; my $socket = IO::Socket::UNIX->new( Local => $socket_path, Listen => 100, ); die "Cannot create socket at $socket_path: $!\n" unless $socket; for (1 .. $num_children) { my $pid = fork; die "Cannot fork: $!" unless defined $pid; next if $pid; exec $bin_path; die "Failed to exec $bin_path: $!\n"; } |
你需要修改腳本中高亮的三行，分別是你編譯后的fcgiwrap執行文件，domain socket的位置和同時運行的fcgiwrap進程的個數。后兩個參數也可以通過調用spawn-fcgi的命令行傳遞。
建議你用www-data或者nginx等低權限帳號而不是root來運行這個spawn-fcgi腳本，這要求該帳號能夠讀寫那個socket文件所在的文件夾（上面的例子中是 /var/run/nginx/ ）。
如果你的機器沒有Perl，你可以下載編譯一個C寫的spawn-fcgi （本地備份），這是lighttpd中的一個子項目，調用這個C版本的spawn-fcgi時可以通過命令行指定domain socket等信息。
Nginx配置
相應地，nginx中需要做如下配置。在你的site文件的server{…}中加入：
幫助
| 01 02 03 04 05 06 07 08 09 10 11 12 13 14 15 16 17 18 19 20 21 22 23 | location ~ ^.+\.cgi$ { root /var/www/yoursite.com; gzip off; #gzip makes scripts feel slower since they have to complete before getting gzipped fastcgi_pass unix:/var/run/nginx/nginx-fcgi.sock; fastcgi_read_timeout 5m; fastcgi_param SCRIPT_FILENAME /var/www/yoursite$fastcgi_script_name; fastcgi_param QUERY_STRING $query_string; fastcgi_param REQUEST_METHOD $request_method; fastcgi_param CONTENT_TYPE $content_type; fastcgi_param CONTENT_LENGTH $content_length; fastcgi_param SCRIPT_NAME $fastcgi_script_name; fastcgi_param REQUEST_URI $request_uri; fastcgi_param DOCUMENT_URI $document_uri; fastcgi_param DOCUMENT_ROOT $document_root; fastcgi_param SERVER_PROTOCOL $server_protocol; fastcgi_param GATEWAY_INTERFACE CGI/1.1; fastcgi_param SERVER_SOFTWARE Nginx; fastcgi_param REMOTE_ADDR $remote_addr; fastcgi_param REMOTE_PORT $remote_port; fastcgi_param SERVER_ADDR $server_addr; fastcgi_param SERVER_PORT $server_port; fastcgi_param SERVER_NAME $server_name; } |
你需要把上面高亮的三行修改為你的配置。注意root一行是必須的，否則wrapper會報錯。
此條目發表在 互聯網 分類目錄，貼了 cgi, domain socket, fastcgi, lighttpd, nginx, php, php-fpm, wrapper 標簽。將固定鏈接加入收藏夾。
← PhotonVPS 測評
trAlyzr: 一個測試網站響應速度的工具包 →
《Nginx下配置FastCGI》有 1 條評論
1. 
dengx 說：
四月 23, 20109:31 下午
看了這個個圖，思路清晰了很多，以前對fastcgi和wrapper之間的關系很模糊。