📝 Writing docs.
parent
e6e27404a2
commit
e6e9884def
43
README.md
43
README.md
|
@ -1,16 +1,14 @@
|
||||||
# Nginx
|
# Nginx
|
||||||
|
|
||||||
> 本项目是一个 Nginx 极简教程,目的在于帮助新手快速入门 Nginx。
|
> 本项目是一个 Nginx 极简教程,目的在于帮助新手快速入门 Nginx。
|
||||||
>
|
>
|
||||||
> [demos](demos) 目录中的示例模拟了工作中的一些常用实战场景,并且都可以通过脚本一键式启动,让您可以快速看到演示效果。
|
> [demos](demos) 目录中的示例模拟了工作中的一些常用实战场景,并且都可以通过脚本一键式启动,让您可以快速看到演示效果。
|
||||||
|
|
||||||
<!-- TOC depthFrom:2 depthTo:4 -->
|
<!-- TOC depthFrom:2 depthTo:3 -->
|
||||||
|
|
||||||
- [概述](#概述)
|
- [概述](#概述)
|
||||||
- [安装与使用](#安装与使用)
|
- [安装与使用](#安装与使用)
|
||||||
- [安装](#安装)
|
- [安装](#安装)
|
||||||
- [从源代码编译 Nginx](#从源代码编译-nginx)
|
|
||||||
- [Windows 安装](#windows-安装)
|
|
||||||
- [使用](#使用)
|
- [使用](#使用)
|
||||||
- [nginx 配置实战](#nginx-配置实战)
|
- [nginx 配置实战](#nginx-配置实战)
|
||||||
- [http 反向代理配置](#http-反向代理配置)
|
- [http 反向代理配置](#http-反向代理配置)
|
||||||
|
@ -18,6 +16,7 @@
|
||||||
- [网站有多个 webapp 的配置](#网站有多个-webapp-的配置)
|
- [网站有多个 webapp 的配置](#网站有多个-webapp-的配置)
|
||||||
- [https 反向代理配置](#https-反向代理配置)
|
- [https 反向代理配置](#https-反向代理配置)
|
||||||
- [静态站点配置](#静态站点配置)
|
- [静态站点配置](#静态站点配置)
|
||||||
|
- [搭建文件服务器](#搭建文件服务器)
|
||||||
- [跨域解决方案](#跨域解决方案)
|
- [跨域解决方案](#跨域解决方案)
|
||||||
- [参考](#参考)
|
- [参考](#参考)
|
||||||
|
|
||||||
|
@ -29,17 +28,13 @@
|
||||||
|
|
||||||
**Nginx (engine x)** 是一款轻量级的 Web 服务器 、反向代理服务器及电子邮件(IMAP/POP3)代理服务器。
|
**Nginx (engine x)** 是一款轻量级的 Web 服务器 、反向代理服务器及电子邮件(IMAP/POP3)代理服务器。
|
||||||
|
|
||||||
<div align="center">
|
![](https://raw.githubusercontent.com/dunwu/JavaWeb/master/images/tools/nginx/nginx.jpg)
|
||||||
<img src="https://raw.githubusercontent.com/dunwu/JavaWeb/master/images/tools/nginx/nginx.jpg" />
|
|
||||||
</div>
|
|
||||||
|
|
||||||
**什么是反向代理?**
|
**什么是反向代理?**
|
||||||
|
|
||||||
反向代理(Reverse Proxy)方式是指以代理服务器来接受 internet 上的连接请求,然后将请求转发给内部网络上的服务器,并将从服务器上得到的结果返回给 internet 上请求连接的客户端,此时代理服务器对外就表现为一个反向代理服务器。
|
反向代理(Reverse Proxy)方式是指以代理服务器来接受 internet 上的连接请求,然后将请求转发给内部网络上的服务器,并将从服务器上得到的结果返回给 internet 上请求连接的客户端,此时代理服务器对外就表现为一个反向代理服务器。
|
||||||
|
|
||||||
<div align="center">
|
![](http://dunwu.test.upcdn.net/images/network/proxy-server.jpg)
|
||||||
<img src="https://raw.githubusercontent.com/dunwu/JavaWeb/master/images/tools/nginx/代理服务器.jpg" />
|
|
||||||
</div>
|
|
||||||
|
|
||||||
## 安装与使用
|
## 安装与使用
|
||||||
|
|
||||||
|
@ -445,6 +440,34 @@ http {
|
||||||
|
|
||||||
此时,在本地浏览器访问 static.zp.cn ,就可以访问静态站点了。
|
此时,在本地浏览器访问 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 应用。
|
web 领域开发中,经常采用前后端分离模式。这种模式下,前端和后端分别是独立的 web 应用程序,例如:后端是 Java 程序,前端是 React 或 Vue 应用。
|
||||||
|
|
|
@ -12,6 +12,8 @@
|
||||||
- [Demo01 - 简单的反向代理示例](#demo01---简单的反向代理示例)
|
- [Demo01 - 简单的反向代理示例](#demo01---简单的反向代理示例)
|
||||||
- [Demo02 - 负载均衡示例](#demo02---负载均衡示例)
|
- [Demo02 - 负载均衡示例](#demo02---负载均衡示例)
|
||||||
- [Demo03 - 多 webapp 示例](#demo03---多-webapp-示例)
|
- [Demo03 - 多 webapp 示例](#demo03---多-webapp-示例)
|
||||||
|
- [Demo04 - 前后端分离示例](#demo04---前后端分离示例)
|
||||||
|
- [Demo05 - 配置文件服务器示例](#demo05---配置文件服务器示例)
|
||||||
|
|
||||||
<!-- /TOC -->
|
<!-- /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-start.bat](nginx-1.14.0/nginx-start.bat)
|
||||||
- [nginx-stop.bat](nginx-1.14.0/nginx-stop.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
|
### scripts
|
||||||
|
|
||||||
|
@ -70,7 +72,7 @@ nginx-1.14.0 是 Nginx 的 windows 环境的 1.14.0 官方版本。之所以把
|
||||||
### Demo01 - 简单的反向代理示例
|
### Demo01 - 简单的反向代理示例
|
||||||
|
|
||||||
本示例启动一个 JavaApp,访问地址为:localhost:9010。
|
本示例启动一个 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:9022
|
||||||
- localhost:9023
|
- 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 中的配置要点就是为每个 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`
|
2. 配置 hosts:`127.0.0.1 www.demo03.com`
|
||||||
3. 在浏览器中访问:www.demo03.com
|
3. 在浏览器中访问:www.demo03.com
|
||||||
|
|
||||||
如图所示:三次访问的 context 和 端口号各不相同。说明 Nginx 根据不同的 context 将请求分发到指定的服务器上。
|
如图所示:三次访问的 context 和端口号各不相同。说明 Nginx 根据不同的 context 将请求分发到指定的服务器上。
|
||||||
|
|
||||||
<div align="center">
|
<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"/>
|
<img src="https://upload-images.jianshu.io/upload_images/3101171-ed726bdd60bea9ce.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240" width="600"/>
|
||||||
</div>
|
</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)
|
Loading…
Reference in New Issue