配置文件 简介
1-配置结构
1.1-文件结构
1.2-配置实例
2-配置详解
Nginx 配置文件主要分为六个区域:
main
:全局设置events
:Nginx 工作模式http
:Http 设置server
:主机设置location
:URL 匹配upstream
:负载均衡服务器设置
2.1-main
# Nginx Worker 进程的运行用户以及用户组,默认由 nobody 账号运行。
user nobody;
# Nginx 要开启的子进程数。每个 Nginx 进程平均耗费 10M~12M 内存,一般指定 1 个进程就足够了。
# 若是多核 CPU,建议指定和 CPU 的数量相同进程数即可。
worker_processes 1;
# 全局错误日志文件。日志输出级别有 debug、info、notice、warn、error、crit。其中 debug 输出日志最详细,而 crit 输出日志最少。
error_log logs/error.log;
error_log logs/error.log notice;
error_log logs/error.log info;
# Nginx 进程 id 的存储文件位置。
pid logs/nginx.pid;
# 一个 Nginx 进程可以打开最多文件描述符数目。
worker_rlimit_nofile 65535;
2.2-event
events {
use epoll;
worker_connections 1024;
}
use
:指定Nginx
工作模式,工作模式有select
、poll
、kqueue
、epoll
、rtsig
、/dev/poll
。select
和poll
都是标准的工作模式,kqueue
和epoll
是高效的工作模式,不同的是epoll
用在Linux
平台上,而kqueue
用在BSD
系统中。对于Linux
系统,epoll
工作模式是首选。worker_connections
:指定Nginx
每个进程的最大连接数,即接收前端的最大请求数,默认是1024。最大客户端连接数由worker_processes
和worker_connections
决定,即Max_clients=worker_processes*worker_connections
。在作为反向代理时,Max_clients
变为:Max_clients = worker_processes * worker_connections / 4
。进程的最大连接数受Linux
系统进程的最大打开文件数限制,在执行操作系统命令ulimit -n 65536
后worker_connections
的设置才能生效。
2.3-http
http
模块负责HTTP
服务器相关属性的配置,有server
和upstream
两个子模块。
http {
#include :来用设定文件的mime类型,类型在配置文件目录下的mime.type文件定义,来告诉nginx来识别文件类型。
#default_type:设定了默认的类型为二进制流,也就是当文件类型未定义时使用这种方式,例如在没有配置asp的locate环境时,Nginx是不予解析的,此时,用浏览器访问asp文件就会出现下载了。
#log_format:用于设置日志的格式,和记录哪些参数,这里设置为main,刚好用于access_log来纪录这种类型。
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;
}
2.4-server
server
用来定义一个虚拟主机,标志定义虚拟主机开始。
- listen:用于指定虚拟主机的服务端口。
- server_name:用来指定IP地址或者域名,多个域名之间用空格分开。
- root :表示在这整个server虚拟主机内,全部的root web根目录。注意要和locate {}下面定义的区分开来。
- index :全局定义访问的默认首页地址。注意要和locate {}下面定义的区分开来。
- charset:用于设置网页的默认编码格式。
- access_log:用来指定此虚拟主机的访问日志存放路径,最后的main用于指定访问日志的输出格式。
server {
listen 80;
server_name localhost;
root /Users/hk/www;
index index.php index.html index.htm;
charset utf-8;
access_log logs/host.access.log main;
aerror_log logs/host.error.log main;
}
2.5-location
#location模块 负载均衡,反向代理,虚拟域名等配置。是来定位的,定位URL,解析URL,它也提供了强大的正则匹配功能,也支持条件判断匹配,可以通过location指令实现Nginx对动,静态网页进行过滤处理。
- #/表示匹配访问根目录。
- #root指令用于指定访问根目录时,虚拟主机的web目录,这个目录可以是相对路径(相对路径是相对于nginx的安装目录)。也可以是绝对路径。
- #proxy_pass:代理转发,如果在proxy_pass后面的url加/,表示绝对根路径;如果没有/,表示相对路径,把匹配的路径部分也给代理走。
- #proxy_set_header:允许重新定义或者添加发往后端服务器的请求头。
- #include:加载配置文件,后面介绍nginx多个配置文件时候会提到。
- #root:定位localtion匹配的url资源路径。
- #index:定义页面显示html,一般和alias配合使用。
location / {
root html;
index index.html index.htm;
}
error_page 404 /404.html;
error_page 500 502 503 504 /50x.html;
location = /50x.html {
root html;
}
#反向代理配置
location /jyb {
proxy_pass http://qurt/;
proxy_read_timeout 1800s;
proxy_set_header Host $host:$server_port;
proxy_set_header X-real-ip $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
#采用uwsgi方式
location /python/ {
include uwsgi_params;
uwsgi_pass 127.0.0.1:33333;
}
# FastCGI方式
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;
}
#访问nginx本机目录的文件
location / {
root /home/hk/;
index index.html index.htm;
}
location /static/ {
alias /var/static/;
}
# 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;
}
}
2.7-location 中 root、alias 区别
######################nginx 中location中root和alias的区别 ####################
nginx指定文件路径有两种方式root和alias,这两者的用法区别,使用方法总结了。
root与alias主要区别在于nginx如何解释location后面的uri,这会使两者分别以不同的方式将请求映射到服务器文件上。
[root]
语法:root path
默认值:root html
配置段:http、server、location、if
[alias]
语法:alias path
配置段:location
root实例:
location ^~ /t/ {
root /www/root/html/;
}
如果一个请求的URI是/t/a.html时,web服务器将会返回服务器上的/www/root/html/t/a.html的文件。
alias实例:
location ^~ /t/ {
alias /www/root/html/new_t/;
}
如果一个请求的URI是/t/a.html时,web服务器将会返回服务器上的/www/root/html/new_t/a.html的文件。注意这里是new_t,
因为alias会把location后面配置的路径丢弃掉,把当前匹配到的目录指向到指定的目录。
注意:
1. 使用alias时,目录名后面一定要加"/"。
2. alias在使用正则匹配时,必须捕捉要匹配的内容并在指定的内容处使用。
3. alias只能位于location块中。(root可以不放在location中)
2.6-upstram
#upstream 模块负债负载均衡模块,通过一个简单的调度算法来实现客户端IP到后端服务器的负载均衡。
#Nginx的负载均衡模块目前支持4种调度算法:
#weight 轮询(默认)。每个请求按时间顺序逐一分配到不同的后端服务器,如果后端某台服务器宕机,故障系统被自动剔除,使用户访问不受影响。
#weight指定轮询权值,weight值越大,分配到的访问机率越高,主要用于后端每个服务器性能不均的情况下。
#ip_hash。每个请求按访问IP的hash结果分配,这样来自同一个IP的访客固定访问一个后端服务器,有效解决了动态网页存在的session共享问题。
#fair。比上面两个更加智能的负载均衡算法。此种算法可以依据页面大小和加载时间长短智能地进行负载均衡,
#也就是根据后端服务器的响应时间来分配请求,响应时间短的优先分配。Nginx本身是不支持fair的,如果需要使用这种调度算法,必须下载Nginx的upstream_fair模块。
#url_hash。按访问url的hash结果来分配请求,使每个url定向到同一个后端服务器,可以进一步提高后端缓存服务器的效率。Nginx本身是不支持url_hash的,
#如果需要使用这种调度算法,必须安装Nginx 的hash软件包。
#在HTTP Upstream模块中,可以通过server指令指定后端服务器的IP地址和端口,同时还可以设定每个后端服务器在负载均衡调度中的状态。常用的状态有:
#down,表示当前的server暂时不参与负载均衡。
#backup,预留的备份机器。当其他所有的非backup机器出现故障或者忙的时候,才会请求backup机器,因此这台机器的压力最轻。
#max_fails,允许请求失败的次数,默认为1。当超过最大次数时,返回proxy_next_upstream 模块定义的错误。
#fail_timeout,在经历了max_fails次失败后,暂停服务的时间。max_fails可以和fail_timeout一起使用。
#注意 当负载调度算法为ip_hash时,后端服务器在负载均衡调度中的状态不能是weight和backup。
#备注: nginx的worker_rlimit_nofile达到上限时,再有客户端链接报502错误. 用了log_format指令设置了日志格式之后,需要用access_log指令指定日志文件的存放路径。
upstream server_group {
ip_hash;
server 192.168.123.1:80;
server 192.168.123.2:80 down;
server 192.168.123.3:8080 max_fails=3 fail_timeout=20s;
server 192.168.123.4:8080;
}
server {
listen 80;
server_name localhost;
location / {
proxy_pass http://server_group/;
}
}
3-配置备份
user root;
worker_processes 16;
error_log logs/error.log;
error_log logs/error.log notice;
error_log logs/error.log info;
pid logs/nginx.pid;
events {
use epoll;
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" "$request_time" "$upstream_response_time" ';
#access_log logs/access.log main;
#设定请求缓冲
server_names_hash_bucket_size 128;
client_header_buffer_size 10240K;
large_client_header_buffers 10 1024k;
client_max_body_size 500m;
client_body_buffer_size 100m;
sendfile on;
tcp_nopush on;
tcp_nodelay on;
#keepalive_timeout 0;
keepalive_timeout 65;
#gzip on;
#开启gzip压缩,降低传输流量
gzip on;
gzip_min_length 1k;
gzip_buffers 4 16k;
gzip_http_version 1.1;
gzip_comp_level 2;
gzip_types text/plain application/x-javascript text/css application/xml;
gzip_vary on;
#添加tomcat列表,负载均衡的服务器都放在这
upstream tomcat_pool {
server 127.0.0.1:8280 weight=4 max_fails=2 fail_timeout=30s;
server 127.0.0.1:8180 weight=4 max_fails=2 fail_timeout=30s;
server 127.0.0.1:8380 weight=4 max_fails=2 fail_timeout=30s;
server 127.0.0.1:8480 weight=4 max_fails=2 fail_timeout=30s;
}
# another virtual host using mix of IP-, name-, and port-based configuration
server {
listen 8100;
server_name localhost;
access_log logs/access.log main;
location / {
root html/cbep;
index index.html;
}
location /cbepmobile/ {
root html/;
index index.html;
}
location /ncscapi/ {
proxy_pass http://172.31.223.30:8000/ncscapi;
}
location /clockmg/ {
proxy_buffer_size 10m;
proxy_buffers 30 1024k;
proxy_busy_buffers_size 20m;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_pass http://127.0.0.1:9086/clockmg/;
client_max_body_size 500m;
client_body_buffer_size 100m;
}
location /uploadfile/{
root html/;
autoindex on;
charset utf-8;
}
}
server {
listen 443 ssl default_server;
listen [::]:443 ssl default_server;
server_name _;
#root /usr/share/nginx/html;
ssl_certificate "/etc/nginx/ssl/server.crt";
ssl_certificate_key "/etc/nginx/ssl/server.key";
ssl_session_timeout 5m;
charset utf-8;
# Load configuration files for the default server block.
#include /etc/nginx/default.d/*.conf;
location /aiweb/ {
root html/;
index index.html index.htm;
}
location /mai/ {
proxy_buffer_size 10m;
proxy_buffers 30 1024k;
proxy_busy_buffers_size 20m;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_pass http://127.0.0.1:9081/mai/;
client_max_body_size 500m;
client_body_buffer_size 100m;
}
location /aiwebvideo/{
root html/;
autoindex on;
charset utf-8;
}
}
}