发布 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的网址了。
推荐阅读
-
Jexus 5.8.2正式发布! 为Asp.Net Core生产环境提供平台支持
-
ubuntu16.4下用jexus部署ASP.NET Core环境
-
Linux(Ubuntu)下搭建ASP.NET Core环境
-
Asp.net core利用MediatR进程内发布/订阅详解
-
详解ASP.NET Core 网站发布到Linux服务器
-
ASP.NET Core部署前期准备 使用Hyper-V安装Ubuntu Server 16.10
-
ASP.NET Core程序发布到Linux生产环境详解
-
ubuntu16.4下用jexus部署ASP.NET Core环境
-
Linux(Ubuntu)下搭建ASP.NET Core环境
-
详解ASP.NET Core部署项目到Ubuntu Server