【Asp.net Core】在 Linux 子系统中安装 nginx 并配置反向代理

上一篇鸟文中，老周已经介绍过在 Ubuntu 子系统中安装 dotnet-sdk 的方法，本文老周给大伙伴们说说安装 nginx 服务，并配置反向代理。一样，老周假设你历来没有用过 Linux，因此老周会讲得很细。可能由于这样，博客园每次都把老周的文章撤下首页。无论他，他撤他的，我推个人，Who 怕 Who。

其实，你能够选择 nginx 或 Apache，不过老周更喜欢 nginx 一些，总以为 Apache 有些别扭。固然了，asp.net core 应用是能够独立运行，因此，你确实能够直接公开指向应用程序的 url，而不使用反向代理。不过，官方推荐使用服务器组件来反向代理。

所谓反向代理，说白了就是这样的：客户端发送 HTTP 请求，首先由 nginx 服务收到请求，而后把 HTTP 请求转发给 ASP.NET Core 应用程序，请求处理完后，回应消息也是沿原路返回，从.net 程序发回 nginx，再由 nginx 服务发回客户端。

好，少说 P 话，我们开始吧。

 

安装 nginx 服务

在上一篇中，老周说过把软件包更新源（sources.list）更改成国内的源，由于国外的源有时候很慢，并且常常会挂掉。上次老周演示的是使用网易的开源镜像，速度挺快的。如今，我们执行一下这条命令，这是个好习惯，每次安装软件前，update 一下软件源。

sudo apt update

这条命令仅仅更新软件源，就是你在 sources.list 或 sources.list.d 中配置的源，并非真正更新软件，要执行软件包更新，能够执行：

sudo apt upgrade

如今，我们安装一下 nginx。

sudo apt install nginx

 

 想运行 nginx ，输入如下命令。

sudo nginx

而后，在浏览器中访问 http://localhost，若是看到如下内容，说明你的 nginx 没问题了。

请你要严重注意，nginx 默认用的是 80 端口，请保证当前没有其余占用 80 端口服务运行，包括 IIS 也不行，若是是 Linux 子系统，它是共用 Windows 的资源的。

 

配置反向代理

咱们要配置的文件在  /etc/nginx/sites-enabled 目录下，有一个 default 文件，咱们只要修改它就能够了。

为了不权限问题，能够先切换到 root 上下文。

su

而后输入你设置的 root 密码就好了。

定位到 /etc/nginx/sites-enabled 目录。

cd /etc/nginx/sites-enabled

而后你能够 ls 一下，你会看到有个叫 default 的文件。

 

若是你不放心，能够用 cp default def.bak 备份一下，这里我就不备份了，直接 X 掉它的全部内容。

echo '' > default

上面这条命令老周前面介绍过，这样作能够把文件的内容清空，随后咱们用 nano 工具编辑。

nano default

在里面输入如下内容：

server{
       listen 80;
       location /{
                   proxy_pass http://localhost:15000;
                   proxy_set_header Host $host;
                   proxy_http_version 1.1;
                 }
}

 

nginx 能够按照不一样的模块进行配置，此处咱们须要配置反向代理，即 ngx_http_proxy_module 模块，该模块的字段你不用去记，在 nginx 官方网站能够查到完整文档的。

老周先给你说 nginx 配置的文件模型吧。其实它的格式很像一个 C 风格的类：

<块名称>
{
      字段名1 字段值1;
      字段名2 字段值2;
      字段名3 字段值3;
      ……
      字段名f
               {
                     字段名1 字段值1;
                     字段名2 字段值2;
                     ……
               }
}

首先你要放一个 server 节点。

server{
         .......
}

listen 字段表示监听的端口，这个就是 80 了，通常不用改。

接着咱们须要一个对路径的配置，即 location，反向代理就是用于转发，因此这个路径我们就用 / ，表示根目录。

location /{
            ......
}

而后就是为 location 节点配置几个字段，所有都是以 proxy 开头的。

proxy_pass：这个就是填上我们 asp.net Core 应用监听的端口，默认是 5000，主机名你直接写 localhost 就能够了，由于由 nginx 反向代理了，dotnet 应用是不对外公开的，因此你不用填网站的域名，客户端发送的请求是先到 nginx 再转发给 dotnet 应用。所以，你只须要让 nginx 服务器对外公开就好了。

proxy_set_header：这个字段是配置当 nginx 收到客户端请求后，把消息转发到 asp.net core 应用时添加的 HTTP 头，这个你能够按实际状况设置，若是你以为没什么标头有用的，能够不配置。此处我转传了 Host 头，值是变量 $host ，这是一个局部变量，运行时会由 nginx 服务填充具体的主机名。

proxy_http_version：这个是版本号，你也能够忽略的。

 

说到底，整个配置最关键的是 proxy_pass 字段，只有给它分配了值，nginx 服务才会知道你的 ASP.NET Core 应用在哪监听，才能顺利转发。

输入完后，按 ctrl + o 保存，而后按 ctrl + x 退出。

 

接着执行一下 -t 参数验证一下上面的配置是否正确。

nginx -t

若是看到“test is successful”说明配置无误。

随后还要让 nginx 从新加载一下配置，这样才会使之生效。

nginx -s reload

 

测试效果

下面我们新建一个 ASP.NET Core 应用项目来测试一下，类型选择“空”就好了，老周喜欢空模板，灵活。

修改 Main 方法，让监听端口指向刚刚上面 nginx 配置中指定的 15000 端口号。

        public static void Main(string[] args)
        {
            BuildWebHost(args).Run();
        }

        public static IWebHost BuildWebHost(string[] args) =>
            WebHost.CreateDefaultBuilder(args)
                .UseStartup<Startup>()
                .UseUrls("http://localhost:15000")
                .Build();

使用 UseUrls 方法能够指定监听的 URL，固然，你也能够用配置文件（.json）来设置，或者能够指定通配域名 http://*:15000。

而后修改 Startup 类。在 ConfigureServices 方法中，添加 MVC 服务功能。

        public void ConfigureServices(IServiceCollection services)
        {
            services.AddMvc();         }

在 Configure 方法中启用 MVC 功能。

        public void Configure(IApplicationBuilder app, IHostingEnvironment env)
        {
            if (env.IsDevelopment())
            {
                app.UseDeveloperExceptionPage();
            }

            app.UseMvc();         }

注意这两个地方是不一样的，前面 AddMvc 只是添加这个功能，并无启用，因此你随后要经过 Use 方法启用功能，并把与 MVC 相关的中间件插入 HTTP 通讯管道中，以处理 HTTP 请求。

 

我们这个项目只用来测试人品的，因此老周就不遵照 MVC 的规范了，不建 Views 、Controllers等目录了，反正老周向来都是不按常规出牌的。直接在项目中新建一个类，名字你随便取，按照约定，应该叫 XXXController，固然你也能够不这样叫，叫 Cat，叫 Pig 都行，只要类是从 Controller 类继承，运行时也能认的。

    public class DemoController : Controller
    {
        [HttpGet("/")]
        public IActionResult Start()
        {
            return View("~/Main.cshtml");
        }

        [HttpPost("/setdata")]
        public IActionResult Setdata([FromForm]int a, [FromForm]int b)
        {
            int r = a + b;
            return View("~/Show.cshtml", r);
        }
    }

注意，类必须是公共的，类的成员也要公共的，否则后面无法用。第一个 action 方法叫 Start，我加了 HttpGet 特性，以 GET 方式访问，并指定了“/”模板，代表你从应用的根 URL 就能执行这个 Start 方法，即输入 http://localhost:15000/，就能访问到。第二个 action 方法名叫 Setdata，HttpPost 表示以 POST 方式访问，路径是 http://localhost:15000/setdata。

Setdata 方法有两个参数，a和b。我给它们加了 FromForm 特性，啥意思呢，就是说客户端页面的 <form> 元素 POST 上来的内容中，必定要包含叫 a 和 b 的两个字段，这样参数 a 和 b 就会自动获取到值了。好比，客户端 POST 上来的是 a=5&b=9，那么 Setdata 方法的参数就能够得到值 a = 5，b = 9。

 

因为这个示例没有创建 Views 文件夹，按照默认的搜规则是找不到视图的，因此这里必定要指定视图的完整文件名。在新建视图页前，先建个布局页，能够做为母板。文件名为 _Layout.cshtml，内容以下：

<!DOCTYPE html>

<html>
<head>
    <meta name="viewport" content="width=device-width" charset="utf-8" />
    <title>@ViewBag.Title</title>
</head>
<body>
    <div>
        @RenderBody()
    </div>
</body>
</html>

RenderBody方法指定，其余视图页一旦套用这个母板页，就会用它的内容替换 RenderBody。

 

如今我们新建一个视图页—— Main.cshtml。

@{ 
    Layout = "~/_Layout.cshtml";
}

<div>
    <div>
        <h3>请输入参数</h3>
    </div>
    <div>
        <form method="post" action="/setdata">
            <div>
                <label for="a">第一个数：</label>
                <input type="text" name="a"/>
            </div>
            <div>
                <label for="b">
                    第二个数：
                </label>
                <input type="text" name="b"/>
            </div>
            <div>
                <button type="submit">肯定</button>
            </div>
        </form>
    </div>
</div>

Layout 属性引用母板页。form 元素的 action 值指向 Setdata 方法，刚刚我们用 HttpPost 特性定义了它的路径是 /setdata。

 

下面是第二个视图页—— Show.cshtml。

@{ Layout = "~/_Layout.cshtml"; }

@model int <div >
    <div >计算结果：</div>
    <div>@Model</div>
</div>

使用 @model 指令指定做为当前视图的 Model 属性的类型，这里用的是 int ，为啥呢，还记得 Setdata 方法吗？

        public IActionResult Setdata([FromForm]int a, [FromForm]int b)
        {
            int r = a + b;
            return View("~/Show.cshtml", r);         }

最后一句，在返回视图页的同时，把变量 r 的值也传递进去，它是 int 类型，所以，在 Show.cshtml 页面中应当以 int 类型界定 Model 属性。

在页面上，访问 Model 属性就能够获得传过来的计算结果了。

 <div>@Model</div>

 

好了，这个示例就完工了，先把这个示例运行起来，接着确保 nginx 已在 Linux 子系统中运行，若是不肯定，能够输入

service nginx status

若是看到这个，表示 nginx 正在运行。

若是 not running 的话，最简单一招，直接输入 nginx 回车，就会运行了。

 

在浏览器中输入 http://localhost，回车，默认端口是 80，不用输端口号。

若是出现这个，请检查 asp.net core 应用运行了没有。

 

 

 咱们随便输入两个整数。

而后提交，就会看到两个整数相加的结果了。

 

 如此，代表 nginx 已经成功将 HTTP 消息转发了，反向代理就顺利完成了。

好了，吃饭时间到了，今天煮的是牛肉，好久没吃牛肉了，赶忙开饭。

本文示例源码下载地址，请点击这里。