Nginx安装及配置简介

Nginx作为一个后起之秀，他的迷人之处已经让很多人都投入了他的怀抱。配置简单，实现原理简单。做一个负载平衡的再好不过了。

其原理：

简单介绍一下他的安装及配置过程

官方网站 
http://wiki.codemongers.com/Main

一、依赖的程序

1. gzip module requires zlib library 
2. rewrite module requires pcre library 
3. ssl support requires openssl library

二、安装 
./configure 
make 
make install

默认安装的路径是/usr/local/nginx

更多的安装配置 
./configure --prefix=/usr/local/nginx 
--with-openssl=/usr/include (启用ssl) 
--with-pcre=/usr/include/pcre/ (启用正规表达式) 
--with-http_stub_status_module (安装可以查看nginx状态的程序) 
--with-http_memcached_module (启用memcache缓存) 
--with-http_rewrite_module (启用支持url重写)

三、启动及重启 
启动：nginx 
重启：kill -HUP `cat /usr/local/nginx/logs/nginx.pid` 
测试配置文件：nginx -t

简单吧，安装，启动都比较方便。

四、配置文件 
http://wiki.codemongers.com/NginxFullExample

#运行用户

user  nobody nobody;

#启动进程

worker_processes  5;

#全局错误日志及PID文件

error_log  logs/error.log notice;

pid        logs/nginx.pid;

#工作模式及连接数上限

events {

  #工作模式有：select(标准模式),poll(标准模式),kqueue(高效模式，适用FreeBSD 4.1+, OpenBSD 2.9+, NetBSD 2.0 and MacOS X),

  #epoll(高效模式，本例用的。适用Linux 2.6+,SuSE 8.2,),/dev/poll(高效模式，适用Solaris 7 11/99+, HP/UX 11.22+ (eventport), IRIX 6.5.15+ 和 Tru64 UNIX 5.1A+)

  use epoll;

  worker_connections      1024;

}

#设定http服务器，利用它的反向代理功能提供负载均衡支持

http {

  #设定mime类型

  include      conf/mime.types;

  default_type  application/octet-stream;

  #设定日志格式

  log_format main        '$remote_addr - $remote_user [$time_local] '

                         '"$request" $status $bytes_sent '

                         '"$http_referer" "$http_user_agent" '

                         '"$gzip_ratio"';

log_format download    '$remote_addr - $remote_user [$time_local] '

                         '"$request" $status $bytes_sent '

                         '"$http_referer" "$http_user_agent" '

                         '"$http_range" "$sent_http_content_range"';

#设定请求缓冲

  client_header_buffer_size    10k;

  large_client_header_buffers  4 4k;


  #开启gzip模块，要求安装gzip 在运行./config时要指定

  gzip on;

  gzip_min_length  1100;

  gzip_buffers    4 8k;

  gzip_types      text/plain;

  output_buffers  1 32k;

  postpone_output  1460;


  #设定访问日志

  access_log  logs/access.log  main;

  client_header_timeout  3m;

  client_body_timeout    3m;

  send_timeout          3m;

  sendfile                on;

  tcp_nopush              on;

  tcp_nodelay            on;

  keepalive_timeout  65;


  #设定负载均衡的服务器列表
upstream backserver {

  #weigth参数表示权值，权值越高被分配到的几率越大

  #本例是指在同一台服务器，多台服务器改变ip即可

  server 127.0.0.1:8081 weight=5;

  server 127.0.0.1:8082;

  server 127.0.0.1:8083;

  }

#设定虚拟主机，默认为监听80端口，改成其他端口会出现问题

  server {

    listen         80;

    server_name    test.com www.test.com;

    charset utf8;

    #设定本虚拟主机的访问日志

    access_log  logs/test.com.log  main;

    #如果访问 /images/*, /js/*, /css/* 资源，则直接取本地文件，不用转发。但如果文件较多效果不是太好。

    location ~ ^/(images|js|css)/  {

        root    /usr/local/testweb;

        expires 30m;

    }


    #对 "/" 启用负载均衡
location / {

       proxy_pass      http://backserver;

       proxy_redirect          off;

       proxy_set_header        Host $host;

       proxy_set_header        X-Real-IP $remote_addr;

       proxy_set_header        X-Forwarded-For $proxy_add_x_forwarded_for;

       client_max_body_size    10m;

       client_body_buffer_size 128k;

       proxy_connect_timeout  90;

       proxy_send_timeout      90;

       proxy_read_timeout      90;

       proxy_buffer_size      4k;

       proxy_buffers          4 32k;

       proxy_busy_buffers_size 64k;

       proxy_temp_file_write_size 64k;

    }

    #设定查看Nginx状态的地址,在运行./config 要指定，默认是不安装的。

    location /NginxStatus {

       stub_status            on;

       access_log              on;

       auth_basic              "NginxStatus";

       #是否要通过用户名和密码访问，测试时可以不加上。conf/htpasswd 文件的内容用 apache 提供的 htpasswd 工具来产生即可       

       #auth_basic_user_file  conf/htpasswd;

    }

}

有详细的说明

-----------------------------------

Nginx配置

 

 

Nginx 使用 Unix 下常用的 ‘./configure && make && make install’ 过程来编译安装。

configure 脚本确定系统所具有一些特性，特别是 nginx 用来处理连接的方法。然后，它创建 Makefile 文件。

configure 支持下面的选项：

–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文件的路径。

–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 - 指定编译的目录

–with-rtsig_module - 启用 rtsig 模块

–with-select_module –without-select_module - Whether or not to enable the select 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.

//允许或不允许开启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 - Enable ngx_http_ssl_module. Enables SSL support and the ability to handle HTTPS requests. Requires OpenSSL. On Debian, this is libssl-dev.

//开启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

在不同版本间，选项可能会有些许变化，请总是使用 ./configure –help 命令来检查一下当前的选项列表。

示例 (最好能在同一行)：

 

./configure 

        –sbin-path=/usr/local/nginx/nginx 

        –conf-path=/usr/local/nginx/nginx.conf 

        –pid-path=/usr/local/nginx/nginx.pid 

        –with-http_ssl_module 

        –with-pcre=../pcre-4.4 

        –with-zlib=../zlib-1.1.3

Example on Ubuntu/debian with libgcrypt11-dev, libpcre3-dev and libssl-dev installed (choose EITHER –with-md5 OR –with-sha1, but not both; on debian and ubuntu, they should both point to /usr/lib)

 

./configure --with-openssl=/usr/lib/ssl/ --with-md5=/usr/lib

选项

-c </path/to/config> 为 Nginx 指定一个配置文件，来代替缺省的。

-t 不运行，而仅仅测试配置文件。nginx 将检查配置文件的语法的正确性，并尝试打开配置文件中所引用到的文件。

-v 显示 nginx 的版本。

-V 显示 nginx 的版本，编译器版本和配置参数。

 

一个简单的负载均衡的示例，把www.domain.com均衡到本机不同的端口，也可以改为均衡到不同的地址上。

http {
: upstream myproject {
: server 127.0.0.1:8000 weight=3;
: server 127.0.0.1:8001;
: server 127.0.0.1:8002;
: server 127.0.0.1:8003;
: }

: server {
: listen 80;
: server_name www.domain.com;
: location / {
: proxy_pass http://myproject;
: }
: }