Nginx 官方文档学习实录

Nginx 的学习资料很多,但我都不满意,遂自己扒 Nginx 的官方文档:Nginx Documentation 以及一些外文资料,本文是记录这些知识以供后期复习。内容包括:配置文件、静态资源服务、代理服务器等。

0. 综述

Nginx 运行起来后会出现一个 master process 和 k 个 worker processes。用 ps -aux |grep nginx 可以查看到,其中 k 是可以有我们自己设置的:

master process 和 worker processes

其中 master process 用来加载配置文件并维护 worker processes 的运行,而 worker processes 则是实际处理外部发来的请求request 的进程。

Nginx运行起来后能完成什么功能(例如,返回静态文件,作为代理服务器转发某个request,充当邮件服务器等)是由 Nginx.conf 文件决定的。nginx.conf 被放在Linux系统里的 /usr/local/nginx/conf 或者 /etc/nginx 或者 /usr/local/etc/nginx。
其实大家把 Nginx.conf 看作是一堆命令的集合就可以了,这些命令都是 Nginx 定义好的并且使用起来很简单,所以入门级别的学习我们主要关注 nginx.conf 里常见的命令书写方式及其含义功能就好了。

1. Nginx 的配置文件 nginx.conf

1.1 宏观认识 nginx.conf

官方文档用 directives 表示命令,例如下文出现的简单命令和块命令,其英文分别是 simple directives 和 block directives。

从其组成元素的角度认识 nginx.conf:前文讲到,nginx.conf 其实就是一堆命令的集合,nginx 里的命令可以分为简单命令和块命令。简单命令的格式是:命令名 + 空格 + 参数 + ;,块命令的格式是:命令名 + 空格 + 参数 + {instructions},而如果某个块命令的大括号内不仅可以放 instructions ,还可以放 directives ,那么这种命令也被称为上下文( context ),即命令名 + 空格 + 参数 + {directives}

从层次化角度认识 nginx.conf:更具上面解释,其实可以看出来 nginx.conf 是个层次化的文件,就是说命令里还可以包含命令。在 nginx.conf 中有一些命令是没有被其他命令包含的,独立地写在文件里,这些命令都被认为是放在了 main context 中。

接下来我们就实际去看看一个真正的 nginx.conf 文件并对照上文做个解释吧:

########   Nginx的main(全局配置)文件
user root;  # 该条命令可以看作是一个简单命令,而且没有被包含在任何其他命令里,就可以看作是包含在 main context 里,只不过这个 main 并没被显式写出来,下面的四个都可看做简单命令。该命令指定nginx运行的用户及用户组,默认为nginx.

worker_processes  1;  #开启的线程数,一般跟逻辑CPU核数一致

error_log logs/error.log notice; #定位全局错误日志文件,级别以notice显示,还有debug,info,warn,error,crit模式,debug输出最多,crir输出最少,根据实际环境而定

pid /run/nginx.pid;  #指定进程id的存储文件位置

worker_rlimit_nofile 65535  #指定一个nginx进程打开的最多文件描述符数目,受系统进程的最大打开文件数量限制

events {
    #use epoll;  #设置工作模式为epoll,除此之外还有select,poll,kqueue,rtsig和/dev/poll模式
    worker_connections  1024;  #定义每个进程的最大连接数,受系统进程的最大打开文件数量限制。
}  # 这是遇到的第一个块命令。

####### Nginx 的 HTTP 服务器配置,Gzip配置
http {
    include mime.types;  #主模块指令,实现对配置文件所包含的文件的设定,可以减少主配置文件的复杂度,DNS主配置文件中的zonerfc1912,acl基本上都是用include语句。
    default_type  application/octet-stream; #核心模块指令,指令默认设置为二进制流,也就是当文件类型未定义时使用这种方式

    #下面代码为日志格式的设定,main为日志格式的名称,可自行设置,后面引用
    #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;  #引用日志main

    client_max_body_size 20M;  #设置允许客户端请求的最大的单个文件字节数

    client_header_buffer_size  32k;  #指定来自客户端请求头的headebuffer大小

    client_body_temp_path /dev/shm/client_body_temp;  #指定连接请求试图写入缓存文件的目录路径

    large client_header_buffers 4 32k;  #指定客户端请求中较大的消息头的缓存最大数量和大小,目前设置为4个32KB

    sendfile on;   #开启高效文件传输模式
   
    tcp_nopush on;   #开启防止网络阻塞
    
    tcp_nodelay on;  #开启防止网络阻塞

    keepalive_timeout  65;  #设置客户端连接保存活动的超时时间

    client_header_timeout 10;  #设置客户端请求读取超时时间
    
    client_body_timeout 10;  #设置客户端请求主体读取超时时间

    send_timeout 10;      #用于设置相应客户端的超时时间


    ####HttpGZip模块配置
    gzip  on;  #开启gzip压缩
    #gzip_min_length 1k;  #设置允许压缩的页面最小字节数
    #gzip_buffers 4 16k;  #申请4个单位为16K的内存作为压缩结果流缓存
    #gzip_http_version 1.1;  #设置识别http协议的版本,默认为1.1
    #gzip_comp_level 2;   #指定gzip压缩比,1-9数字越小,压缩比越小,速度越快
    #gzip_types text/plain application/x-javascript text/css application/xml;  #指定压缩的类型
    #gzip_vary on;   #让前端的缓存服务器进过gzip压缩的页面


    #########Nginx的server虚拟主机配置
    server {
        listen 80;  #监听端口为 80

        server_name  localhost;  #设置主机域名

        access_log  logs/host.access.log  main;  #设置虚拟主机访问日志的存放路径及日志的格式为main

        #设置虚拟主机的基本信息
        location / {
            root   html;              #设置虚拟主机的网站根目录
            index  index.html index.html;  #设置虚拟主机默认访问的网页
        }

        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;
        }
    }
}
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,179评论 5 476
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,229评论 2 380
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,032评论 0 336
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,533评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,531评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,539评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,916评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,574评论 0 256
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,813评论 1 296
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,568评论 2 320
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,654评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,354评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,937评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,918评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,152评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,852评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,378评论 2 342