• 【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 消息转发了,反向代理就顺利完成了。

    好了,吃饭时间到了,今天煮的是牛肉,很久没吃牛肉了,赶紧开饭。

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

  • 相关阅读:
    IDEA 'Error:java: 无效的源发行版: 12' 解决方案
    E Golang语言之网络编程
    E 04 Golang语言之运算符
    ie表单提交提示下载文件
    日期初始化兼容
    IE8兼容问题总结---trim()方法
    es6变量声明和解构赋值
    js的call和apply拾遗
    prop&attr区别和用法,以多选框为例
    es6的箭头函数
  • 原文地址:https://www.cnblogs.com/tcjiaan/p/8350119.html
Copyright © 2020-2023  润新知