Uh oh!
There was an error while loading.Please reload this page.
- Notifications
You must be signed in to change notification settings - Fork240
jaywcjlove/nginx-tutorial
Folders and files
| Name | Name | Last commit message | Last commit date | |
|---|---|---|---|---|
Repository files navigation
Nginx 是一款面向性能设计的 HTTP 服务器,能反向代理 HTTP、HTTPS 和邮件相关(SMTP、POP3、IMAP)的协议链接,并且提供了负载均衡以及 HTTP 缓存。它的设计充分使用异步事件模型,削减上下文调度的开销,提高服务器并发能力。采用了模块化设计,提供了丰富的第三方模块。
关于 Nginx,有这些标签:「异步」「事件」「模块化」「高性能」「高并发」「反向代理」「负载均衡」
Linux系统:Centos 7 x64
Nginx版本:1.11.5
prce(重定向支持)和 openssl(https 支持,如果不需要 https 可以不安装)。
yum install -y pcre-devel yum -y install gcc make gcc-c++ wgetyum -y install openssl openssl-devel
在 CentOS 6.5 上安装时,我选择了“基本服务器”,默认情况下这两个包都没有安装全,所以需要运行上述命令进行安装。
wget http://nginx.org/download/nginx-1.13.3.tar.gzwget http://nginx.org/download/nginx-1.13.7.tar.gz# 如果没有安装 wget$ yum install wget# 解压压缩包tar zxf nginx-1.13.3.tar.gz
然后进入目录编译安装,configure参数说明
cd nginx-1.11.5./configure....Configuration summary + using system PCRE library + OpenSSL library is not used + using system zlib library nginx path prefix:"/usr/local/nginx" nginx binary file:"/usr/local/nginx/sbin/nginx" nginx modules path:"/usr/local/nginx/modules" nginx configuration prefix:"/usr/local/nginx/conf" nginx configuration file:"/usr/local/nginx/conf/nginx.conf" nginx pid file:"/usr/local/nginx/logs/nginx.pid" nginx error log file:"/usr/local/nginx/logs/error.log" nginx http access log file:"/usr/local/nginx/logs/access.log" nginx http client request body temporary files:"client_body_temp" nginx http proxy temporary files:"proxy_temp" nginx http fastcgi temporary files:"fastcgi_temp" nginx http uwsgi temporary files:"uwsgi_temp" nginx http scgi temporary files:"scgi_temp"
安装报错误的话比如:“C compiler cc is not found”,这个就是缺少编译环境,安装一下就可以了yum -y install gcc make gcc-c++ openssl-devel
如果没有error信息,就可以执行下边的安装了:
makemake install
运行下面命令会出现两个结果,一般情况nginx会安装在/usr/local/nginx目录中
cd /usr/local/nginx/sbin/./nginx -t# nginx: the configuration file /usr/local/nginx/conf/nginx.conf syntax is ok# nginx: configuration file /usr/local/nginx/conf/nginx.conf test is successful
vi~/.bash_profile将下面内容添加到~/.bash_profile 文件中
PATH=$PATH:$HOME/bin:/usr/local/nginx/sbin/export PATH
运行命令source ~/.bash_profile 让配置立即生效。你就可以全局运行nginx 命令了。
Mac OSX 安装特别简单,首先你需要安装Brew, 通过brew 快速安装nginx。
brew install nginx# Updating Homebrew...# ==> Auto-updated Homebrew!# Updated 2 taps (homebrew/core, homebrew/cask).# ==> Updated Formulae# ==> Installing dependencies for nginx: openssl, pcre# ==> Installing nginx dependency: openssl# ==> Downloading https://homebrew.bintray.com/bottles/openssl-1.0.2o_1.high_sierra.bottle.tar.gz# ######################################################################## 100.0%# ==> Pouring openssl-1.0.2o_1.high_sierra.bottle.tar.gz# ==> Caveats# A CA file has been bootstrapped using certificates from the SystemRoots# keychain. To add additional certificates (e.g. the certificates added in# the System keychain), place .pem files in# /usr/local/etc/openssl/certs## and run# /usr/local/opt/openssl/bin/c_rehash## This formula is keg-only, which means it was not symlinked into /usr/local,# because Apple has deprecated use of OpenSSL in favor of its own TLS and crypto libraries.## If you need to have this software first in your PATH run:# echo 'export PATH="/usr/local/opt/openssl/bin:$PATH"' >> ~/.zshrc## For compilers to find this software you may need to set:# LDFLAGS: -L/usr/local/opt/openssl/lib# CPPFLAGS: -I/usr/local/opt/openssl/include# For pkg-config to find this software you may need to set:# PKG_CONFIG_PATH: /usr/local/opt/openssl/lib/pkgconfig## ==> Summary# 🍺 /usr/local/Cellar/openssl/1.0.2o_1: 1,791 files, 12.3MB# ==> Installing nginx dependency: pcre# ==> Downloading https://homebrew.bintray.com/bottles/pcre-8.42.high_sierra.bottle.tar.gz# ######################################################################## 100.0%# ==> Pouring pcre-8.42.high_sierra.bottle.tar.gz# 🍺 /usr/local/Cellar/pcre/8.42: 204 files, 5.3MB# ==> Installing nginx# ==> Downloading https://homebrew.bintray.com/bottles/nginx-1.13.12.high_sierra.bottle.tar.gz# ######################################################################## 100.0%# ==> Pouring nginx-1.13.12.high_sierra.bottle.tar.gz# ==> Caveats# Docroot is: /usr/local/var/www## The default port has been set in /usr/local/etc/nginx/nginx.conf to 8080 so that# nginx can run without sudo.## nginx will load all files in /usr/local/etc/nginx/servers/.## To have launchd start nginx now and restart at login:# brew services start nginx# Or, if you don't wacd /usr/local/Cellar/nginx/1.13.12/n just run:# cd /usr/local/Cellar/nginx/1.13.12/
注意默认端口不是8080 查看确认端口是否被占用。
brew services start nginx# http://localhost:8080/开机自启动方法一:
编辑vi /lib/systemd/system/nginx.service 文件,没有创建一个touch nginx.service 然后将如下内容根据具体情况进行修改后,添加到nginx.service文件中:
[Unit]Description=nginxAfter=network.target remote-fs.target nss-lookup.target[Service]Type=forkingPIDFile=/var/run/nginx.pidExecStartPre=/usr/local/nginx/sbin/nginx -t -c /usr/local/nginx/conf/nginx.confExecStart=/usr/local/nginx/sbin/nginx -c /usr/local/nginx/conf/nginx.confExecReload=/bin/kill -s HUP$MAINPIDExecStop=/bin/kill -s QUIT$MAINPIDPrivateTmp=true[Install]WantedBy=multi-user.target
[Unit]:服务的说明Description:描述服务After:描述服务类别[Service]服务运行参数的设置Type=forking是后台运行的形式ExecStart为服务的具体运行命令ExecReload为重启命令ExecStop为停止命令PrivateTmp=True表示给服务分配独立的临时空间
注意:[Service]的启动、重启、停止命令全部要求使用绝对路径。
[Install]运行级别下服务安装的相关设置,可设置为多用户,即系统运行级别为3。
保存退出。
设置开机启动,使配置生效:
# 启动nginx服务systemctl start nginx.service# 停止开机自启动systemctl disable nginx.service# 查看服务当前状态systemctl status nginx.service# 查看所有已启动的服务systemctl list-units --type=service# 重新启动服务systemctl restart nginx.service# 设置开机自启动systemctlenable nginx.service# 输出下面内容表示成功了Created symlink from /etc/systemd/system/multi-user.target.wants/nginx.service to /usr/lib/systemd/system/nginx.service.
systemctl is-enabled servicename.service# 查询服务是否开机启动systemctlenable*.service# 开机运行服务systemctl disable*.service# 取消开机运行systemctl start*.service# 启动服务systemctl stop*.service# 停止服务systemctl restart*.service# 重启服务systemctl reload*.service# 重新加载服务配置文件systemctl status*.service# 查询服务运行状态systemctl --failed# 显示启动失败的服务
注:*代表某个服务的名字,如http的服务名为httpd
开机自启动方法二:
vi /etc/rc.local# 在 rc.local 文件中,添加下面这条命令/usr/local/nginx/sbin/nginx start如果开机后发现自启动脚本没有执行,你要去确认一下rc.local这个文件的访问权限是否是可执行的,因为rc.local默认是不可执行的。修改rc.local访问权限,增加可执行权限:
# /etc/rc.local是/etc/rc.d/rc.local的软连接,chmod +x /etc/rc.d/rc.local# 启动/usr/local/nginx/sbin/nginx# 重启/usr/local/nginx/sbin/nginx -s reload# 关闭进程/usr/local/nginx/sbin/nginx -s stop# 平滑关闭nginx/usr/local/nginx/sbin/nginx -s quit# 查看nginx的安装状态,/usr/local/nginx/sbin/nginx -V
关闭防火墙,或者添加防火墙规则就可以测试了
service iptables stop
或者编辑配置文件:
vi /etc/sysconfig/iptables
添加这样一条开放80端口的规则后保存:
-A INPUT -m state --state NEW -m tcp -p tcp --dport 80 -j ACCEPT
重启服务即可:
service iptables restart# 命令进行查看目前natiptables -t nat -Lservice iptables restart# Redirecting to /bin/systemctl restart iptables.service# Failed to restart iptables.service: Unit iptables.service failed to load: No such file or directory.
在CentOS 7或RHEL 7或Fedora中防火墙由firewalld 来管理,当然你可以还原传统的管理方式。或则使用新的命令进行管理。假如采用传统请执行一下命令:
# 传统命令systemctl stop firewalldsystemctl mask firewalld# 安装命令yum install iptables-servicessystemctlenable iptables service iptables restart
如果通过yum安装,使用下面命令安装。
yum remove nginx
编译安装,删除/usr/local/nginx目录即可如果配置了自启动脚本,也需要删除。
| 参数 | 说明 |
|---|---|
--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 | 允许或不允许开启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 |
在Centos 默认配置文件在/usr/local/nginx-1.5.1/conf/nginx.conf 我们要在这里配置一些文件。nginx.conf是主配置文件,由若干个部分组成,每个大括号{}表示一个部分。每一行指令都由分号结束;,标志着一行的结束。
| 正则 | 说明 | 正则 | 说明 |
|---|---|---|---|
. | 匹配除换行符以外的任意字符 | $ | 匹配字符串的结束 |
? | 重复0次或1次 | {n} | 重复n次 |
+ | 重复1次或更多次 | {n,} | 重复n次或更多次 |
* | 重复0次或更多次 | [c] | 匹配单个字符c |
\d | 匹配数字 | [a-z] | 匹配a-z小写字母的任意一个 |
^ | 匹配字符串的开始 | - | - |
| 变量 | 说明 | 变量 | 说明 |
|---|---|---|---|
| $args | 这个变量等于请求行中的参数,同$query_string | $remote_port | 客户端的端口。 |
| $content_length | 请求头中的Content-length字段。 | $remote_user | 已经经过Auth Basic Module验证的用户名。 |
| $content_type | 请求头中的Content-Type字段。 | $request_filename | 当前请求的文件路径,由root或alias指令与URI请求生成。 |
| $document_root | 当前请求在root指令中指定的值。 | $scheme | HTTP方法(如http,https)。 |
| $host | 请求主机头字段,否则为服务器名称。 | $server_protocol | 请求使用的协议,通常是HTTP/1.0或HTTP/1.1。 |
| $http_user_agent | 客户端agent信息 | $server_addr | 服务器地址,在完成一次系统调用后可以确定这个值。 |
| $http_cookie | 客户端cookie信息 | $server_name | 服务器名称。 |
| $limit_rate | 这个变量可以限制连接速率。 | $server_port | 请求到达服务器的端口号。 |
| $request_method | 客户端请求的动作,通常为GET或POST。 | $request_uri | 包含请求参数的原始URI,不包含主机名,如:/foo/bar.php?arg=baz。 |
| $remote_addr | 客户端的IP地址。 | $uri | 不带请求参数的当前URI,$uri不包含主机名,如/foo/bar.html。 |
| $document_uri | 与$uri相同。 | - | - |
例如请求:http://localhost:3000/test1/test2/test.php
$host:localhost $server_port:3000 $request_uri:/test1/test2/test.php $document_uri:/test1/test2/test.php $document_root:/var/www/html $request_filename:/var/www/html/test1/test2/test.php| 符号 | 说明 | 符号 | 说明 | 符号 | 说明 |
|---|---|---|---|---|---|
| k,K | 千字节 | m,M | 兆字节 | ms | 毫秒 |
| s | 秒 | m | 分钟 | h | 小时 |
| d | 日 | w | 周 | M | 一个月, 30天 |
例如,"8k","1m" 代表字节数计量。
例如,"1h 30m","1y 6M"。代表 "1小时 30分","1年零6个月"。
nginx 的配置系统由一个主配置文件和其他一些辅助的配置文件构成。这些配置文件均是纯文本文件,全部位于 nginx 安装目录下的 conf 目录下。
指令由 nginx 的各个模块提供,不同的模块会提供不同的指令来实现配置。指令除了 Key-Value 的形式,还有作用域指令。
nginx.conf 中的配置信息,根据其逻辑上的意义,对它们进行了分类,也就是分成了多个作用域,或者称之为配置指令上下文。不同的作用域含有一个或者多个配置项。
下面的这些上下文指令是用的比较多:
| Directive | Description | Contains Directive |
|---|---|---|
| main | nginx 在运行时与具体业务功能(比如 http 服务或者 email 服务代理)无关的一些参数,比如工作进程数,运行的身份等。 | user, worker_processes, error_log, events, http, mail |
| http | 与提供 http 服务相关的一些配置参数。例如:是否使用 keepalive 啊,是否使用 gzip 进行压缩等。 | server |
| server | http 服务上支持若干虚拟主机。每个虚拟主机一个对应的 server 配置项,配置项里面包含该虚拟主机相关的配置。在提供 mail 服务的代理时,也可以建立若干 server. 每个 server 通过监听的地址来区分。 | listen, server_name, access_log, location, protocol, proxy, smtp_auth, xclient |
| location | http 服务中,某些特定的 URL 对应的一系列配置项。 | index, root |
| 实现 email 相关的 SMTP/IMAP/POP3 代理时,共享的一些配置项(因为可能实现多个代理,工作在多个监听地址上)。 | server, http, imap_capabilities | |
| include | 以便增强配置文件的可读性,使得部分配置文件可以重新使用。 | - |
| valid_referers | 用来校验Http请求头Referer是否有效。 | - |
| try_files | 用在server部分,不过最常见的还是用在location部分,它会按照给定的参数顺序进行尝试,第一个被匹配到的将会被使用。 | - |
| if | 当在location块中使用if指令,在某些情况下它并不按照预期运行,一般来说避免使用if指令。 | - |
例如我们再nginx.conf 里面引用两个配置 vhost/example.com.conf 和 vhost/gitlab.com.conf 它们都被放在一个我自己新建的目录 vhost 下面。nginx.conf 配置如下:
worker_processes 1;events{worker_connections1024;}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"'; #access_log logs/access.log main;sendfile on; #tcp_nopush on; #keepalive_timeout 0;keepalive_timeout65; #gzip on;server{listen80;server_name localhost;location /{root html;indexindex.htmlindex.htm;}error_page500502503504 /50x.html;location = /50x.html{root html;}}include vhost/example.com.conf;include vhost/gitlab.com.conf;}
简单的配置: example.com.conf
server{ #侦听的80端口listen80;server_name baidu.com app.baidu.com; # 这里指定域名indexindex.htmlindex.htm; # 这里指定默认入口页面root /home/www/app.baidu.com; # 这里指定目录}
Nginx提供了许多预定义的变量,也可以通过使用set来设置变量。你可以在if中使用预定义变量,也可以将它们传递给代理服务器。以下是一些常见的预定义变量,更多详见
| 变量名称 | 值 |
|---|---|
| $args_name | 在请求中的name参数 |
| $args | 所有请求参数 |
| $query_string | $args的别名 |
| $content_length | 请求头Content-Length的值 |
| $content_type | 请求头Content-Type的值 |
| $host | 如果当前有Host,则为请求头Host的值;如果没有这个头,那么该值等于匹配该请求的server_name的值 |
| $remote_addr | 客户端的IP地址 |
| $request | 完整的请求,从客户端收到,包括Http请求方法、URI、Http协议、头、请求体 |
| $request_uri | 完整请求的URI,从客户端来的请求,包括参数 |
| $scheme | 当前请求的协议 |
| $uri | 当前请求的标准化URI |
反向代理是一个Web服务器,它接受客户端的连接请求,然后将请求转发给上游服务器,并将从服务器得到的结果返回给连接的客户端。下面简单的反向代理的例子:
server{listen80;server_name localhost;client_max_body_size1024M; # 允许客户端请求的最大单文件字节数location /{proxy_passhttp://localhost:8080;proxy_set_header Host$host:$server_port;proxy_set_header X-Forwarded-For$remote_addr; # HTTP的请求端真实的IPproxy_set_header X-Forwarded-Proto$scheme; # 为了正确地识别实际用户发出的协议是http 还是 https}}
复杂的配置: gitlab.com.conf。
server{ #侦听的80端口listen80;server_name git.example.cn;location /{proxy_passhttp://localhost:3000; #以下是一些反向代理的配置可删除proxy_redirect off; #后端的Web服务器可以通过X-Forwarded-For获取用户真实IPproxy_set_header Host$host;client_max_body_size10m; #允许客户端请求的最大单文件字节数client_body_buffer_size128k; #缓冲区代理缓冲用户端请求的最大字节数proxy_connect_timeout300; #nginx跟后端服务器连接超时时间(代理连接超时)proxy_send_timeout300; #后端服务器数据回传时间(代理发送超时)proxy_read_timeout300; #连接成功后,后端服务器响应时间(代理接收超时)proxy_buffer_size4k; #设置代理服务器(nginx)保存用户头信息的缓冲区大小proxy_buffers 432k; #proxy_buffers缓冲区,网页平均在32k以下的话,这样设置proxy_busy_buffers_size64k; #高负荷下缓冲大小(proxy_buffers*2)}}
代理到上游服务器的配置中,最重要的是proxy_pass指令。以下是代理模块中的一些常用指令:
| 指令 | 说明 |
|---|---|
| proxy_connect_timeout | Nginx从接受请求至连接到上游服务器的最长等待时间 |
| proxy_send_timeout | 后端服务器数据回传时间(代理发送超时) |
| proxy_read_timeout | 连接成功后,后端服务器响应时间(代理接收超时) |
| proxy_cookie_domain | 替代从上游服务器来的Set-Cookie头的domain属性 |
| proxy_cookie_path | 替代从上游服务器来的Set-Cookie头的path属性 |
| proxy_buffer_size | 设置代理服务器(nginx)保存用户头信息的缓冲区大小 |
| proxy_buffers | proxy_buffers缓冲区,网页平均在多少k以下 |
| proxy_set_header | 重写发送到上游服务器头的内容,也可以通过将某个头部的值设置为空字符串,而不发送某个头部的方法实现 |
| proxy_ignore_headers | 这个指令禁止处理来自代理服务器的应答。 |
| proxy_intercept_errors | 使nginx阻止HTTP应答代码为400或者更高的应答。 |
upstream指令启用一个新的配置区段,在该区段定义一组上游服务器。这些服务器可能被设置不同的权重,也可能出于对服务器进行维护,标记为down。
upstream gitlab{ip_hash; # upstream的负载均衡,weight是权重,可以根据机器配置定义权重。weigth参数表示权值,权值越高被分配到的几率越大。server192.168.122.11:8081;server127.0.0.1:82 weight=3;server127.0.0.1:83 weight=3 down;server127.0.0.1:84 weight=3; max_fails=3 fail_timeout=20s;server127.0.0.1:85 weight=4;;keepalive32;}server{ #侦听的80端口listen80;server_name git.example.cn;location /{proxy_passhttp://gitlab; #在这里设置一个代理,和upstream的名字一样 #以下是一些反向代理的配置可删除proxy_redirect off; #后端的Web服务器可以通过X-Forwarded-For获取用户真实IPproxy_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_size10m; #允许客户端请求的最大单文件字节数client_body_buffer_size128k; #缓冲区代理缓冲用户端请求的最大字节数proxy_connect_timeout300; #nginx跟后端服务器连接超时时间(代理连接超时)proxy_send_timeout300; #后端服务器数据回传时间(代理发送超时)proxy_read_timeout300; #连接成功后,后端服务器响应时间(代理接收超时)proxy_buffer_size4k; #设置代理服务器(nginx)保存用户头信息的缓冲区大小proxy_buffers 432k;# 缓冲区,网页平均在32k以下的话,这样设置proxy_busy_buffers_size64k; #高负荷下缓冲大小(proxy_buffers*2)proxy_temp_file_write_size64k; #设定缓存文件夹大小,大于这个值,将从upstream服务器传}}
每个请求按时间顺序逐一分配到不同的后端服务器,如果后端服务器down掉,能自动剔除。
负载均衡:
upstream模块能够使用3种负载均衡算法:轮询、IP哈希、最少连接数。
轮询: 默认情况下使用轮询算法,不需要配置指令来激活它,它是基于在队列中谁是下一个的原理确保访问均匀地分布到每个上游服务器;
IP哈希: 通过ip_hash指令来激活,Nginx通过IPv4地址的前3个字节或者整个IPv6地址作为哈希键来实现,同一个IP地址总是能被映射到同一个上游服务器;
最少连接数: 通过least_conn指令来激活,该算法通过选择一个活跃数最少的上游服务器进行连接。如果上游服务器处理能力不同,可以通过给server配置weight权重来说明,该算法将考虑到不同服务器的加权最少连接数。
简单配置 ,这里我配置了2台服务器,当然实际上是一台,只是端口不一样而已,而8081的服务器是不存在的,也就是说访问不到,但是我们访问http://localhost 的时候,也不会有问题,会默认跳转到http://localhost:8080具体是因为Nginx会自动判断服务器的状态,如果服务器处于不能访问(服务器挂了),就不会跳转到这台服务器,所以也避免了一台服务器挂了影响使用的情况,由于Nginx默认是RR策略,所以我们不需要其他更多的设置
upstream test{server localhost:8080;server localhost:8081;}server{listen81;server_name localhost;client_max_body_size1024M;location /{proxy_passhttp://test;proxy_set_header Host$host:$server_port;}}
负载均衡的核心代码为
upstream test{server localhost:8080;server localhost:8081;}
指定轮询几率,weight和访问比率成正比,用于后端服务器性能不均的情况。 例如
upstream test{server localhost:8080 weight=9;server localhost:8081 weight=1;}
那么10次一般只会有1次会访问到8081,而有9次会访问到8080
上面的2种方式都有一个问题,那就是下一个请求来的时候请求可能分发到另外一个服务器,当我们的程序不是无状态的时候(采用了session保存数据),这时候就有一个很大的很问题了,比如把登录信息保存到了session中,那么跳转到另外一台服务器的时候就需要重新登录了,所以很多时候我们需要一个客户只访问一个服务器,那么就需要用iphash了,iphash的每个请求按访问ip的hash结果分配,这样每个访客固定访问一个后端服务器,可以解决session的问题。
upstream test{ip_hash;server localhost:8080;server localhost:8081;}
这是个第三方模块,按后端服务器的响应时间来分配请求,响应时间短的优先分配。
upstream backend{ fair;server localhost:8080;server localhost:8081;}
这是个第三方模块,按访问url的hash结果来分配请求,使每个url定向到同一个后端服务器,后端服务器为缓存时比较有效。 在upstream中加入hash语句,server语句中不能写入weight等其他的参数,hash_method是使用的hash算法
upstream backend{hash$request_uri; hash_method crc32;server localhost:8080;server localhost:8081;}
以上5种负载均衡各自适用不同情况下使用,所以可以根据实际情况选择使用哪种策略模式,不过fair和url_hash需要安装第三方模块才能使用
server指令可选参数:
- weight:设置一个服务器的访问权重,数值越高,收到的请求也越多;
- fail_timeout:在这个指定的时间内服务器必须提供响应,如果在这个时间内没有收到响应,那么服务器将会被标记为down状态;
- max_fails:设置在fail_timeout时间之内尝试对一个服务器连接的最大次数,如果超过这个次数,那么服务器将会被标记为down;
- down:标记一个服务器不再接受任何请求;
- backup:一旦其他服务器宕机,那么有该标记的机器将会接收请求。
keepalive指令:
Nginx服务器将会为每一个worker进行保持同上游服务器的连接。
在nginx的配置文件nginx.conf中加入如下配置,可以放到http, server, location, limit_except语句块,需要注意相对路径,本例当中nginx.conf,blocksip.conf在同一个目录中。
include blockip.conf;
在blockip.conf里面输入内容,如:
deny165.91.122.67;deny IP; # 屏蔽单个ip访问allow IP; # 允许单个ip访问deny all; # 屏蔽所有ip访问allow all; # 允许所有ip访问deny123.0.0.0/8 # 屏蔽整个段即从123.0.0.1到123.255.255.254访问的命令deny124.45.0.0/16 # 屏蔽IP段即从123.45.0.1到123.45.255.254访问的命令deny123.45.6.0/24 # 屏蔽IP段即从123.45.6.1到123.45.6.254访问的命令# 如果你想实现这样的应用,除了几个IP外,其他全部拒绝allow1.1.1.1;allow1.1.1.2;deny all;
./configure --prefix=/你的安装目录 --add-module=/第三方模块目录permanent永久性重定向。请求日志中的状态码为301redirect临时重定向。请求日志中的状态码为302
server{server_name old-site.comreturn301$scheme://new-site.com$request_uri;}
server{location = /oldpage.html{return301http://example.org/newpage.html;}}
location /old-site{rewrite ^/old-site/(.*)http://example.org/new-site/$1 permanent;}
允许浏览器基本上永久地缓存静态内容。 Nginx将为您设置Expires和Cache-Control头信息。
location /static{root /data;expires max;}
如果要求浏览器永远不会缓存响应(例如用于跟踪请求),请使用-1。
location = /empty.gif{empty_gif;expires -1;}
gzip on;gzip_buffers168k;gzip_comp_level 6;gzip_http_version 1.1;gzip_min_length256;gzip_proxied any;gzip_vary on;gzip_types text/xml application/xml application/atom+xml application/rss+xml application/xhtml+xml image/svg+xml text/javascript application/javascript application/x-javascript text/x-json application/json application/x-web-app-manifest+json text/css text/plain text/x-component font/opentype application/x-font-ttf application/vnd.ms-fontobject image/x-icon;gzip_disable"msie6";
open_file_cache max=1000 inactive=20s;open_file_cache_valid30s;open_file_cache_min_uses 2;open_file_cache_errors on;
ssl_session_cache shared:SSL:10m;ssl_session_timeout10m;
upstream backend{server127.0.0.1:8080;keepalive32;}server{ ...location /api/{proxy_passhttp://backend;proxy_http_version 1.1;proxy_set_header Connection"";}}
使用ngxtop实时解析nginx访问日志,并且将处理结果输出到终端,功能类似于系统命令top。所有示例都读取nginx配置文件的访问日志位置和格式。如果要指定访问日志文件和/或日志格式,请使用-f和-a选项。
注意:在nginx配置中/usr/local/nginx/conf/nginx.conf日志文件必须是绝对路径。
# 安装 ngxtoppip install ngxtop# 实时状态ngxtop# 状态为404的前10个请求的路径:ngxtop top request_path --filter'status == 404'# 发送总字节数最多的前10个请求ngxtop --order-by'avg(bytes_sent) * count'# 排名前十位的IP,例如,谁攻击你最多ngxtop --group-by remote_addr# 打印具有4xx或5xx状态的请求,以及status和http refererngxtop -i'status >= 400' print request status http_referer# 由200个请求路径响应发送的平均正文字节以'foo'开始:ngxtop avg bytes_sent --filter'status == 200 and request_path.startswith("foo")'# 使用“common”日志格式从远程机器分析apache访问日志ssh remote tail -f /var/log/apache2/access.log| ngxtop -f common
在工作中,有时候会遇到一些接口不支持跨域,这时候可以简单的添加add_headers来支持cors跨域。配置如下:
server{listen80;server_name api.xxx.com;add_header'Access-Control-Allow-Origin' '*';add_header'Access-Control-Allow-Credentials' 'true';add_header'Access-Control-Allow-Methods' 'GET,POST,HEAD';location /{proxy_passhttp://127.0.0.1:3000;proxy_set_header X-Real-IP$remote_addr;proxy_set_header X-Forwarded-For$proxy_add_x_forwarded_for;proxy_set_header Host$http_host;}}
上面更改头信息,还有一种,使用rewrite 指令重定向URI来解决跨域问题。
upstream test{server127.0.0.1:8080;server localhost:8081;}server{listen80;server_name api.xxx.com;location /{root html; #去请求../html文件夹里的文件indexindex.htmlindex.htm; #首页响应地址} # 用于拦截请求,匹配任何以 /api/开头的地址, # 匹配符合以后,停止往下搜索正则。location ^~/api/{ # 代表重写拦截进来的请求,并且只能对域名后边的除去传递的参数外的字符串起作用, # 例如www.a.com/proxy/api/msg?meth=1&par=2重写,只对/proxy/api/msg重写。 # rewrite后面的参数是一个简单的正则 ^/api/(.*)$, # $1代表正则中的第一个(),$2代表第二个()的值,以此类推。rewrite ^/api/(.*)$ /$1break; # 把请求代理到其他主机 # 其中 http://www.b.com/ 写法和 http://www.b.com写法的区别如下 # 如果你的请求地址是他 http://server/html/test.jsp # 配置一: http://www.b.com/ 后面有“/” # 将反向代理成 http://www.b.com/html/test.jsp 访问 # 配置一: http://www.b.com 后面没有有“/” # 将反向代理成 http://www.b.com/test.jsp 访问proxy_passhttp://test; # 如果 proxy_pass URL 是 http://a.xx.com/platform/ 这种情况 # proxy_cookie_path应该设置成 /platform/ / (注意两个斜杠之间有空格)。proxy_cookie_path /platfrom/ /; # http://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_pass_header # 设置 Cookie 头通过proxy_pass_header Set-Cookie;}}
server{listen80; # 配置正常的带www的域名server_name www.wangchujiang.com;root /home/www/wabg/download;location /{try_files$uri$uri/ /index.html =404;}}server{ # 这个要放到下面, # 将不带www的 wangchujiang.com 永久性重定向到 https://www.wangchujiang.comserver_name wangchujiang.com;rewrite ^(.*) https://www.wangchujiang.com$1 permanent;}
upstreamserver-api{ # api 代理服务地址server127.0.0.1:3110;}upstreamserver-resource{ # 静态资源 代理服务地址server127.0.0.1:3120;}server{listen3111;server_name localhost; # 这里指定域名root /home/www/server-statics; # 匹配 api 路由的反向代理到API服务location ^~/api/{rewrite ^/(.*)$ /$1break;proxy_passhttp://server-api;} # 假设这里验证码也在API服务中location ^~/captcha{rewrite ^/(.*)$ /$1break;proxy_passhttp://server-api;} # 假设你的图片资源全部在另外一个服务上面location ^~/img/{rewrite ^/(.*)$ /$1break;proxy_passhttp://server-resource;} # 路由在前端,后端没有真实路由,在路由不存在的 404状态的页面返回 /index.html # 这个方式使用场景,你在写React或者Vue项目的时候,没有真实路由location /{try_files$uri$uri/ /index.html =404; # ^ 空格很重要 }}
通过nginx -V 来查看是否有with-http_stub_status_module 该模块。
nginx -V这里V是大写的,如果是小写的v即nginx -v,则不会出现有哪些模块,只会出现nginx的版本
location /nginx_status{stub_status on;access_log off;}
通过http://127.0.0.1/nginx_status 访问出现下面结果。
Active connections: 3server accepts handled requests 7 7 5 Reading: 0 Writing: 1 Waiting: 2
- 主动连接(第 1 行)
当前与http建立的连接数,包括等待的客户端连接:3
- 服务器接受处理的请求(第 2~3 行)
接受的客户端连接总数目:7
处理的客户端连接总数目:7
客户端总的请求数目:5
- 读取其它信(第 4 行)
当前,nginx读请求连接
当前,nginx写响应返回给客户端
目前有多少空闲客户端请求连接
location ^~/api/upload{rewrite ^/(.*)$ /wfs/v1/uploadbreak;proxy_passhttp://wfs-api;}
超文本传输安全协议(缩写:HTTPS,英语:Hypertext Transfer Protocol Secure)是超文本传输协议和SSL/TLS的组合,用以提供加密通讯及对网络服务器身份的鉴定。HTTPS连接经常被用于万维网上的交易支付和企业信息系统中敏感信息的传输。HTTPS不应与在RFC 2660中定义的安全超文本传输协议(S-HTTP)相混。HTTPS 目前已经是所有注重隐私和安全的网站的首选,随着技术的不断发展,HTTPS 网站已不再是大型网站的专利,所有普通的个人站长和博客均可以自己动手搭建一个安全的加密的网站。
创建SSL证书,如果你购买的证书,就可以直接下载
sudo mkdir /etc/nginx/ssl# 创建了有效期100年,加密强度为RSA2048的SSL密钥key和X509证书文件。sudo openssl req -x509 -nodes -days 36500 -newkey rsa:2048 -keyout /etc/nginx/ssl/nginx.key -out /etc/nginx/ssl/nginx.crt# 上面命令,会有下面需要填写内容Country Name (2 letter code) [AU]:USState or Province Name (full name) [Some-State]:New YorkLocality Name (eg, city) []:New York CityOrganization Name (eg, company) [Internet Widgits Pty Ltd]:Bouncy Castles, Inc.Organizational Unit Name (eg, section) []:Ministry of Water SlidesCommon Name (e.g. server FQDN or YOUR name) []:your_domain.comEmail Address []:admin@your_domain.com
创建自签证书
首先,创建证书和私钥的目录# mkdir -p /etc/nginx/cert# cd /etc/nginx/cert创建服务器私钥,命令会让你输入一个口令:# openssl genrsa -des3 -out nginx.key 2048创建签名请求的证书(CSR):# openssl req -new -key nginx.key -out nginx.csr在加载SSL支持的Nginx并使用上述私钥时除去必须的口令:# cp nginx.key nginx.key.org# openssl rsa -in nginx.key.org -out nginx.key最后标记证书使用上述私钥和CSR:# openssl x509 -req -days 365 -in nginx.csr -signkey nginx.key -out nginx.crt
查看目前nginx编译选项
sbin/nginx -V输出下面内容
nginx version: nginx/1.7.8built by gcc 4.4.7 20120313 (Red Hat 4.4.7-4) (GCC)TLS SNI support enabledconfigure arguments: --prefix=/usr/local/nginx-1.7.8 --with-http_ssl_module --with-http_spdy_module --with-http_stub_status_module --with-pcre如果依赖的模块不存在,可以进入安装目录,输入下面命令重新编译安装。
./configure --prefix=/usr/local/nginx --with-http_stub_status_module --with-http_ssl_module
运行完成之后还需要make (不用make install)
# 备份nginx的二进制文件cp -rf /usr/local/nginx/sbin/nginx /usr/local/nginx/sbin/nginx.bak# 覆盖nginx的二进制文件cp -rf objs/nginx /usr/local/nginx/sbin/
HTTPS server
server{listen443ssl;server_name localhost;ssl_certificate /etc/nginx/ssl/nginx.crt;ssl_certificate_key /etc/nginx/ssl/nginx.key; # 禁止在header中出现服务器版本,防止黑客利用版本漏洞攻击server_tokens off; # 设置ssl/tls会话缓存的类型和大小。如果设置了这个参数一般是shared,buildin可能会参数内存碎片,默认是none,和off差不多,停用缓存。如shared:SSL:10m表示我所有的nginx工作进程共享ssl会话缓存,官网介绍说1M可以存放约4000个sessions。ssl_session_cache shared:SSL:1m; # 客户端可以重用会话缓存中ssl参数的过期时间,内网系统默认5分钟太短了,可以设成30m即30分钟甚至4h。ssl_session_timeout5m; # 选择加密套件,不同的浏览器所支持的套件(和顺序)可能会不同。 # 这里指定的是OpenSSL库能够识别的写法,你可以通过 openssl -v cipher 'RC4:HIGH:!aNULL:!MD5'(后面是你所指定的套件加密算法) 来看所支持算法。ssl_ciphers HIGH:!aNULL:!MD5; # 设置协商加密算法时,优先使用我们服务端的加密套件,而不是客户端浏览器的加密套件。ssl_prefer_server_ciphers on;location /{root html;indexindex.htmlindex.htm;}}
server{listen80;server_name example.com;rewrite ^ https://$http_host$request_uri? permanent; # 强制将http重定向到https # 在错误页面和“服务器”响应头字段中启用或禁用发射nginx版本。 防止黑客利用版本漏洞攻击server_tokens off;}
纯静态-html 支持
http{server{listen80;server_name www.domain1.com;access_log logs/domain1.access.log main;location /{indexindex.html;root /var/www/domain1.com/htdocs;}}server{listen80;server_name www.domain2.com;access_log logs/domain2.access.log main;location /{indexindex.html;root /var/www/domain2.com/htdocs;}}}
http{server{listen80 default;server_name _ *;access_log logs/default.access.log main;location /{indexindex.html;root /var/www/default/htdocs;}}}
根据User-Agent 过滤请求,通过一个简单的正则表达式,就可以过滤不符合要求的爬虫请求(初级爬虫)。
~*表示不区分大小写的正则匹配
location /{if($http_user_agent~*"python|curl|java|wget|httpclient|okhttp"){return503;} # 正常处理 # ...}
location~*\.(gif|jpg|png|swf|flv)${root htmlvalid_referers none blocked *.nginxcn.com;if($invalid_referer){rewrite ^/ www.nginx.cn #return 404;}}
alias指定的目录是准确的,root是指定目录的上级目录,并且该上级目录要含有location指定名称的同名目录。
location /img/{alias /var/www/image/;}# 访问/img/目录里面的文件时,ningx会自动去/var/www/image/目录找文件location /img/{root /var/www/image;}# 访问/img/目录下的文件时,nginx会去/var/www/image/img/目录下找文件。]
location~\/public\/(css|js|img)\/.*\.(js|css|gif|jpg|jpeg|png|bmp|swf){valid_referers none blocked *.jslite.io;if($invalid_referer){rewrite ^/http://wangchujiang.com/piratesp.png;}}
location~(.git|.gitattributes|.gitignore|.svn){deny all;}
http://wangchujiang.com/api/index.php?a=1&name=wcj ^ 有后缀http://wangchujiang.com/api/index?a=1&name=wcj ^ 没有后缀
nginx rewrite规则如下:
rewrite ^/(.*)/$ /index.php?/$1 permanent;if(!-d$request_filename){set$rule_1 1$rule_1;}if(!-f$request_filename){set$rule_1 2$rule_1;}if($rule_1 ="21"){rewrite ^/ /index.php last;}
https://github.com/cockpit-project/cockpit
server{ listen80; server_name cockpit.xxxxxxx.com; return301 https://$server_name$request_uri;}server{ listen443ssl; server_name cockpit.xxxxxxx.com; #ssl on; ssl_certificate /etc/nginx/cert/cockpit.xxxxxxx.com.pem; ssl_certificate_key /etc/nginx/cert/cockpit.xxxxxxx.com.key; location /{ root /; indexindex.html; proxy_redirect off; proxy_passhttp://websocket; proxy_http_version 1.1; proxy_set_header Upgrade$http_upgrade; proxy_set_header Connection"upgrade"; proxy_set_header Host$http_host; }}
这时输入域名,能看到登录页面,但登录后,显示不出内容,页面全白。这里要对cockpit.conf 进行设置修改。
sudo vim /etc/cockpit/cockpit.conf
参照如下配置修改,注意域名替换为your_domain_host:
[WebService]Origins = https://cockpit.xxxxxxx.com https://127.0.0.1:9090ProtocolHeader = X-Forwarded-ProtoAllowUnencrypted =true
The plain HTTP request was sent to HTTPS port
解决办法,fastcgi_param HTTPS $https if_not_empty 添加这条规则,
server{listen443ssl; # 注意这条规则server_name my.domain.com;fastcgi_param HTTPS$https if_not_empty;fastcgi_param HTTPS on;ssl_certificate /etc/ssl/certs/your.pem;ssl_certificate_key /etc/ssl/private/your.key;location /{ # Your config here...}}
- Nginx Office Hours 一个 nginx 模块,允许您仅在办公时间内提供访问访问网站。
- 负载均衡原理的解析
- Nginx泛域名解析,实现多个二级域名
- 深入 NGINX: 我们如何设计性能和扩展
- Inside NGINX: How We Designed for Performance & Scale
- Nginx开发从入门到精通
- Nginx的优化与防盗链
- 实战开发一个Nginx扩展 (Nginx Module)
- Nginx+Keepalived(双机热备)搭建高可用负载均衡环境(HA)
- Nginx 平滑升级
- Nginx最新模块—ngx_http_mirror_module分析可以做版本发布前的预先验证,进行流量放大后的压测等等
As always, thanks to our amazing contributors!
Made withaction-contributors.
Licensed under the MIT License.
About
Nginx安装维护入门学习笔记,以及各种实例。
Topics
Resources
License
Uh oh!
There was an error while loading.Please reload this page.
Stars
Watchers
Forks
Sponsor this project
Uh oh!
There was an error while loading.Please reload this page.
Packages0
Uh oh!
There was an error while loading.Please reload this page.
Contributors4
Uh oh!
There was an error while loading.Please reload this page.