📝 Writing docs.

2018-10-12 18:32:15 +08:00 · 2018-10-12 18:32:15 +08:00 · e6e9884def
parent e6e27404a2
commit e6e9884def
2 changed files with 101 additions and 16 deletions
--- a/README.md
+++ b/README.md
@ -4,13 +4,11 @@
 >
 > [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 应用。
--- a/demos/README.md
+++ b/demos/README.md
@ -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,11 +120,11 @@ 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

@ -132,3 +134,63 @@ Nginx 配置文件：[demo03.conf](nginx-1.14.0/conf/demos/demo03.conf)
 <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)