发布 ASP.NET Core 2.x 应用到 Ubuntu

简单绍一下如何将asp.net core 应用发布到linux （ubuntu）服务器上，都是文档的东西。

 

服务器结构

asp.net core 2.x 有两种server:

• http.sys 只支持windows，并支持一些windows独有的特性。
• kestrel，跨平台的服务器，高度优化，这个是建议的选项。

这两种server都可以直接服务应用（又叫做边缘服务器 edge server），也可以放在负载均衡或反向代理（reverse proxy）后边。

 

如果采用edge server这种方式:

这种情况下，你需要把证书添加到kestrel或http.sys来启用https。

但是这样以后不好扩展，因为没法做负载均衡，也没法把流量发送给别的server。

 

而如果把kestrel放在反向代理后边，例如iis或nginx：

 

这种情况下，reverse proxy可作为负载均衡器，它也可以作为为https配置证书的唯一地方。

今天要介绍的就是这种方式。

 

https

外边发过来https的请求到reverse proxy，然后它会使用http转发该请求到kestrel server，转发时还带着一些特殊的headers。

这样的话，像证书配置，加密，https这些工作就都交给了proxy server。

 

这些响应被proxy使用https返回：

 

这时，proxy server或负载均衡器在内层到kestrel的http连接上会带着几个header，这样我的kestrel就知道这个请求原来是不是https的。

主要是这三个header：

 

而在asp.net core的代码里，我们需要使用forwardheaders中间件，在startup.configure方法里面修改:

注意它的位置应该在usehttpsredirection，useauthentication，usemvc，usestaticfiles之前。

中间件里面配置是表示让asp.net core来查看xforwardedfor和xforwardedproto两个header。

 

发布到ubuntu

安装.net core 

首先需要安装.net core runtime: 

点击之后，根据您的linux发行版不同，选择相应的操作步骤：

最后执行dotnet --info验证安装是否成功：

 

安装nginx

另外还需要安装nginx，直接查看官网文档吧：

安装好后，访问这个页面：http://你的ip地址/index.nginx-debian.html，如果看到如下效果说明安装成功：

 

在服务器构建源码并发布

然后就是发布程序了，发布有两种办法：

• 在开发机上执行dotnet publish然后把发布的文件复制到服务器上
• 或者直接在服务器上使用源码构建并发布，我一般是这样做的。

由于我是直接在服务器上构建发布，所以我需要安装.net core sdk：

 

然后就可以使用发布命令了：dotnet publish --configuration release。

发布好的文件在bin/release/netcoreapp*.*/publish下面。

再把publish下的所有文件复制到我的目标文件夹即可：

在我的目标目录下，有这些文件：

 

如果执行 dotnet test.dll，这个程序就会在localhost:5000运行：

 

配置nginx

然后我们再回来配置nginx，进入/etc/nginx/sites-available，里面有一个default文件，把它改个名，然后我们再建立一个新的default文件：

 

保存后执行sudo nginx -t检验这个配置文件。

然后再执行 nginx -s reload 来重启nginx。

随后需要再把发布后的程序运行一下：dotnet test.dll：

 

在我使用网址访问80端口的时候，会自动跳转到5001端口，导致连接失败：

这是因为项目里默认使用了https redirection。因为我没有证书，所以为了演示，我把https redirection相关的代码注释掉，再发布：

 

重复上述步骤之后，通过网址的80端口，就可以正常访问了：

 

nginx配置证书和https

配置https和证书相关的内容直接去看官方文档：

添加proxy.conf和编辑nginx.conf后重启nginx即可。

 

按照操作，运行后如果不能使用https正常访问网站，那么有可能是无法绑定443端口导致的。

查看nginx错误日志：/var/log/nginx/error.log，如果出现下面的错误：

可以执行下列命令来解决：

sudo fuser -k 443/tcp
service nginx restart

 

然后再次访问https网址：

这样就可以正常访问https的网址了。