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

关注

原创最新推荐文章于 2026-09-04 13:19:25 发布 199 阅读 AI 写同款· GEO 优化 ›

在 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发行版本可以自行参考该文件内容进行修改，或者自己写一个控制脚本，也不过举手之劳：

C代码

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

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