dunwu
/
nginx-tutorial
mirror of https://github.com/dunwu/nginx-tutorial.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

📝 Writing docs.

pull/2/head
Zhang Peng 2018-10-12 18:32:15 +08:00
parent e6e27404a2
commit e6e9884def
2 changed files with 101 additions and 16 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

43
README.md
View File

@ -1,16 +1,14 @@
# Nginx
> 本项目是一个 Nginx 极简教程，目的在于帮助新手快速入门 Nginx。
>
>
> [demos](demos) 目录中的示例模拟了工作中的一些常用实战场景，并且都可以通过脚本一键式启动，让您可以快速看到演示效果。
<!-- TOC depthFrom:2 depthTo:4 -->
<!-- TOC depthFrom:2 depthTo:3 -->
- [概述](#概述)
- [安装与使用](#安装与使用)
- [安装](#安装)
- [从源代码编译 Nginx](#从源代码编译-nginx)
- [Windows 安装](#windows-安装)
- [使用](#使用)
- [nginx 配置实战](#nginx-配置实战)
- [http 反向代理配置](#http-反向代理配置)
@ -18,6 +16,7 @@
- [网站有多个 webapp 的配置](#网站有多个-webapp-的配置)
- [https 反向代理配置](#https-反向代理配置)
- [静态站点配置](#静态站点配置)
- [搭建文件服务器](#搭建文件服务器)
- [跨域解决方案](#跨域解决方案)
- [参考](#参考)
@ -29,17 +28,13 @@
**Nginx (engine x)** 是一款轻量级的 Web 服务器 、反向代理服务器及电子邮件（IMAP/POP3）代理服务器。
<div align="center">
<img src="https://raw.githubusercontent.com/dunwu/JavaWeb/master/images/tools/nginx/nginx.jpg" />
</div>
![](https://raw.githubusercontent.com/dunwu/JavaWeb/master/images/tools/nginx/nginx.jpg)
**什么是反向代理？**
反向代理（Reverse Proxy）方式是指以代理服务器来接受 internet 上的连接请求，然后将请求转发给内部网络上的服务器，并将从服务器上得到的结果返回给 internet 上请求连接的客户端，此时代理服务器对外就表现为一个反向代理服务器。
<div align="center">
<img src="https://raw.githubusercontent.com/dunwu/JavaWeb/master/images/tools/nginx/代理服务器.jpg" />
</div>
![](http://dunwu.test.upcdn.net/images/network/proxy-server.jpg)
## 安装与使用
@ -445,6 +440,34 @@ http {
此时，在本地浏览器访问 static.zp.cn ，就可以访问静态站点了。
### 搭建文件服务器
有时候，团队需要归档一些数据或资料，那么文件服务器必不可少。使用 Nginx 可以非常快速便捷的搭建一个简易的文件服务。
Nginx 中的配置要点：
- 将 autoindex 开启可以显示目录，默认不开启。
- 将 autoindex_exact_size 开启可以显示文件的大小。
- 将 autoindex_localtime 开启可以显示文件的修改时间。
- root 用来设置开放为文件服务的根路径。
- charset 设置为 `charset utf-8,gbk;`，可以避免中文乱码问题（windows 服务器下设置后，依然乱码，本人暂时没有找到解决方法）。
一个最简化的配置如下：
```nginx
autoindex on;# 显示目录
autoindex_exact_size on;# 显示文件大小
autoindex_localtime on;# 显示文件时间
server {
charset utf-8,gbk; # windows 服务器下设置后，依然乱码，暂时无解
listen 9050 default_server;
listen [::]:9050 default_server;
server_name _;
root /share/fs;
}
```
### 跨域解决方案
web 领域开发中，经常采用前后端分离模式。这种模式下，前端和后端分别是独立的 web 应用程序，例如：后端是 Java 程序，前端是 React 或 Vue 应用。

74
demos/README.md
View File

@ -12,6 +12,8 @@
- [Demo01 - 简单的反向代理示例](#demo01---简单的反向代理示例)
- [Demo02 - 负载均衡示例](#demo02---负载均衡示例)
- [Demo03 - 多 webapp 示例](#demo03---多-webapp-示例)
- [Demo04 - 前后端分离示例](#demo04---前后端分离示例)
- [Demo05 - 配置文件服务器示例](#demo05---配置文件服务器示例)
<!-- /TOC -->
@ -47,7 +49,7 @@ nginx-1.14.0 是 Nginx 的 windows 环境的 1.14.0 官方版本。之所以把
- [nginx-start.bat](nginx-1.14.0/nginx-start.bat)
- [nginx-stop.bat](nginx-1.14.0/nginx-stop.bat)
在 Nginx 默认配置文件 [nginx.conf](nginx-1.14.0/conf/nginx.conf) 中我通过配置 `include demos/*.conf;` 将 [Nginx/demos/nginx-1.14.0/conf/demos](nginx-1.14.0/conf/demos) 目录中所有 Nginx 配置示例都引入。
在 Nginx 默认配置文件 [nginx.conf](nginx-1.14.0/conf/nginx.conf) 中我通过配置 `include demos/*.conf;` 将 [Nginx/demos/nginx-1.14.0/conf/demos](nginx-1.14.0/conf/conf.d) 目录中所有 Nginx 配置示例都引入。
### scripts
@ -70,7 +72,7 @@ nginx-1.14.0 是 Nginx 的 windows 环境的 1.14.0 官方版本。之所以把
### Demo01 - 简单的反向代理示例
本示例启动一个 JavaApp，访问地址为：localhost:9010。
在 Nginx 中配置它的反向代理 host 为 www.demo01.com。Nginx 配置文件：[demo01.conf](nginx-1.14.0/conf/demos/demo01.conf)
在 Nginx 中配置它的反向代理 host 为 www.demo01.com。Nginx 配置文件：[demo01.conf](nginx-1.14.0/conf/conf.d/demo01.conf)
运行步骤：
@ -90,7 +92,7 @@ nginx-1.14.0 是 Nginx 的 windows 环境的 1.14.0 官方版本。之所以把
- localhost:9022
- localhost:9023
在 Nginx 中统一配置它们的反向代理 host 为 www.demo02.com，并设置相应权重，以便做负载均衡。Nginx 配置文件：[demo02.conf](nginx-1.14.0/conf/demos/demo02.conf)
在 Nginx 中统一配置它们的反向代理 host 为 www.demo02.com，并设置相应权重，以便做负载均衡。Nginx 配置文件：[demo02.conf](nginx-1.14.0/conf/conf.d/demo02.conf)
运行步骤：
@ -118,17 +120,77 @@ http 的默认端口号是 80，如果在一台服务器上同时启动这 3 个
Nginx 中的配置要点就是为每个 server 配置一个 upstream。并在 server 配置下的 location 中指定 context 对应的 upstream。
Nginx 配置文件：[demo03.conf](nginx-1.14.0/conf/demos/demo03.conf)
Nginx 配置文件：[demo03.conf](nginx-1.14.0/conf/conf.d/demo03.conf)
运行步骤：
1. 执行 [demo02-start.bat](scripts/demo03-start.bat) 脚本。
1. 执行 [demo03-start.bat](scripts/demo03-start.bat) 脚本。
2. 配置 hosts：`127.0.0.1 www.demo03.com`
3. 在浏览器中访问：www.demo03.com
如图所示：三次访问的 context 和 端口号各不相同。说明 Nginx 根据不同的 context 将请求分发到指定的服务器上。
如图所示：三次访问的 context 和端口号各不相同。说明 Nginx 根据不同的 context 将请求分发到指定的服务器上。
<div align="center">
<img src="https://upload-images.jianshu.io/upload_images/3101171-ed726bdd60bea9ce.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240" width="600"/>
</div>
### Demo04 - 前后端分离示例
做 web 开发，常常会把前后端分离，减少耦合。那么，前后端之间如何通信呢？可以使用 Nginx 来代理。
本例中，后端是一个 java web 项目；前端是一个 react 项目。
Nginx 中的配置要点
指定 root 参数为 react 项目构建后的静态文件存储路径。
指定后端应用的访问地址
```
location ~ ^/api/ {
proxy_pass http://backend;
rewrite "^/api/(.*)$" /$1 break;
}
```
Nginx 配置文件：[demo04.conf](nginx-1.14.0/conf/conf.d/demo04.conf)
运行准备：由于我的配置中设置 root 的路径为我自己机器中的绝对路径，所以，各位在运行本例的时候要根据自己的实际情况替换。
运行步骤：
1. 执行 [demo04-start.bat](scripts/demo04-start.bat) 脚本。
2. 配置 hosts：`127.0.0.1 www.demo04.com`
3. 在浏览器中访问：www.demo04.com
效果图：
![](http://oyz7npk35.bkt.clouddn.com/images/20180920181012180110.png)
按 F12 打开浏览器控制台，输入用户名/密码（admin/123456）执行登录操作。如下图所示，可以看到登录后的访问请求被转发到了 Nginx 配置的服务器地址。
![](http://oyz7npk35.bkt.clouddn.com/images/20180920181012180317.png)
### Demo05 - 配置文件服务器示例
有时候，团队需要归档一些数据或资料，那么文件服务器必不可少。使用 Nginx 可以非常快速便捷的搭建一个简易的文件服务。
Nginx 中的配置要点：
- 将 autoindex 开启可以显示目录，默认不开启。
- 将 autoindex_exact_size 开启可以显示文件的大小。
- 将 autoindex_localtime 开启可以显示文件的修改时间。
- root 用来设置开放为文件服务的根路径。
- charset 设置为 `charset utf-8,gbk;`，可以避免中文乱码问题（windows 服务器下设置后，依然乱码，本人暂时没有找到解决方法）。
Nginx 配置文件：[demo05.conf](nginx-1.14.0/conf/conf.d/demo05.conf)
运行准备：由于我的配置中设置 root 的路径为我自己机器中的绝对路径，所以，各位在运行本例的时候要根据自己的实际情况替换。
运行步骤：
1. 执行 [demo05-start.bat](scripts/demo05-start.bat) 脚本。
2. 配置 hosts：`127.0.0.1 www.demo05.com`
3. 在浏览器中访问：www.demo05.com
效果图如下：
![](http://oyz7npk35.bkt.clouddn.com/images/20180920181012181357.png)