在Linux平臺(tái)上安裝和配置Ruby on Rails詳解，講述了完整的安裝過(guò)程，本文提供相關(guān)的疑難解答

 

現(xiàn)在Nginx/Mongrel的部署方式越來(lái)越受歡迎了，很多人置疑Lighttpd/FastCGI，并且現(xiàn)在也涌現(xiàn)了一些比Mongrel性能更好的例如Thin，ebb等ruby應(yīng)用服務(wù)器，那Lighttpd/FastCGI真的過(guò)時(shí)了嗎？

大家有興趣可以看一下我這篇文章：RoR部署方案深度剖析，Lighttpd提供了很多其他Web服務(wù)器不具備的優(yōu)勢(shì)，可以最大化FastCGI的性能�，F(xiàn)在Mongrel/Thin/ebb都利用了一些多線程或者事件IO機(jī)制來(lái)提供并發(fā)性能，這是FastCGI所不具備的，但遺憾的是Rails框架是單線程的，最終還是必須單進(jìn)程單線程來(lái)執(zhí)行Rails請(qǐng)求，所以這些并發(fā)優(yōu)勢(shì)無(wú)用武之地。但一些其他Ruby的Web框架例如camping，weavers已經(jīng)開始支持ruby多線程，提供了比Rails好得多的性能，mongrel/ebb只有在這些web框架上面才能發(fā)揮其性能優(yōu)勢(shì)。

所以只要你還是用Rails框架，Lighttpd/FastCGI就是性能最好的部署方案。

有些人的ubuntu安裝的庫(kù)不全，比方說(shuō)缺少readline庫(kù)，缺少zlib庫(kù)，可能會(huì)導(dǎo)致自己手工編譯安裝ruby的失敗，那么就用apt-get先把庫(kù)安裝好。
 

RHEL/CentOS用戶可能要用yum安裝一下pcre/pcre-devel這兩個(gè)庫(kù)，ubuntu用戶用apt-get安裝一下，Linux熟手也可以自己下載源代碼編譯安裝，Pcre是Perl兼容的正則表達(dá)式庫(kù)，Lighttpd的Rewrite功能需要它。

如果你的Linux是ubuntu，那么需要自己創(chuàng)建啟動(dòng)腳本，lighttpd官方wiki上面已經(jīng)給出來(lái)一個(gè)該腳本示例，地址在：
http://redmine.lighttpd.net/wiki/1/ScriptsUbuntu

rc.lighttpd這個(gè)腳本是針對(duì)SuSE Linux寫的，此外還提供了一個(gè)rc.lighttpd.redhat是針對(duì)RedHat Linux寫的，你自己寫一個(gè)控制腳本，也不過(guò)是舉手之勞：

#!/bin/sh

case "$1" in 
  start)         
    /usr/local/lighttpd/sbin/lighttpd -f /etc/lighttpd/lighttpd.conf > /dev/null 2>&1
    ;;
  stop) 
    killall lighttpd
    ;;
  restart) 
   $0 stop
   sleep 1
   $0 start 
   ;;
  *) 
  echo "Usage: lighttpd.sh {start|stop|restart}" 
  ;; 
esac

exit 0 

創(chuàng)建一個(gè)shell腳本，內(nèi)容如上，chmod u+x lighttpd.sh，這個(gè)腳本就可以用來(lái)啟動(dòng)關(guān)閉和重起lighttpd了
 

Lighttpd啟動(dòng)之后默認(rèn)情況下會(huì)寫access log，error log，如果你啟動(dòng)了壓縮過(guò)程，還會(huì)把文件壓縮過(guò)的版本放在壓縮目錄下面，所以檢查一下你的lighttpd.conf配置文件，是不是這些目錄還沒(méi)有，或者路徑不對(duì)。

如果無(wú)法啟動(dòng)Rails，要學(xué)會(huì)自己看Lighttpd的error log和Rails項(xiàng)目的log目錄下面的fastcgi crash log，在這兩個(gè)log文件當(dāng)中可以找到出錯(cuò)原因。

其中一種常犯的錯(cuò)誤是：Rails項(xiàng)目在Windows上面創(chuàng)建和開發(fā)，最后部署到Linux Server上面。這種情況下dispatch.fcgi這個(gè)腳本的ruby解析器路徑是 #!c:/ruby/bin/ruby.exe 這個(gè)路徑在Linux上面肯定是錯(cuò)誤的，你可以改成#!/usr/bin/env ruby，或者干脆在Linux上面創(chuàng)建該Rails項(xiàng)目。

此外在windows上面創(chuàng)建的Rails項(xiàng)目，dispatch.fcgi沒(méi)有可執(zhí)行權(quán)限，這也需要你在Linux上面先賦予可執(zhí)行權(quán)限才行。你可以嘗試著手工運(yùn)行該腳本cd public && ./dispatch.fcgi，看看是否可以運(yùn)行。

我在前面安裝文檔中給出來(lái)的配置內(nèi)容如下：

$HTTP["host"] == "www.xxx.com" {
 server.document-root = "/yourrails/public"
 server.error-handler-404 = "/dispatch.fcgi"
 fastcgi.server = (".fcgi" =>
    ("localhost" =>
      ("min-procs" => 10,
       "max-procs" => 10,
       "socket" => "/tmp/lighttpd/socket/rails.socket",
       "bin-path" => "/yourrails/public/dispatch.fcgi",
       "bin-environment" => ("RAILS_ENV" => "production")
      )
    )
 )
}

就算照抄你要改改路徑吧？這個(gè)demo當(dāng)中的socket路徑是/tmp/lighttpd/socket/rails.socket，那你要照抄，先檢查一下有沒(méi)有/tmp/lighttpd/sock目錄總是應(yīng)該的吧？其實(shí)用啥路徑都無(wú)妨，關(guān)鍵就是別照抄，領(lǐng)會(huì)原理，根據(jù)自己的環(huán)境做相應(yīng)的調(diào)整。
 

在lighttpd的虛擬域配置里面有一項(xiàng)

 server.error-handler-404 = "/dispatch.fcgi"

意思是當(dāng)lighttpd找不到URL對(duì)應(yīng)的硬盤文件，就會(huì)調(diào)用Rails的dispatch.fcgi去處理該URL請(qǐng)求，這也是lighttpd訪問(wèn)Rails的主要方式，其性能比URL轉(zhuǎn)發(fā)要快。如果你在配置文件里面忽略了這一行，lighttpd就會(huì)直接返回404錯(cuò)誤，而不是交給Rails處理。
 

正常情況下，關(guān)閉Lighttpd以后，dispatch進(jìn)程就會(huì)銷毀，但是在dispatch進(jìn)程處理請(qǐng)求的時(shí)候關(guān)閉lighttpd，dispatch進(jìn)程并不會(huì)馬上關(guān)閉，而是處理完畢當(dāng)前請(qǐng)求，才會(huì)關(guān)閉掉。一些極端情況下，可能會(huì)導(dǎo)致dispatch進(jìn)程一直不關(guān)閉，dispatch進(jìn)程就會(huì)越來(lái)越多。解決辦法很簡(jiǎn)單 killall -9 dispatch.fcgi，只管殺進(jìn)程就好了。

這種情況下，Lighttpd只是連接遠(yuǎn)程服務(wù)器的TCP端口，而不負(fù)責(zé)啟動(dòng)dispatch.fcgi進(jìn)程，因此需要自己寫腳本啟動(dòng)關(guān)閉dispatch.fcgi進(jìn)程。lighttpd提供了一個(gè)spawn-fcgi的程序，可以用來(lái)啟動(dòng)dispatch.fcgi進(jìn)程，監(jiān)聽TCP端口，你可以自己寫一個(gè)shell腳本來(lái)完成這個(gè)工作。另外spawn-fcgi還可以啟動(dòng)dispatch.fcgi進(jìn)程，創(chuàng)建本機(jī)的unix socket端口，和本機(jī)lighttpd通訊，例如：

例如：

#!/bin/sh

DISPATCH_PATH=/yourrailsapp/public/dispatch.fcgi
SOCKET_PATH=/tmp/lighttpd/socket
RAILS_ENV=production
export RAILS_ENV

case "$1" in

  start)
    for num in 0 1 2 3 4 5 6 7 8 9
    do
     /usr/local/lighttpd/bin/spawn-fcgi -f $DISPATCH_PATH -s $SOCKET_PATH/rails.socket-$num
    done
    ;;

  stop)
    killall -9 dispatch.fcgi
    ;;

  restart)
    $0 stop
    $0 start
    ;;
  
  *) 
    echo "Usage: dispatch.sh {start|stop|restart}"
    ;;
  
esac

exit 0

執(zhí)行 ./dispatch.sh start 將啟動(dòng)10個(gè)dispatch.fcgi進(jìn)程，在/tmp/lighttpd/sock目錄下面創(chuàng)建了10個(gè)unix socket文件，然后配置lighttpd去連接這10個(gè)socket文件：

$HTTP["host"] =~ "www.xxx.com$" {
  server.document-root = "/yourrails/public"
  server.error-handler-404 = "/dispatch.fcgi"
  fastcgi.server = (".fcgi" =>
    (
      ("socket"=>"/tmp/lighttpd/socket/rails.socket-0"),
      ("socket"=>"/tmp/lighttpd/socket/rails.socket-1"),
      ("socket"=>"/tmp/lighttpd/socket/rails.socket-2"),
      ("socket"=>"/tmp/lighttpd/socket/rails.socket-3"),
      ("socket"=>"/tmp/lighttpd/socket/rails.socket-4"),
      ("socket"=>"/tmp/lighttpd/socket/rails.socket-5"),
      ("socket"=>"/tmp/lighttpd/socket/rails.socket-6"),
      ("socket"=>"/tmp/lighttpd/socket/rails.socket-7"),
      ("socket"=>"/tmp/lighttpd/socket/rails.socket-8"),
      ("socket"=>"/tmp/lighttpd/socket/rails.socket-9")     
    )
  )
}

這樣做的好處是，每次重新部署應(yīng)用，就不需要重起lighttpd了，只需要執(zhí)行自己的dispatch.sh來(lái)重起dispatch.fcgi進(jìn)程就可以了。同時(shí)也可以很好的解決上一個(gè)fastcgi進(jìn)程堆積的問(wèn)題。

如果遠(yuǎn)程部署，配置方式是一樣的，就是lighttp連接的端口改為：

("host"=>"192.168.0.1, "port"=>3001),
("host"=>"192.168.0.1, "port"=>3002),
......

dispatch.sh創(chuàng)建dispatch.fcgi進(jìn)程的時(shí)候，使用 -t 參數(shù)創(chuàng)建tcp端口，而不是 -s 創(chuàng)建unix socket文件即可。
 

例如你的rails應(yīng)用必須使用某個(gè)網(wǎng)站的子目錄，如：http://www.xxx.com/myapp，那么lighttpd的配置要進(jìn)行相應(yīng)的修改：

$HTTP["host"] == "www.xxx.com" {
  $HTTP["url"] =~ "^/myapp" {
    server.document-root = "/home/webroot/demo/public"
    alias.url = ("/myapp" => "/home/webroot/demo/public")
    server.error-handler-404 = "/myapp/dispatch.fcgi"
    fastcgi.server = ("/myapp/dispatch.fcgi" =>
        ("localhost" =>
          ("min-procs" => 1,
           "max-procs" => 10,
           "socket" => "/tmp/rails.socket",
           "check-local" => "disable",
           "bin-path" => "/home/webroot/demo/public/dispatch.fcgi",
           "bin-environment" => ("RAILS_ENV" => "production")
          )
        )
    )
  }
}

1、要使用$HTTP["url"]去匹配你要訪問(wèn)的子目錄，根據(jù)該子目錄進(jìn)行特定的配置。這樣做的好處是，你可以在一個(gè)虛擬域下面部署多個(gè)rails應(yīng)用，用子目錄分開就可以了。

2、使用alias.url來(lái)指定目錄別名，這可以保證你的靜態(tài)資源例如js，css，images訪問(wèn)路徑是正常的

3、server.error-handler-404 要加上前綴： "/myapp/dispatch.fcgi"

4、在fastcgi配置里面，也要匹配該URL，特別注意，應(yīng)該增加一項(xiàng)："check-local" => "disable"的配置項(xiàng)

在進(jìn)行如上配置以后，lighttpd已經(jīng)可以正常的處理子目錄了，但是Rails的routes仍然無(wú)法正常工作，這需要我們修改Rails的配置文件config/environment.rb，在最后面添加如下代碼：

class ActionController::AbstractRequest
  def relative_url_root
    '/myapp'
  end
end

修改Rails處理URL請(qǐng)求的默認(rèn)前綴。

好了，現(xiàn)在你可以打開瀏覽器測(cè)試一下了。
 

Rails的頁(yè)面緩存機(jī)制本質(zhì)上是動(dòng)態(tài)頁(yè)面靜態(tài)化技術(shù)，當(dāng)你第一次訪問(wèn)頁(yè)面的時(shí)候，在public目錄下面生成靜態(tài)頁(yè)面，后續(xù)同樣的請(qǐng)求，Web服務(wù)器將直接返回靜態(tài)頁(yè)面，不再轉(zhuǎn)發(fā)給Rails處理了。那么你如何讓W(xué)eb服務(wù)器知道一個(gè)動(dòng)態(tài)請(qǐng)求的URL應(yīng)該去尋找相應(yīng)的靜態(tài)頁(yè)面呢？這需要在lighttpd里面增加如下的配置：

 url.rewrite = ( "^/$" => "index.html", "^([^.]+)$" => "$1.html" )

將所有URL請(qǐng)求統(tǒng)統(tǒng)重寫為后綴.html的靜態(tài)頁(yè)面請(qǐng)求，如果lighttpd找不到該靜態(tài)頁(yè)面，就會(huì)觸發(fā)404，轉(zhuǎn)發(fā)給Rails的dispatch.fcgi處理。但是如果你的Rails應(yīng)用不使用Rails頁(yè)面緩存，則不要寫這個(gè)配置，以免不必要的增加lighttpd的負(fù)擔(dān)和增加處理請(qǐng)求的步驟。