nginx 的问题

 

主模块（Main Module）

 

回目录

·摘要

包含一些Nginx的基本控制功能

·指令

daemon

语法：daemon on | off
默认值：on

daemon off;

生产环境中不要使用"daemon"和"master_process"指令，这些选项仅用于开发调试。你可使用daemon off在生产环境中，但对性能提高没有帮助，在生产环境中永远不要使用master_process off。

env

语法：env VAR|VAR=VALUE
默认值：TZ
使用字段：main
这个命令容许其限定一些主机变量的值，在如下的状况下会建立或修改变量的值：

·在零停机的状况下进行升级或增长、删除一些模块时继承的变量
·使用于嵌入式perl模块
·使用于工做中的进程，必须记住，管理行为的系统库在一样的方式下可能并不像频繁的调用库文件那样使用变量（仅仅当他们初始化时），即仍然能够用以前给定的命令设置，上面提到的零停机更新文件是一个例外

若是TZ的值没有被设置，那么显然它老是继承而且老是能够访问到嵌入式perl模块
例：

env  MALLOC_OPTIONS;
env  PERL5LIB=/data/site/modules;
env  OPENSSL_ALLOW_PROXY_CERTS=1;

debug_points

语法：debug_points [stop | abort]
默认值：none（无）

debug_points stop;

在Nginx中有一些调试断点，它们容许Nginx使用调试器，或者停止和创建核心文件。

error_log

语法：error_log file [ debug | info | notice | warn | error | crit ]
默认值：${prefix}/logs/error.log
指定Nginx服务（与FastCGI）错误日志文件位置。
每一个字段的错误日志等级默认值：

一、main字段 - error
二、HTTP字段 - crit
三、server字段 - crit

Nginx支持为每一个虚拟主机设置不一样的错误日志文件，这一点要好于lighttpd，详细为每一个虚拟主机配置不一样错误日志的例子请参考：SeparateErrorLoggingPerVirtualHost和mailing list thread on separating error logging per virtual host
若是你在编译安装Nginx时加入了--with-debug参数，你可使用如下配置：

error_log LOGFILE [debug_core | debug_alloc | debug_mutex | debug_event | debug_http | debug_imap];

注意error_log off并不能关闭日志记录功能，它将日志文件写入一个文件名为off的文件中，若是你想关闭错误日志记录功能，应使用如下配置：

error_log /dev/null crit;

一样注意0.7.53版本，nginx在读取配置文件指定的错误日志路径前将使用编译的默认日志位置，若是运行nginx的用户对该位置没有写入权限，nginx将输出以下错误：

[alert]: could not open error log file: open() "/var/log/nginx/error.log" failed (13: Permission denied)

log_not_found

语法：log_not_found on | off
默认值：on
使用字段：location
这个参数指定了是否记录客户端的请求出现404错误的日志，一般用于不存在的robots.txt和favicon.ico文件，例如：

location = /robots.txt {
  log_not_found  off;
}

include

语法：include file | *
默认值：none
你能够包含一些其余的配置文件来完成你想要的功能。
0.4.4版本之后，include指令已经可以支持文件通配符：

include vhosts/*.conf;

注意：直到0.6.7版本，这个参数包含的文件路径为你在编译时指定的--prefix=目录，默认是/usr/local/nginx，若是你不想指定这个目录下的文件，请写绝对路径。
0.6.7版本之后指定的文件路径为nginx.conf所在的目录，而不是prefix目录的路径。

lock_file

语法：lock_file file
默认值：编译时指定

lock_file  /var/log/lock_file;

Nginx使用链接互斥锁进行顺序的accept()系统调用，若是Nginx在i386,amd64,sparc64,与ppc64环境下使用gcc, Intel C++,或SunPro C++进行编译，Nginx使用原子指示使互斥生效，在其余状况下锁文件会被使用。

master_process

语法：master_process on | off
默认值：on

master_process  off;

生产环境中不要使用"daemon"和"master_process"指令，这些选项仅用于开发调试。

pid

语法：pid file
默认值：编译时指定

pid /var/log/nginx.pid;

指定pid文件，可使用kill命令来发送相关信号，例如你若是想从新读取配置文件，则可使用：kill -HUP `cat /var/log/nginx.pid`

ssl_engine

语法：ssl_engine engine
默认值：依赖于系统环境
这里能够指定你想使用的OpenSSL引擎，你可使用这个命令找出哪一个是可用的：openssl engine -t

$ openssl engine -t
(cryptodev) BSD cryptodev engine
  [ 可用 ] 
(dynamic) Dynamic engine loading support
  [ 不可用 ]

timer_resolution

语法：timer_resolution t
默认值：none

timer_resolution  100ms;

这个参数容许缩短gettimeofday()系统调用的时间，默认状况下gettimeofday()在下列都调用完成后才会被调用：kevent(), epoll, /dev/poll, select(), poll()。
若是你须要一个比较准确的时间来记录$upstream_response_time或者$msec变量，你可能会用到timer_resolution

try_files

语法：try_files path1 [ path2] uri
默认值：none
可用版本：0.7.27
依次检查存在的文件，而且返回找到的第一个文件，斜线指目录：$uri / 。若是在没有找到文件的状况下，会启用一个内部重定向到末尾参数，这个末尾参数“必须”被设置用来返回URL，不然会产生一个内部错误。
在代理Mongrel中使用：

location / {
  try_files /system/maintenance.html
  $uri $uri/index.html $uri.html @mongrel;
}
 
location @mongrel {
  proxy_pass http://mongrel;
}

在Drupal / FastCGI中：

location / {
  try_files $uri $uri/ @drupal;
}
 
location ~ \.php$ {
  try_files $uri @drupal;
  fastcgi_pass 127.0.0.1:8888;
  fastcgi_param  SCRIPT_FILENAME  /path/to$fastcgi_script_name;
  # other fastcgi_param
}
 
location @drupal {
  fastcgi_pass 127.0.0.1:8888;
  fastcgi_param  SCRIPT_FILENAME  /path/to/index.php;
  fastcgi_param  QUERY_STRING     q=$request_uri;
  # other fastcgi_param
}

在这个例子中，这个try_files指令：

location / {
  try_files $uri $uri/ @drupal;
}

等同于下列配置：

location / {
  error_page     404 = @drupal;
  log_not_found  off;
}

这段：

location ~ \.php$ {
  try_files $uri @drupal;
 
  fastcgi_pass 127.0.0.1:8888;
  fastcgi_param  SCRIPT_FILENAME  /path/to$fastcgi_script_name;
  # other fastcgi_param
}

指try_files在将请求提交到FastCGI服务以前检查存在的php文件。
一个在Wordpress和Joomla中的例子：

location / {
  try_files $uri $uri/ @wordpress;
}
 
location ~ \.php$ {
  try_files $uri @wordpress;
 
  fastcgi_pass 127.0.0.1:8888;
  fastcgi_param SCRIPT_FILENAME /path/to$fastcgi_script_name;
  # other fastcgi_param
}
 
location @wordpress {
    fastcgi_pass 127.0.0.1:8888;
    fastcgi_param SCRIPT_FILENAME /path/to/index.php;
    # other fastcgi_param
}

user

语法：user user [group]
默认值：nobody nobody
若是主进程以root运行，Nginx将会调用setuid()/setgid()来设置用户/组，若是没有指定组，那么将使用与用户名相同的组，默认情 况下会使用nobody用户与nobody组（或者nogroup），或者在编译时指定的--user=USER和--group=GROUP的值。

user www users;

worker_cpu_affinity

语法：worker_cpu_affinity cpumask [cpumask...]
默认值：none
仅支持linux系统。
这个参数容许将工做进程指定到cpu，它调用sched_setaffinity()函数

worker_processes     4;
worker_cpu_affinity 0001 0010 0100 1000;

指定每一个进程到一个CPU：

worker_processes     2;
worker_cpu_affinity 0101 1010;

指定第一个进程到CPU0/CPU2，指定第二个进程到CPU1/CPU3，对于HTT处理器来讲是一个不错的选择。

worker_processes

语法：worker_processes number
默认值：1

worker_processes 5;

因为如下几点缘由，Nginx可能须要运行不止一个进程

·使用了SMP（对称多处理技术）。
·当服务器在磁盘I/O出现瓶颈时为了减小响应时间。
·当使用select()/poll()限制了每一个进程的最大链接数时。

在事件模块这一章中咱们将使用worker_processes和worker_connections来计算理论最大链接数（max_clients）：
max_clients = worker_processes * worker_connections

worker_rlimit_core

语法：worker_rlimit_core size
默认值：
容许的每一个程序的核心文件最大值。

worker_rlimit_nofile

语法：worker_rlimit_nofile limit
默认值：
这个进程可以打开的最多文件描述符数

worker_rlimit_sigpending

语法：worker_rlimit_sigpending limit
默认值：
linux内核2.6.8之后，指定限制的信号数量多是真实用户队列中正在调用的进程

working_directory

语法：working_directory path
默认值：--prefix
程序的工做目录，通常只用来指定核心文件位置，Nginx仅使用绝对路径，全部在配置文件中的相对路径会转移到--prefix==PATH

·变量

$nginx_version

目前运行中的Nginx版本

$pid

进程ID号

$realpath_root

未标记

·参考文档

前进->事件模块（Events Module）