README

Nginx 极简教程

 本项目是一个 Nginx 极简教程，目的在于帮助新手快速入门 Nginx。

 examples 目录中的示例模拟了工作中的一些常用实战场景，并且都可以通过脚本一键式启动，让您可以快速看到演示效果。



- 一、Nginx 简介
- 二、Nginx 入门
- 三、Nginx 实战
  - Http 反向代理
  - Https 反向代理
  - 负载均衡
  - 网站有多个 webapp 的配置
  - 静态站点
  - 搭建文件服务器
  - 解决跨域
- 资源



 一、Nginx 简介

什么是 Nginx?

Nginx (engine x) 是一款轻量级的 Web 服务器 、反向代理服务器及电子邮件（IMAP/POP3）代理服务器。

!img

什么是反向代理？

反向代理（Reverse Proxy）方式是指以代理服务器来接受 internet 上的连接请求，然后将请求转发给内部网络上的服务器，并将从服务器上得到的结果返回给 internet 上请求连接的客户端，此时代理服务器对外就表现为一个反向代理服务器。

!img

 二、Nginx 入门

 详细安装方法请参考：Nginx 运维

nginx 的使用比较简单，就是几条命令。

常用到的命令如下：

batch
nginx -s stop       快速关闭Nginx，可能不保存相关信息，并迅速终止web服务。
nginx -s quit       平稳关闭Nginx，保存相关信息，有安排的结束web服务。
nginx -s reload     因改变了Nginx相关配置，需要重新加载配置而重载。
nginx -s reopen     重新打开日志文件。
nginx -c filename   为 Nginx 指定一个配置文件，来代替缺省的。
nginx -t            不运行，仅仅测试配置文件。nginx 将检查配置文件的语法的正确性，并尝试打开配置文件中所引用到的文件。
nginx -v            显示 nginx 的版本。
nginx -V            显示 nginx 的版本，编译器版本和配置参数。


如果不想每次都敲命令，可以在 nginx 安装目录下新添一个启动批处理文件startup.bat，双击即可运行。内容如下：

batch
@echo off
rem 如果启动前已经启动nginx并记录下pid文件，会kill指定进程
nginx.exe -s stop

rem 测试配置文件语法正确性
nginx.exe -t -c conf/nginx.conf

rem 显示版本信息
nginx.exe -v

rem 按照指定配置去启动nginx
nginx.exe -c conf/nginx.conf


如果是运行在 Linux 下，写一个 shell 脚本，大同小异。

 三、Nginx 实战

我始终认为，各种开发工具的配置还是结合实战来讲述，会让人更易理解。

 Http 反向代理

我们先实现一个小目标：不考虑复杂的配置，仅仅是完成一个 http 反向代理。

nginx.conf 配置文件如下：

 _注：conf/nginx.conf 是 nginx 的默认配置文件。你也可以使用 nginx -c 指定你的配置文件_

nginx
运行用户
user somebody;

启动进程,通常设置成和cpu的数量相等
worker_processes  1;

全局错误日志
error_log  D:/Tools/nginx-1.10.1/logs/error.log;
error_log  D:/Tools/nginx-1.10.1/logs/notice.log  notice;
error_log  D:/Tools/nginx-1.10.1/logs/info.log  info;

PID文件，记录当前启动的nginx的进程ID
pid        D:/Tools/nginx-1.10.1/logs/nginx.pid;

工作模式及连接数上限
events {
    worker_connections 1024;    单个后台worker process进程的最大并发链接数
}

设定http服务器，利用它的反向代理功能提供负载均衡支持
http {
    设定mime类型(邮件支持类型),类型由mime.types文件定义
    include       D:/Tools/nginx-1.10.1/conf/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    D:/Tools/nginx-1.10.1/logs/access.log main;
    rewrite_log     on;

    sendfile 指令指定 nginx 是否调用 sendfile 函数（zero copy 方式）来输出文件，对于普通应用，
    必须设为 on,如果用来进行下载等应用磁盘IO重负载应用，可设置为 off，以平衡磁盘与网络I/O处理速度，降低系统的uptime.
    sendfile        on;
    tcp_nopush     on;

    连接超时时间
    keepalive_timeout  120;
    tcp_nodelay        on;

	gzip压缩开关
	gzip  on;

    设定实际的服务器列表
    upstream zp_server1{
        server 127.0.0.1:8089;
    }

    HTTP服务器
    server {
        监听80端口，80端口是知名端口号，用于HTTP协议
        listen       80;

        定义使用www.xx.com访问
        server_name  www.helloworld.com;

		首页
		index index.html

		指向webapp的目录
		root D:\01_Workspace\Project\github\zp\SpringNotes\spring-security\spring-shiro\src\main\webapp;

		编码格式
		charset utf-8;

		代理配置参数
        proxy_co