2014-06-27 wcdj
先从官方的wiki开始。http://wiki.nginx.org/GettingStarted，了解下配置nginx编译选项的各个含义。
./configure --help 查看具体编译选项使用说明，然后写一个简单的安装脚本。
Nginx modules must be selected during compile, run-time selection of modules is not currently supported.
A full summary of the compile-time options, including optional modules, can be found in the provided configure script by running./configure --help
#!/bin/bash
echo "begin to install nginx-1.7.2"
echo "configure..."
./configure --prefix=/Users/gerryyang/LAMP/nginx/install/nginx-1.7.2 \
--with-debug \
--with-pcre=/Users/gerryyang/LAMP/pcre/pcre-8.35 \
--with-openssl=/Users/gerryyang/LAMP/OpenSSL/openssl-1.0.1g
echo "make and make install..."
make && make install
指定后的配置和安装选项结果值如下：
Configuration summary
+ using PCRE library: /Users/gerryyang/LAMP/pcre/pcre-8.35
+ using OpenSSL library: /Users/gerryyang/LAMP/OpenSSL/openssl-1.0.1g
+ md5: using OpenSSL library
+ sha1: using OpenSSL library
+ using system zlib library
nginx path prefix: "/Users/gerryyang/LAMP/nginx/install/nginx-1.7.2"
nginx binary file: "/Users/gerryyang/LAMP/nginx/install/nginx-1.7.2/sbin/nginx"
nginx configuration prefix: "/Users/gerryyang/LAMP/nginx/install/nginx-1.7.2/conf"
nginx configuration file: "/Users/gerryyang/LAMP/nginx/install/nginx-1.7.2/conf/nginx.conf"
nginx pid file: "/Users/gerryyang/LAMP/nginx/install/nginx-1.7.2/logs/nginx.pid"
nginx error log file: "/Users/gerryyang/LAMP/nginx/install/nginx-1.7.2/logs/error.log"
nginx http access log file: "/Users/gerryyang/LAMP/nginx/install/nginx-1.7.2/logs/access.log"
nginx http client request body temporary files: "client_body_temp"
nginx http proxy temporary files: "proxy_temp"
nginx http fastcgi temporary files: "fastcgi_temp"
nginx http uwsgi temporary files: "uwsgi_temp"
nginx http scgi temporary files: “scgi_temp"
安装后的目录结构：
查看安装好的nginx版本信息和编译选项：
root@mba:sbin#./nginx -v
nginx version: nginx/1.7.2
root@mba:sbin#./nginx -V
nginx version: nginx/1.7.2
built by clang 5.1 (clang-503.0.40) (based on LLVM 3.4svn)
configure arguments: --prefix=/Users/gerryyang/LAMP/nginx/install/nginx-1.7.2 --with-debug --with-pcre=/Users/gerryyang/LAMP/pcre/pcre-8.35 --with-openssl=/Users/gerryyang/LAMP/OpenSSL/openssl-1.0.1g
然后运行nginx服务，并在browser上测试下。
测试后可以看到nginx记录的请求日志：
以下是access.log的内容：
127.0.0.1 - - [27/Jun/2014:16:08:09 +0800] "GET /index HTTP/1.1" 404 168 "-" "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.9; rv:30.0) Gecko/20100101 Firefox/30.0"
127.0.0.1 - - [27/Jun/2014:16:08:10 +0800] "GET /favicon.ico HTTP/1.1" 404 168 "-" "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.9; rv:30.0) Gecko/20100101 Firefox/30.0"
127.0.0.1 - - [27/Jun/2014:16:08:10 +0800] "GET /favicon.ico HTTP/1.1" 404 168 "-" "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.9; rv:30.0) Gecko/20100101 Firefox/30.0"
127.0.0.1 - - [27/Jun/2014:16:08:44 +0800] "GET /index.html HTTP/1.1" 200 612 "-" "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.9; rv:30.0) Gecko/20100101 Firefox/30.0"
关于nginx的启动选项：
http://wiki.nginx.org/NginxCommandLine
后续可选操作：
(1) 配置nginx的vim插件
cp -r /Users/gerryyang/LAMP/nginx/nginx-1.7.2/contrib/vim/* ~/.vim
修改后的效果：
下面是安装后默认的nginx运行配置：
#user nobody;
worker_processes 1;
#error_log logs/error.log;
#error_log logs/error.log notice;
#error_log logs/error.log info;
#pid logs/nginx.pid;
events {
worker_connections 1024;
}
http {
include mime.types;
default_type application/octet-stream;
#log_format main '$remote_addr - $remote_user [$time_local] "$request" '
# '$status $body_bytes_sent "$http_referer" '
# '"$http_user_agent" "$http_x_forwarded_for"';
#access_log logs/access.log main;
sendfile on;
#tcp_nopush on;
#keepalive_timeout 0;
keepalive_timeout 65;
#gzip on;
server {
listen 80;
server_name localhost;
#charset koi8-r;
#access_log logs/host.access.log main;
location / {
root html;
index index.html index.htm;
}
#error_page 404 /404.html;
# redirect server error pages to the static page /50x.html
#
error_page 500 502 503 504 /50x.html;
location = /50x.html {
root html;
}
# proxy the PHP scripts to Apache listening on 127.0.0.1:80
#
#location ~ \.php$ {
# proxy_pass http://127.0.0.1;
#}
# pass the PHP scripts to FastCGI server listening on 127.0.0.1:9000
#
#location ~ \.php$ {
# root html;
# fastcgi_pass 127.0.0.1:9000;
# fastcgi_index index.php;
# fastcgi_param SCRIPT_FILENAME /scripts$fastcgi_script_name;
# include fastcgi_params;
#}
# deny access to .htaccess files, if Apache's document root
# concurs with nginx's one
#
#location ~ /\.ht {
# deny all;
#}
}
# another virtual host using mix of IP-, name-, and port-based configuration
#
#server {
# listen 8000;
# listen somename:8080;
# server_name somename alias another.alias;
# location / {
# root html;
# index index.html index.htm;
# }
#}
# HTTPS server
#
#server {
# listen 443 ssl;
# server_name localhost;
# ssl_certificate cert.pem;
# ssl_certificate_key cert.key;
# ssl_session_cache shared:SSL:1m;
# ssl_session_timeout 5m;
# ssl_ciphers HIGH:!aNULL:!MD5;
# ssl_prefer_server_ciphers on;
# location / {
# root html;
# index index.html index.htm;
# }
#}
}
nginx的启动和关闭，一些信号选项可参考http://wiki.nginx.org/NginxCommandLine
root@mba:sbin#./nginx
root@mba:sbin#ps aux|grep nginx
root 703 0.0 0.0 2432784 620 s000 S+ 9:54下午 0:00.00 grep nginx
nobody 701 0.0 0.0 2452336 892 ?? S 9:54下午 0:00.00 nginx: worker process
root 700 0.0 0.0 2442908 344 ?? Ss 9:54下午 0:00.00 nginx: master process ./nginx
root@mba:sbin#./nginx -s stop
root@mba:sbin#ps aux|grep nginx
root 706 0.0 0.0 2442000 636 s000 S+ 9:54下午 0:00.00 grep nginx
root@mba:sbin#./nginx
root@mba:sbin#ps aux|grep nginx
root 714 0.7 0.0 2442000 632 s000 S+ 9:56下午 0:00.00 grep nginx
nobody 712 0.0 0.0 2452336 896 ?? S 9:56下午 0:00.00 nginx: worker process
root 711 0.0 0.0 2443932 348 ?? Ss 9:56下午 0:00.00 nginx: master process ./nginx
root@mba:sbin#./nginx -s stop
root@mba:sbin#ps aux|grep nginx
root 717 0.0 0.0 2432784 612 s000 S+ 9:56下午 0:00.00 grep nginx
root@mba:sbin#./nginx
root@mba:sbin#ps aux|grep nginx
root 722 0.0 0.0 2432784 612 s000 S+ 9:56下午 0:00.00 grep nginx
nobody 720 0.0 0.0 2444144 908 ?? S 9:56下午 0:00.00 nginx: worker process
root 719 0.0 0.0 2443932 348 ?? Ss 9:56下午 0:00.00 nginx: master process ./nginx
root@mba:sbin#kill -QUIT $(cat ../logs/nginx.pid)
root@mba:sbin#ps aux|grep nginx
root 725 0.0 0.0 2432784 612 s000 S+ 9:57下午 0:00.00 grep nginx
root@mba:sbin#
The master process can handle the following signals:
| TERM, INT | Quick shutdown |
| QUIT | Graceful shutdown |
| KILL | Halts a stubborn process |
| HUP | Configuration reload Start the new worker processes with a new configuration Gracefully shutdown the old worker processes |
| USR1 | Reopen the log files |
| USR2 | Upgrade Executable on the fly |
| WINCH | Gracefully shutdown the worker processes |
There's no need to control the worker processes yourself. However, they support some signals, too:
| TERM, INT | Quick shutdown |
| QUIT | Graceful shutdown |
| USR1 | Reopen the log files |
[1] https://github.com/nginx/nginx
[2] http://nginx.org/download/
[3] http://lenky.info/ngx_book
[4] http://book.51cto.com/art/201305/395368.htm
[5] https://github.com/taobao/nginx-book