nginx使用备忘

工作中经常要用到nginx,这里将使用nginx最常要用到的技巧记录下来以备忘。

安装

在linux或mac下安装nginx还是很简单的,我一般都是直接下载源代码编译安装。这里要注意,configure时它会提示缺少某些开发库,按照它说明的安装上就可以编译了。另外我一般是将nginx的源码目录留下来,以免以后在用的过程中缺少某个module,需要重新编译安装。

mkdir build/
tar xf nginx-x.y.z.tar.gz -C build/
cd build/nginx-x.y.z
./configure --prefix=/opt/nginx
make && make install

查看版本信息、启动、停止、检查配置文件、重加载配置、分割日志文件

查看版本信息

1

/opt/nginx/sbin/nginx -V

启动

1

/opt/nginx/sbin/nginx > /dev/null 2>&1 &

停止

1

/opt/nginx/sbin/nginx -s stop

检查配置文件

1

/opt/nginx/sbin/nginx -t

重加载配置

1

/opt/nginx/sbin/nginx -s reload

分割日志文件

mv /opt/nginx/logs/access.log /opt/nginx/logs/access_20160430.log && mv /opt/nginx/logs/error.log /opt/nginx/logs/error_20160430.log
/opt/nginx/sbin/nginx -s reopen

当然一般也不会像上面这样启停nginx,一般会用initscripts, 可参考initscripts。日志的滚动也使用logrotate来完成,可参考使用logrotate管理nginx日志文件

配置

配置文件的组成,这里摘录一下nginx官方文档的说明

nginx consists of modules which are controlled by directives specified in the configuration file. Directives are divided into simple directives and block directives. A simple directive consists of the name and parameters separated by spaces and ends with a semicolon (;). A block directive has the same structure as a simple directive, but instead of the semicolon it ends with a set of additional instructions surrounded by braces ({ and }). If a block directive can have other directives inside braces, it is called a context (examples: events, http, server, and location). Directives placed in the configuration file outside of any contexts are considered to be in the main context. The events and http directives reside in the main context, server in http, and location in server.

常用指令

error_log

配置错误日志输出到哪儿及日志的输出级别,详见这里

events

配置连接如何被处理,详见这里这里

include

包含其它配置文件,用于有效地分割配置文件,详见这里

pid

指定pid文件位置,详见这里

thread_pool

设置线程池,详见这里

user

指定nginx运行时的用户身份,详见这里

worker_processes

指定worker进程的数目,详见这里

worker_connections

指定worker进程最大的连接数,详见这里

client_body_buffer_size

指定读取客户端请求体的buffer大小,详见这里

client_max_body_size

指定可读取客户端请求体的最大大小,详见这里

client_body_timeout

读取客户端请求体时,多久未传输任何数据,则认为请求超时了,详见这里

client_header_buffer_size

指定读取客户端请求头的buffer大小,详见这里

client_header_timeout

读取客户端请求头时,多久未传输任何数据,则认为请求超时了,详见这里

alias

指定location使用的路径,与root类似,但不改变文件的跟路径,仅适用文件系统的路径,详见这里

default_type

指定默认的MIME type,详见这里

error_page

为错误响应码指定响应客户端的URI,详见这里

internal

指定某个location仅内部可用,详见这里

limit_except

限制某个location里允许的HTTP方法,详见这里

limit_rate

限制响应发回客户端的速度,一般用于限速,详见这里

limit_rate_after

响应发回客户端传输多大之后开始限速,详见这里

listen

指定server监听的地址及端口,详见这里

location

指定相对于某个URI的配置,详见这里

location的优先级顺序比较复杂,见官方文档的三段话

A location can either be defined by a prefix string, or by a regular expression. Regular expressions are specified with the preceding “~*” modifier (for case-insensitive matching), or the “~” modifier (for case-sensitive matching). To find location matching a given request, nginx first checks locations defined using the prefix strings (prefix locations). Among them, the location with the longest matching prefix is selected and remembered. Then regular expressions are checked, in the order of their appearance in the configuration file. The search of regular expressions terminates on the first match, and the corresponding configuration is used. If no match with a regular expression is found then the configuration of the prefix location remembered earlier is used.

If the longest matching prefix location has the “^~” modifier then regular expressions are not checked.

Also, using the “=” modifier it is possible to define an exact match of URI and location. If an exact match is found, the search terminates.

resolver

指定用于查找upstream servers的DNS服务器,详见这里

root

指定响应请求的根目录,详见这里

server

为某个虚拟主机指定配置,详见这里

server_name

为虚拟主机指定主机名,详见这里

tcp_nodelay

是否开启socket的TCP_NODELAY选项,详见这里

try_files

按指定的顺序检查请求的文件是否存在(请求文件的路径是根据root或alias得出的),如找到,则直接响应请求,否则内部重定向至最后一个参数指定的uri,详见这里

types

根据文件名的后缀决定输出的MIME type,详见这里

allow

指定允许访问的IP地址或网络,详见这里

deny

指定拒绝访问的IP地址或网络,详见这里

autoindex

是否开启列目录输出,详见这里

charset

添加指定的编译至响应头的Content-Type属性,详见这里

empty_gif

输出一个1x1的透明gif图片,一般为占位图片,详见这里

gzip

是否开启gzip响应,详见这里

gzip_comp_level

设置gzip压缩的级别,级别越高压缩得越小,但越耗cpu,详见这里

gzip_disable

如果User-Agent请求头匹配指定的正则表达式,则禁用gzip,详见这里

gzip_min_length

当响应体超过这个大小才进行gzip压缩,详见这里

gzip_types

针对哪些MIME type才进行gzip压缩,详见这里

index

指定哪些文件被作为索引页,详见这里

limit_conn_zone

定义限制连接数的数据区,详见这里

limit_conn

定义限制的连接数,详见这里

limit_req_zone

定义限制请求数的数据区,详见这里

limit_req

定义限制的请求数,详见这里

限制请求数的逻辑比较复杂,参见这里

access_log

设置访问日志,详见这里

log_format

设置日志的格式,详见这里

proxy_pass

设置代理的协议及地址,详见这里

proxy_redirect

设置代理服务器LocationRefresh响应头里应作的替换,详见这里

valid_referers

设置合法的Referer请求头,详见这里

return

停止处理,直接返回响应码至客户端,详见这里

if

if判断,详见这里

rewrite

重写URL,详见这里

这里注意重写URL时如果加上flag, 意义不一样。

last相当于重写URL后,该URL重新开始location匹配搜索

break相当于中断在当前location里的rewrite处理

redirect是302临时重定向

permanent是301永久重定向

ssl

是否为指定的虚拟主机开启HTTPS协议,详见这里

ssl_certificate

ssl的证书,详见这里

ssl_certificate_key

ssl的私钥文件,详见这里

upstream

定义一组upstream servers,详见这里

示例

nginx官方有一个完整的示例

其它示例:

虚拟主机的示例

http {
 server {
 listen          80;
 server_name     www.domain1.com;
 access_log      logs/domain1.access.log main;
 location / {
 index index.html;
 root  /var/www/domain1.com/htdocs;
 }
 }
 server {
 listen          80;
 server_name     www.domain2.com;
 access_log      logs/domain2.access.log main;
 location / {
 index index.html;
 root  /var/www/domain2.com/htdocs;
 }
 }
}

负载均衡的示例

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;
 }
 }
}

更多

官方完整的指令列表

官方完整的变量列表

官方完整的内置模块列表

使用Nginx的X-Accel-Redirect实现下载的示例

使用mod_zip实现打包下载的示例

nginx反向代理WebSockets的示例

nginx反向代理WebSockets的示例

nginx利用image_filter动态生成缩略图的示例

nginx使用tcp代理实现HA的示例

增强nginx ssl安全性的教程

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

发表于

我来说两句

0 条评论
登录 后参与评论

相关文章

来自专栏斑斓

Spark Submit的ClassPath问题

需求场景: 我们的产品需要与客户的权限系统对接,即在登录时使用客户的认证系统进行认证。集成认证的方式是调用客户提供的jar包,调用userService的aut...

4799
来自专栏小狼的世界

IE对文档的解析模式及兼容性问题

深入研究这个问题源于最近制作的几个页面,交给前端后,发现在IE8下,对于JS动态控制的内容,页面高度不能够随着动态的调整。

1521
来自专栏分享达人秀

JDK的正确安装和配置

JDK的全称是Java Development Kit,翻译成中文就是Java开发工具包,主要包括Java运行环境、一些Java命令工具和Java基础的...

2166
来自专栏随笔

DNS的解析原理和过程

DNS的解析原理和过程: 在Internet上域名和IP是对应的,DNS解析有两种:一种是正向解析,另外一种是反向解析。 正向解析:正向解析就是将域名转换成对应...

1760
来自专栏木头编程 - moTzxx

CentOS下(rsync+crontab)触发式实现服务器间的文件备份同步

版权声明:本文为博主原创文章,未经博主允许不得转载。 https://blog.csdn.net/u011415782/article/de...

1812
来自专栏L宝宝聊IT

Web网站服务(Apache的安装)

2314
来自专栏我的小碗汤

微服务学习之thrift介绍安装

最近在做一个docker+Kubernetes微服务容器化实战项目,项目中用到了很多不熟悉的组件,也遇到了挺多的问题。项目结构是这样的:

2943
来自专栏开源优测

python selenium2 开发环境搭建

环境搭建 基于python和selenium2做自动化测试,你必须会搭建基本的开发环境,掌握python基本的语法和一个IDE来进行开发,这里通过详细的讲解,介...

2775
来自专栏闵开慧

eclipse中执行程序显示找不到主类

eclipse中执行程序显示找不到主类 这种情况一般出现在工程中已编译有class文件的java文件,而后面新建的java则不会出现问题。这种情况说明工程bin...

3375
来自专栏琦小虾的Binary

Ubuntu环境如何上传项目到GitHub网站?

Ubuntu环境如何上传项目到GitHub网站? 之前笔者写了一篇《CMake学习笔记(三)——以笔者的Robosub竞赛为例》的博客。博客中笔者以自己的项目为...

2708

扫码关注云+社区

领取腾讯云代金券