在Linux平台上安装和配置Ruby on Rails详解

在 Linux 平台上安装和配置 Ruby on Rails 详解

 

ruby on rails推荐的生产运行环境是Linux/FreeBSD/Unix，即Unix系列的操作系统，采用lighttpd＋FCGI的解决方案。以下我将以Linux操作系统，lighttpd＋FCGI，MySQL数据库为例，从源代码编译安装开始讲解。

 

在安装之前，应该确认Linux操作系统已经安装好gcc编译器，否则请用Linux安装光盘先行安装gcc编译器：

gcc –v

如能返回gcc版本号，则gcc正确安装。

 

一、安装 Ruby 解析器

 

一些Linux发行版本，MacOSX操作系统都自带Ruby解析器，但是我仍然建议自行下载ruby源代码编译安装。因为一方面可以自己定制ruby安装的路径，另一方面可以在编译过程中自行添加更多的特性。

 

ruby的源代码可以从Ruby官方网站下载：

http://www.ruby-lang.org/en/downloads/

 

下载源代码包到本地Linux主机，然后解压缩，进入该目录，进行配置，编译和安装：

tar xzvf ruby-1.8.5.tar.gz

cd ruby-1.8.5

./configure –prefix=/usr/local/ruby

make && make install

如果想浏览所有的configure参数，可以：

./configure –help |more

如果不定制安装的目录，默认将安装到/usr/local目录下面。然而我建议自行定制一个ruby的安装目录，例如/usr/local/ruby，这样便于以后的升级，不会和操作系统其他软件混在一起。

 

安装好以后，修改操作系统PATH路径，加入/usr/local/ruby/bin：

export PATH=/usr/local/ruby/bin:$PATH

将我们自己安装的ruby放在系统PATH前面，避免操作系统自带的ruby造成的干扰。在Linux上，一般将设置放在/etc/profile中，便于对全局生效。

 

二、安装 ruby on rails

 

在安装rails之前，要先安装rubygems。rubygems是ruby的在线包管理工具，可以从rubyforge下载rubygems：

http://rubyforge.org/projects/rubygems/

下载好源代码包，解压缩，安装：

tar xzvf rubygems-0.9.0.tgz

cd rubygems-0.9.0/

ruby setup.rb

 

然后就可以安装rails了，在确认服务器已经连接互联网的情况下执行：

gem install rails –y

即通过gem从rubyforge网站下载rails所有依赖包安装。

 

安装好rails以后，可以执行：

rails –v

确认一下rails的版本。

 

 

三、安装 ruby 的数据库适配器

 

rails发行包中已经自带纯ruby的MySQL数据库适配器，然而对于生产环境来说，我们仍然应该下载安装C版本的数据库适配器，以达到更好的性能。下载mysql-ruby-2.7.3.tar.gz：

http://www.tmtm.org/en/mysql/ruby/

tar xzvf mysql-ruby-2.7.3.tar.gz

cd mysql-ruby-2.7.3

ruby extconf.rb --with-mysql-dir=/opt/mysql5

make && make install

注意--with-mysql-dir应该指向MySQL数据库的安装路径，如果数据库服务器和Web服务器不在同一台机器上，那么Web服务器上也必须安装MySQL软件，因为ruby的C版本MySQL适配器需要在编译的时候联接MySQL的系统库。

 

 

四、安装 Ruby 的 FCGI 支持

 

由于ruby的fcgi支持库需要在编译的时候联接FCGI的系统库，因此我们需要先安装FCGI库，下载FCGI源代码发行包：

http://www.fastcgi.com/dist/

tar xzvf fcgi-2.4.0.tar.gz

cd fcgi-2.4.0

./configure --prefix=/usr/local/fcgi

make && make install

同样，将fcgi安装在自己指定的目录下，而不是默认的/usr/local，避免多个软件混在一起。

 

然后就可以安装ruby的fcgi支持库了，下载ruby-fcgi-0.8.7.tar.gz：

http://rubyforge.org/projects/fcgi/

tar xzvf ruby-fcgi-0.8.7.tar.gz

cd ruby-fcgi-0.8.7

ruby install.rb config -- --with-fcgi-include=/usr/local/fcgi/include --with-fcgi-lib=/usr/local/fcgi/lib

ruby install.rb setup

ruby install.rb install

 

五、安装 lighttpd Web Server

 

安装 Lighttpd

 

在安装lighttpd之前，应该确认操作系统已经安装pcre，即Perl兼容的规则表达式库：

rpm –qa |grep pcre

如果没有，请从Linux安装光盘里面安装。

 

然后下载lighttpd：

http://www.lighttpd.net/download/

tar xzvf lighttpd-1.4.13.tar.gz

cd lighttpd-1.4.13

./configure --prefix=/usr/local/lighttpd

 

configure完毕以后，会给出一个激活的模块和没有激活模块的清单，可以检查一下，是否自己需要的模块都已经激活，在enable的模块中一定要有“mod_rewrite”这一项，否则重新检查pcre是否安装。然后编译安装：

make && make install

 

编译后配置：

cp doc/sysconfig.lighttpd /etc/sysconfig/lighttpd

mkdir /etc/lighttpd

cp doc/lighttpd.conf /etc/lighttpd/lighttpd.conf

 

如果你的Linux是RedHat/CentOS，那么：

cp doc/rc.lighttpd.redhat /etc/init.d/lighttpd

如果你的Linux是SuSE，那么：

cp doc/rc.lighttpd /etc/init.d/lighttpd

如果你的Linux是ubuntu，那么需要自己创建启动脚本，lighttpd官方wiki上面已经给出来该脚本，地址在：

http://redmine.lighttpd.net/wiki/1/ScriptsUbuntu

其他Linux发行版本可以自行参考该文件内容进行修改，或者自己写一个控制脚本，也不过举手之劳：

#!/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 

 

然后修改/etc/init.d/lighttpd，把

LIGHTTPD_BIN=/usr/sbin/lighttpd

改为

LIGHTTPD_BIN=/usr/local/lighttpd/sbin/lighttpd

 

此脚本用来控制lighttpd的启动关闭和重起：

/etc/init.d/lighttpd start

/etc/init.d/lighttpd stop

/etc/init.d/lighttpd restart

 

如果你希望服务器启动的时候就启动lighttpd，那么：

chkconfig lighttpd on

 

这样lighttpd就安装好了，接下来需要配置lighttpd。

 

配置 Lighttpd

 

修改/etc/lighttpd/lighttpd.conf

 

1）server.modules

取消需要用到模块的注释，mod_rewrite，mod_access，mod_fastcgi，mod_simple_vhost，mod_cgi，mod_compress，mod_accesslog是一般需要用到的。

 

2）server.document-root, server.error-log，accesslog.filename需要指定相应的目录

 

3）用什么权限来运行lighttpd

server.username            = "nobody"

server.groupname           = "nobody"

从安全角度来说，不建议用root权限运行web server，可以自行指定普通用户权限。

 

4）静态文件压缩

compress.cache-dir         = "/tmp/lighttpd/cache/compress"

compress.filetype          = ("text/plain", "text/html","text/javascript","text/css")

可以指定某些静态资源类型使用压缩方式传输，节省带宽，对于大量AJAX应用来说，可以极大提高页面加载速度。

 

5）配置ruby on rails

 

最简单的配置如下：

$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")

      )

    )

 )

}

即由lighttpd启动10个FCGI进程，lighttpd和FCGI之间使用本机Unix Socket通信。

 

Lighttpd的FAQ：无法启动Ruby on Rails

 

FastCGI的启动脚本位于Rails应用目录下面public/dispatch.fcgi，如果无法启动Lighttpd，报告FastCGI错误，你可以尝试着手工运行该脚本cd public && ./dispatch.fcgi，看看是否可以运行。一般来说，很多人都是在Windows下面创建Rails项目，导致dispatch.fcgi脚本的ruby运行路径指向windows下面的ruby，部署到Linux上面就无法运行了，另外一方面Windows上面创建的Rails项目在Linux上面dispatch.fcgi没有可执行权限，所以也需要授予可执行权限。

 

 

六、安装 ImageMagick 和 RMagic

 

RMagic是ruby处理图片需要用到的库，很多ruby应用由于都涉及图片处理的功能，往往需要依赖RMagic，但安装ImageMagick和RMagic相当烦琐，需要特别的说明。

 

安装 ImageMagick

http://www.imagemagick.org

ImageMagick是用C语言实现的图形处理库，有Unix版本和Windows版本。对于Unix版本来说，安装比较麻烦些，另外不建议安装ImageMagick二进制版本，往往会导致缺少某些图片处理功能，导致RMagic安装失败。下载ImageMagick源代码，解压缩，配置：

tar xzvf ImageMagick-6.2.9-0.tar.gz

cd tar xzvf ImageMagick-6.2.9

./configure --prefix=/usr/local/ImageMagick

 

观察配置后给出来的支持图形格式，看看该图形格式支持是否是yes，如果不是，那么必须先安装该图形格式的本地库。例如，你应该检查是否已经安装如下rpm包：

rpm –qa |grep libpng

rpm –qa |grep libpng-devel

rpm –qa |grep libjpeg

rpm –qa |grep gd-devel

如果你希望支持tiff格式，还应该检查

rpm –qa |grep libtiff

如果没有安装，那么在Linux安装光盘找到相应rpm包安装上，再次configure直到确认需要的图形格式全部支持为止，然后编译安装：

make && make install

 

由于ImageMagic被安装在我们自行指定的/usr/local/ImageMagick，后面安装RMagic会找不到需要用到的ImageMagic的命令和库，因此需要配置一下操作系统：

 

编辑/etc/profile里面的PATH环境变量，在最后面加入：

export PATH=/usr/local/ruby/bin:/usr/local/ImageMagick/bin:$PATH

 

编辑/etc/ld.so.conf，加入：

/usr/local/ImageMagick/lib

执行命令：

ldconfig

将ImageMagick的库加入系统联接库

 

然后注销当前用户重新登录，便于环境变量修改生效，执行：

convert logo: logo.gif

看是否正确生成一个logo.gif的图片文件。

 

安装 RMagic

http://rubyforge.org/projects/rmagick/

在rubyfoge上面下载RMagic的源代码发行包，不要下载gem包，然后解压缩编译：

./configure

make && make install

 

如果配置和编译过程没有报错，即大功告成。

 

对于MacOSX来说，安装RMagic以上步骤会出错，请参考：

http://rmagick.rubyforge.org/install-osx.html

 

总体来说，ImageMagick和RMagic的安装很容易出错，安装起来比较困难，如果碰到无法解决的问题，可以通过Google寻求解决办法。

 

如果你在安装过程当中，遇到了什么问题，请看：Lighttpd和RoR安装配置的疑难解答

评论

32 楼 blackanger 2007-05-28  

fredzhang 写道

blackanger 写道

看到robbin在线，赶紧问一下：
刚刚在SuseLinux下照你的方法装Rubygems，在执行setup.rb的时候报错：/usr/local/Ruby/lib/ruby/site_ruby/1.8/rubygems/remote_fetcher.rb:4:in 'require':no such file to load -- zlib(LoadError)
指导我一下，谢谢了。。。

是因为你的zlib和ruby-zlib没有装
http://raa.ruby-lang.org/project/ruby-zlib
http://www.zlib.net/

已经解决啦，谢谢
主要是不熟悉linux，现在没问题啦

31 楼 fredzhang 2007-05-27  

blackanger 写道

看到robbin在线，赶紧问一下：
刚刚在SuseLinux下照你的方法装Rubygems，在执行setup.rb的时候报错：/usr/local/Ruby/lib/ruby/site_ruby/1.8/rubygems/remote_fetcher.rb:4:in 'require':no such file to load -- zlib(LoadError)
指导我一下，谢谢了。。。

是因为你的zlib和ruby-zlib没有装
http://raa.ruby-lang.org/project/ruby-zlib
http://www.zlib.net/

30 楼 linjie2007 2007-05-26  

为什么我的lighttpd.conf不能正常启动啊!
* Stopping web server lighttpd                                                                                       [ OK ]
* Starting web server lighttpd                                                                                       [ OK ]
root@ICD1348:~# 2007-05-25 20:53:05: (mod_fastcgi.c.1032) the fastcgi-backend /etc/lighttpd/www/public/dispatch.fcgi failed to start:
2007-05-25 20:53:05: (mod_fastcgi.c.1036) child exited with status 9 /etc/lighttpd/www/public/dispatch.fcgi
2007-05-25 20:53:05: (mod_fastcgi.c.1039) if you try do run PHP as FastCGI backend make sure you use the FastCGI enabled version.
You can find out if it is the right one by executing 'php -v' and it should display '(cgi-fcgi)' in the output, NOT (cgi) NOR (cli)
For more information check http://www.lighttpd.net/documentation/fastcgi.html#preparing-php-as-a-fastcgi-program
2007-05-25 20:53:05: (mod_fastcgi.c.1044) If this is PHP on Gentoo add fastcgi to the USE flags
2007-05-25 20:53:05: (mod_fastcgi.c.1340) [ERROR]: spawning fcgi failed.
2007-05-25 20:53:05: (server.c.849) Configuration of plugins failed. Going down.

29 楼 wtb 2007-05-26  

随便提一下lighttpd要pcre-devel包（系统默认可能只安装了pcre包，而没装pcre-devel包）

28 楼 lgn21st 2007-05-25  

第一次看到这篇文章的时候还在用Ubuntu6.10,自带ruby版本是1.8.4,有点旧了,采用手动从源代码编译ruby+gem安装rails,现在Ubuntu7.04自带ruby-1.8.5,用起来感觉很好，libmysql-ruby,libsqlite3-ruby这两个包解决了mysql和sqlite的native驱动问题，然后用gem安装rails，现在公司在线的应用都构建在这个上面，用起来真感觉不到跟源码编译出来的有太大差别。

27 楼 bugx 2007-05-23  

我想知道APACHE下搭建一个高效的环境详细的说明。

26 楼 blackanger 2007-05-14  

关于这份资料的详细未删节版本的原稿，可否给我发一份呢，谢谢robbin大哥了。。。
[e-mail]

25 楼 blackanger 2007-05-14  

看到robbin在线，赶紧问一下：
刚刚在SuseLinux下照你的方法装Rubygems，在执行setup.rb的时候报错：/usr/local/Ruby/lib/ruby/site_ruby/1.8/rubygems/remote_fetcher.rb:4:in 'require':no such file to load -- zlib(LoadError)
指导我一下，谢谢了。。。

24 楼 zgd 2007-05-06  

已经有个家伙想了一个办法把中文字体变成英文字体的宽度令到TextMate可以比原来更正常地显示中文(其实最初的方案是处理日文字体)。其实勉强可以接受的了

23 楼 robbin 2007-04-23  

d4rkl0rd 写道

我在MACOS10.4.8下安装非常简单，下个Locomotive安装非常简单，下一步下一步就行了，还带服务控制台，图形化的管理工具。。然后再下个TextMate。。爽呆了。。不过TextMate里的SQL管理如何调出来？一直没找到。

http://cocoamysql.sourceforge.net/

你找的就是这个开源项目，用MacOS的cocoa开发的。

TextMate现在比较大的问题就是中文显示，有望在textmate2.0里面解决，不过TextMate2.0只支持MacOS10.5。所以我得等，等MacOS10.5和TextMate2.0。

22 楼 d4rkl0rd 2007-04-23  

我在MACOS10.4.8下安装非常简单，下个Locomotive安装非常简单，下一步下一步就行了，还带服务控制台，图形化的管理工具。。然后再下个TextMate。。爽呆了。。不过TextMate里的SQL管理如何调出来？一直没找到。

21 楼 sina2009 2007-04-22  

请教ROBBIN
我的mod_compress已跟你说的一样设置了,但是我进这个/tmp/lighttpd/cache/compress后,里面没有任何文件
我的FCGI设的10,我的有些页面设了cache,但我查了一下LOG后好像根本就没有缓存
不知道是否我有哪里设置错误

20 楼 everloses 2007-04-11  

gigix 写道

sudo apt-get install rails
sudo apt-get install mysql
...
唯一麻烦的就是gem，apt装不到，只有down下来装

sudo apt-get install rubygems

19 楼 clark 2007-01-15  

robbin 写道

用ubuntu或者gentoo当然不是不可以。但是我写这篇文章在于指导如何在Linux Server上构建一个高性能的RoR生产运行环境，依赖ubuntu或者gentoo的自动二进制或者自动源代码安装，都达不到这个Production级别的要求。

生产环境的安装部署不是比谁安装起来貌似更加简单，毕竟相同的配置我可以把编译安装好的版本打成一个rpm包，以后安装只要一行rpm -ivh命令全部搞定，保管比你们的办法更简单。真要是炫耀谁的安装简单，那我用MacOSX10.5操作系统，自带ruby on rails全部运行环境，安装都省了，开机就可以跑起来了，不比你们简单多了？

自行手工安装的重点在于每个安装环节的定制，调优和补丁，配置的合理运用，以发挥最好的性能，最方便的维护，以及升级的灵活性。

选择gentoo从源代码完整构建一个操作系统对一个Linux fans来说貌似一件有趣的事情，但是站在工作的角度来说，管理员是完全不称职的。作为一台需要7*24*365运行的服务器来说，操作系统的稳定性，硬件软件应用的兼容性至关重要。为什么商业机构要花钱购买RHEL/SLES软件和服务，就是因为厂商对Kernel有针对性的打了很多补丁，调整了很多Kernel参数，对于整个Kernel＋GNU software搭配成的OS也进行了最大幅度的硬件兼容性认证，软件兼容性认证，以确保操作系统的稳定性和兼容性，最终能够达到7*24*365的需要。

gentoo 非常适合于开发环境，如果你对 linux 比较精通的话用于生产环境也很好。这不是比谁的安装更简单。用 gentoo 在给你优化后编译的同时也给了你最大的灵活性，可以做更好的优化。而不是简单的 make && make install。

对于需要7*24*365运行的服务器来说，如果只配1台，那么管理员是完全不称职的。这样的环境至少要配2台服务器。对于 gentoo 或 ubuntu，同样打了很多补丁，调整了很多Kernel参数，并经过广大用户在各种软硬件环境中使用一段时间后达到很高的稳定性和兼容性。

不要因为是开源的产品就都达不到这个Production级别的要求。这也太武断了吧！
如果是这样的话也不必用 ror, hibernate, spring 了。
其实选择有厂商支持的产品，大多时候是为失败找个借口而已。

你的优化在哪里？来晚了没看到，能再贴出来么。

18 楼 lighter 2007-01-14  

robbin 写道

用ubuntu或者gentoo当然不是不可以。但是我写这篇文章在于指导如何在Linux Server上构建一个高性能的RoR生产运行环境，依赖ubuntu或者gentoo的自动二进制或者自动源代码安装，都达不到这个Production级别的要求。

谢谢robbin的好文章;
以前一直只关心ruby/rails在linux开发怎样怎样地，很少关注安装配置的细节来构建一个性能的RoR生产运行环境...
好文章，收藏....

17 楼 rainbow686 2007-01-12  

按照你的方式我配置完lighttp启动的时候报错：
/etc/init.d/lighttpd: line 53: /etc/rc.status: No such file or directory
rc.status这个文件是干什么的？
我的linux是Ubuntu 6.06桌面版的

16 楼 macoo 2007-01-09  

写得很详细，不错！不知道Ubuntu下面和这个差多远？楼主有时间补补让帖子再升点值!

15 楼 thundercao 2007-01-08  

希望看到更多类似的文章

14 楼 mafa 2007-01-08  

我现在不管是生产还是开发环境都用NetBSD，稳定性上肯定没问题，速度上和Linux相差不多。

13 楼 ant21 2007-01-07  

Robbin 的这篇指南太好了，刚刚转到 ubuntu 下面，实在非常需要这样一篇文章。以前 Windows 下都用 InstantRails 的，一下转过来有点傻眼的样子，呵呵。