源碼編譯安裝Nginx

2010-05-06 12:20

轉：http://docs.google.com/View?docid=dhf86kr9_302cssf49dh&hgd=1

Nginx ("engine x") 是一個高性能的 HTTP 和 反向代理 服務器，相對Apache的臃腫，Nginx絕對是輕量級的，配置簡單，本篇文章介紹如何在Ubuntu Hardy 上用源，碼來編譯Nginx。

1、選擇版本

選 擇從源碼編譯Nginx的大多數緣由是能夠採用最新的版本，而不侷限於aptitude安裝的舊版本，在寫本文的時候，Nginx的最新穩定版本是 0.6.31（你能夠到 Nginx的官方站點查看最新版本），而aptitude安裝的是0.5.33版本。
固然，採用源碼編譯會比aptitude麻煩一些，之後更新都須要DIY，若是你喜歡方便，且對版本不是很敏感的話，你能夠參考前 面一篇文章「使用aptitude安裝Nginx」採用aptitude來安裝。

2、注意目錄結構

須要注意的是，採用aptitude安裝Nginx和從源碼編譯安裝的Nginx的時候，目錄結構是有 所不一樣的，使用aptitude安裝的Nginx會在其安裝目錄中建立'sites-available' 和 'sites-enabled'目錄（貌似想Ubuntu上的Apache安裝目錄結構），而從源碼編譯的時候，並不會自動建立這兩個目錄的，後面咱們會 說如何修改使得其達到一致（雖然能夠不用修改，可是把每一個web的配置放到一個配置文件中，總比混合在一塊兒好）。

3、依賴關係

採用aptitude安裝的時候，系統會將全部依賴的包都一併裝上，可是使 用源碼編譯的時候就沒這麼智能了，咱們須要找到須要的依賴包，而後手工安裝，幸運的是，這並不複雜，也很少，例如pcre, ssl 和zlib，安裝方法比較簡單：

sudo aptitude install libpcre3 libpcre3-dev libpcrecpp0 libssl-dev zlib1g-dev

4、安裝Nginx

ok，準備工做作完了，是時候開始下載、 安裝Nginx了。
一、建立一個目錄

mkdir ~/sources
cd ~/sources/

二、 下載源代碼

wget http://sysoev.ru/nginx/nginx-0.6.31.tar.gz

三、 解壓

tar -zxvf nginx-0.6.31.tar.gz
...
cd nginx-0.6.31/

四、選擇須要的編譯選項
Nginx的編譯選項仍是很多 的，你能夠參考Nginx wiki的 Install Options 這個頁面或者我下面的附錄1來了解每一個選項的詳細信息，基本上都是定製位置和模塊的，這裏就是要兩個模塊就夠了（要是你有本身的需求，本身DIY），分別 是：
1）--sbin-path=/usr/local/sbin
從源碼編 譯Nginx會安裝在/usr/local/nginx目錄下（你可使用參數--prefix=<path>指定本身須要的位置），而後會 將bin文件放在/usr/local/nginx/sbin/nginx，雖然比較清晰，可是和咱們通常的習慣不一樣（咱們習慣在/usr/local /sbin下尋找bin文件）；
2）--with-http_ssl_module
這個沒啥好說的，主要是提供https訪問支持的。

五、 Compile

./configure --sbin-path=/usr/local/sbin --with-http_ssl_module

編 譯的時間不會很長，完成的時候你會在屏幕上看到相似下面的信息：

...
nginx path prefix: "/usr/local/nginx"
nginx binary file: "/usr/local/sbin"
nginx configuration file: "/usr/local/nginx/conf/nginx.conf"
...

留 意上面的提示，涉及到nginx的幾個重要文件的路徑信息。

六、Make && make install
差很少快完成了，如今make一下。

make
...
sudo make install

七、chmod
還需 要給bin文件有執行權限，也比較簡單：

chmod +x /usr/local/sbin/nginx

5、使用

安裝完成後，試着使用下。
一、啓動

sudo /usr/local/sbin/nginx

而後把本身的瀏覽器導航到http://IP就可 以看到默認的歡迎界面了，以下：

二、中止
若是你使用過apache或者看到前面那篇使用aptitude安裝Nginx的話，你可能會對/etc/init.d/下的那 個nginx腳本印象比較深入，使用/etc/init.d/nginx能夠直接start或者stop，可是，從源碼編譯的Nginx是沒有自動建立這 個腳本的（後面會告訴你怎麼手工建立），如今看看在沒有建立這個腳本前，如何了stop。
或許你已經注意編譯的時候，有這 個提示「nginx pid file: "/usr/local/nginx/logs/nginx.pid"」，你能夠cat下看看，他記錄的就是當前nginx的pid號，因而咱們就能夠這 樣來中止nginx了。

sudo kill `cat /usr/local/nginx/logs/nginx.pid`

特別注意：這裏使用的是反 引號(`)而不是單引號(').

6、小結

這篇 文章介紹瞭如何在Ubuntu上使用源碼按照咱們的須要來編譯安裝nginx，而後介紹瞭如何手工啓動和中止nginx，前面也提到了，後續文章會介紹如 何建立init腳本，以及如何規劃調整目錄結構（sites-available 和sites-enabled）；而後會介紹如何配置nginx使其更能發揮威力。

7、附錄：Compile-time options

（原文參考： http://wiki.codemongers.com/NginxInstallOptions ）

configure 腳本肯定系統所具備一些特性，特別是 nginx 用來處理鏈接的方法。而後，它建立 Makefile 文件。

configure 支持下面的選項：

1）目錄屬性

--prefix=<path> - Nginx安裝路徑。若是沒有指定，默認爲 /usr/local/nginx。

--sbin-path=<path> - Nginx可執行文件安裝路徑。只能安裝時指定，若是沒有指定，默認爲<prefix>/sbin/nginx。

--conf-path=<path> - 在沒有給定-c選項下默認的nginx.conf的路徑。若是沒有指定，默認爲<prefix>/conf/nginx.conf。

--pid-path=<path> - 在nginx.conf中沒有指定pid指令的狀況下，默認的nginx.pid的路徑。若是沒有指定，默認爲 <prefix>/logs/nginx.pid。

--lock-path=<path> - nginx.lock文件的路徑，默認爲<prefix>/logs/nginx.lock

--error-log-path=<path> - 在nginx.conf中沒有指定error_log指令的狀況下，默認的錯誤日誌的路徑。若是沒有指定，默認爲 <prefix>/logs/error.log。

--http-log-path=<path> - 在nginx.conf中沒有指定access_log指令的狀況下，默認的訪問日誌的路徑。若是沒有指定，默認爲 <prefix>/logs/access.log。

--user=<user> - 在nginx.conf中沒有指定user指令的狀況下，默認的nginx使用的用戶。若是沒有指定，默認爲 nobody。

--group=<group> - 在nginx.conf中沒有指定user指令的狀況下，默認的nginx使用的組。若是沒有指定，默認爲 nobody。

--builddir=DIR - 指定編譯的目錄

2）模塊

--with-rtsig_module - 啓用 rtsig 模塊

--with-select_module --without-select_module -容許或不容許開啓SELECT模式，若是 configure 沒有找到更合適的模式，好比：kqueue(sun os),epoll (linux kenel 2.6+), rtsig(實時信號)或者/dev/poll(一種相似select的模式，底層實現與SELECT基本相 同，都是採用輪訓方法) SELECT模式將是默認安裝模式

--with-poll_module --without-poll_module - Whether or not to enable the poll module. This module is enabled by default if a more suitable method such as kqueue, epoll, rtsig or /dev/poll is not discovered by configure.

--with-http_ssl_module -開啓HTTP SSL模塊，使NGINX能夠支持HTTPS請求。這個模塊須要已經安裝了OPENSSL，在DEBIAN上是libssl

--with-http_realip_module - 啓用 ngx_http_realip_module

--with-http_addition_module - 啓用 ngx_http_addition_module

--with-http_sub_module - 啓用 ngx_http_sub_module

--with-http_dav_module - 啓用 ngx_http_dav_module

--with-http_flv_module - 啓用 ngx_http_flv_module

--with-http_stub_status_module - 啓用 "server status" 頁

--without-http_charset_module - 禁用 ngx_http_charset_module

--without-http_gzip_module - 禁用 ngx_http_gzip_module. 若是啓用，須要 zlib 。

--without-http_ssi_module - 禁用 ngx_http_ssi_module

--without-http_userid_module - 禁用 ngx_http_userid_module

--without-http_access_module - 禁用 ngx_http_access_module

--without-http_auth_basic_module - 禁用 ngx_http_auth_basic_module

--without-http_autoindex_module - 禁用 ngx_http_autoindex_module

--without-http_geo_module - 禁用 ngx_http_geo_module

--without-http_map_module - 禁用 ngx_http_map_module

--without-http_referer_module - 禁用 ngx_http_referer_module

--without-http_rewrite_module - 禁用 ngx_http_rewrite_module. 若是啓用須要 PCRE 。

--without-http_proxy_module - 禁用 ngx_http_proxy_module

--without-http_fastcgi_module - 禁用 ngx_http_fastcgi_module

--without-http_memcached_module - 禁用 ngx_http_memcached_module

--without-http_limit_zone_module - 禁用 ngx_http_limit_zone_module

--without-http_empty_gif_module - 禁用 ngx_http_empty_gif_module

--without-http_browser_module - 禁用 ngx_http_browser_module

--without-http_upstream_ip_hash_module - 禁用 ngx_http_upstream_ip_hash_module

--with-http_perl_module - 啓用 ngx_http_perl_module

--with-perl_modules_path=PATH - 指定 perl 模塊的路徑

--with-perl=PATH - 指定 perl 執行文件的路徑

--http-log-path=PATH - Set path to the http access log

--http-client-body-temp-path=PATH - Set path to the http client request body temporary files

--http-proxy-temp-path=PATH - Set path to the http proxy temporary files

--http-fastcgi-temp-path=PATH - Set path to the http fastcgi temporary files

--without-http - 禁用 HTTP server

--with-mail - 啓用 IMAP4/POP3/SMTP 代理模塊

--with-mail_ssl_module - 啓用 ngx_mail_ssl_module

--with-cc=PATH - 指定 C 編譯器的路徑

--with-cpp=PATH - 指定 C 預處理器的路徑

--with-cc-opt=OPTIONS - Additional parameters which will be added to the variable CFLAGS. With the use of the system library PCRE in FreeBSD, it is necessary to indicate --with-cc-opt="-I /usr/local/include". If we are using select() and it is necessary to increase the number of file descriptors, then this also can be assigned here: --with-cc-opt="-D FD_SETSIZE=2048".

--with-ld-opt=OPTIONS - Additional parameters passed to the linker. With the use of the system library PCRE in FreeBSD, it is necessary to indicate --with-ld-opt="-L /usr/local/lib".

--with-cpu-opt=CPU - 爲特定的 CPU 編譯，有效的值包括：pentium, pentiumpro, pentium3, pentium4, athlon, opteron, amd64, sparc32, sparc64, ppc64

--without-pcre - 禁止 PCRE 庫的使用。同時也會禁止 HTTP rewrite 模塊。在 "location" 配置指令中的正則表達式也須要 PCRE 。

--with-pcre=DIR - 指定 PCRE 庫的源代碼的路徑。

--with-pcre-opt=OPTIONS - Set additional options for PCRE building.

--with-md5=DIR - Set path to md5 library sources.

--with-md5-opt=OPTIONS - Set additional options for md5 building.

--with-md5-asm - Use md5 assembler sources.

--with-sha1=DIR - Set path to sha1 library sources.

--with-sha1-opt=OPTIONS - Set additional options for sha1 building.

--with-sha1-asm - Use sha1 assembler sources.

--with-zlib=DIR - Set path to zlib library sources.

--with-zlib-opt=OPTIONS - Set additional options for zlib building.

--with-zlib-asm=CPU - Use zlib assembler sources optimized for specified CPU, valid values are: pentium, pentiumpro

--with-openssl=DIR - Set path to OpenSSL library sources

--with-openssl-opt=OPTIONS - Set additional options for OpenSSL building

--with-debug - 啓用調試日誌

--add-module=PATH - Add in a third-party module found in directory PATH