Linux(宝塔)部署.NetCore完整记录

前言

最近在V站上看到一个外卖推广的小程序，意思大概是类似淘宝联盟那种，别人走自己的链接后，自己可以抽取大概4%-6%的提成。觉得还蛮有意思的，一开始开源的是静态页面写死的，所以我这边用.Net Core写了个简单的后台。

左边是无后台的，右边红色框是后台配置的。当然功能是很简单的，主要是记录发布到Ubuntu18.4的时候遇到的问题与解决办法。

安装宝塔

宝塔Linux面板是提升运维效率的服务器管理软件，支持一键LAMP/LNMP/集群/监控/网站/FTP/数据库/JAVA等100多项服务器管理功能。

这里节省时间直接使用宝塔面板了，这个真的是太方便了，哈哈。安装也非常简单。

因为我使用的是Ubuntu，安装脚本

wget -O install.sh http://download.bt.cn/install/install-ubuntu_6.0.sh && sudo bash install.sh

其他版本请参考官方文档：https://www.bt.cn/download/linux.html

安装完成后会显示登录地址、用户名、密码信息。登录后浏览器将弹出推荐安装套件，为方便直接一键安装LNMP。

安装.NetCore SDK 3.1

微软官方文档：https://docs.microsoft.com/zh-cn/dotnet/core/install/linux-ubuntu

因为我使用的18.04，所以找到对应文档。

使用 APT 进行安装可通过几个命令来完成。安装 .NET 之前，请运行以下命令，将 Microsoft 包签名密钥添加到受信任密钥列表，并添加包存储库。

打开终端并运行以下命令：

wget https://packages.microsoft.com/config/ubuntu/18.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb sudo dpkg -i packages-microsoft-prod.deb

安装 SDK

.NET SDK 使你可以通过 .NET 开发应用。如果安装 .NET SDK，则无需安装相应的运行时。若要安装 .NET SDK，请运行以下命令：

sudo apt-get update;  sudo apt-get install -y apt-transport-https &&  sudo apt-get update &&  sudo apt-get install -y dotnet-sdk-3.1

安装运行时

sudo apt-get update;  sudo apt-get install -y apt-transport-https &&  sudo apt-get update &&  sudo apt-get install -y aspnetcore-runtime-3.1

作为 ASP.NET Core 运行时的一种替代方法，你可以安装不包含 ASP.NET Core 支持的 .NET 运行时：将上一命令中的 aspnetcore-runtime-5.0 替换为 dotnet-runtime-5.0：

sudo apt-get install -y dotnet-runtime-5.0

其实上述就是照搬微软的官方文档，官方文档还是写的很清楚的。

发布.NetCore项目

我一开始目标运行时选择的Linux-64，但是出现了这样的错误`错误 NU1605: 检测到包降级: XXXXXXXXXXXXX 从 4.3.0 降级到 XXXXXXXXXXXXX。直接从项目引用包以选择不同版本。

通过查看微软官方文档：https://docs.microsoft.com/zh-cn/nuget/reference/errors-and-warnings/nu1605

问题当在 .NET Core 3.0 或更高版本的项目中同时引用时，与 .NET Core 1.0 和1.1 随附的某些包组合不兼容。问题包通常以或开头 System. Microsoft. ，并具有4.0.0 和4.3.1 之间的版本号。在这种情况下，降级消息将具有从运行时开始的包。依赖关系链。

解决方案若要解决此问题，请添加以下 PackageReference：

<PackageReference Include="Microsoft.NETCore.Targets" Version="3.0.0" PrivateAssets="all" />

就是添加引用，但实际上你要保证所有项目的包引用版本是一致的。

另一种方法

发布的时候目标运行时直接选择可移植吧~

宝塔面板发布.Net Core项目,并启动项目

在文件 wwwroot新建项目文件夹，将本地发布文件打包拷贝至服务器解压。

在服务器上终端命令进入部署文件所在目录，然后使用dotnet命令启动服务：

dotnet XXXXXX.Admin.dll --urls "http://localhost:5000"

Nginx设置反代访问

现在我们还不能直接访问到我们新部署项目，需要使用Nginx设置反向代理，将特定的端口代理到http://localhost:5000，这一步可以通过宝塔面板来完成，步骤如下：

在宝塔面板上新建一个网站，设置为静态网站即可，并绑定好域名。

在刚才新建的网站中设置反向代理，目标URL填写http://localhost:5000即可，发送域名localhost

浏览器正式可访问项目，此处可能需要重启一下。

使用 Supervisor 守护进程

现在还有个问题，就是当我们关闭xShell等SSH工具的时候服务进程也会停止运行，我们可使用 Supervisor 守护进程运行。

在宝塔面板上安装Supervisor

添加守护进程（用户建议选择www，不要使用root）

问题

问题1

错误 NU1605: 检测到包降级: XXXXXXXXXXXXX 从 4.3.0 降级到 XXXXXXXXXXXXX。直接从项目引用包以选择不同版本

这个问题一开始我按照官方文档修改了，实际还是不可以。所以我选择了可移植发布的。而我在写这篇文章的时候又可以了。

问题2

验证码我使用了System.Drawing，不过在Linux下的话，这个是无法显示的。

解决办法

System.Drawing.Common 组件提供对GDI+图形功能的访问。它是依赖于GDI+的，那么在Linux上它如何使用GDI+，因为Linux上是没有GDI+的。Mono 团队使用C语言实现了GDI+接口，提供对非Windows系统的GDI+接口访问能力（个人认为是模拟GDI+，与系统图像接口对接），这个就是 libgdiplus。进而可以推测 System.Drawing.Common 这个组件实现时，对于非Windows系统肯定依赖了 ligdiplus 这个组件。如果我们当前系统不存在这个组件，那么自然会报错，找不到它，安装它即可解决。

Ubuntu一键命令
sudo curl https://raw.githubusercontent.com/stulzq/awesome-dotnetcore-image/master/install/ubuntu.sh|sh 
参考：https://www.cnblogs.com/stulzq/p/10172550.html

问题3

指定端口启动

修改Program.cs

增加代码

.ConfigureAppConfiguration(builder => { //dotnet test.dll --urls "http://*:5000;https://*:5001" builder.AddCommandLine(args);//设置添加命令行 })

完整代码

 public static IHostBuilder CreateHostBuilder(string[] args) => Host.CreateDefaultBuilder(args) //将默认ServiceProviderFactory指定为AutofacServiceProviderFactory https://autofaccn.readthedocs.io/en/latest/integration/aspnetcore.html#asp-net-core-3-0-and-generic-hosting .UseServiceProviderFactory(new AutofacServiceProviderFactory()) .ConfigureAppConfiguration(builder => { //dotnet test.dll --urls "http://*:5200;https://*:5100" builder.AddCommandLine(args);//设置添加命令行 }) .ConfigureWebHostDefaults(webBuilder => { webBuilder.UseStartup<Startup>(); });

问题4

验证码生成代码

验证码生成代码应该是蛮多的，我把我的分享下

using System; using System.Drawing; using System.Drawing.Drawing2D; using System.Drawing.Imaging; using System.IO; namespace XXX.Util { public static class ValidateCodeHelper { /// <summary> /// 验证码的最大长度 /// </summary> public static int MaxLength => 10; /// <summary> /// 验证码的最小长度 /// </summary> public static int MinLength => 1; /// <summary> /// 生成验证码 /// </summary> /// <param name="length">指定验证码的长度</param> /// <returns></returns> public static string CreateValidateCode(int length) { int[] randMembers = new int[length]; int[] validateNums = new int[length]; string validateNumberStr = ""; //生成起始序列值 int seekSeek = unchecked((int)DateTime.Now.Ticks); Random seekRand = new Random(seekSeek); int beginSeek = (int)seekRand.Next(0, Int32.MaxValue - length * 10000); int[] seeks = new int[length]; for (int i = 0; i < length; i++) { beginSeek += 10000; seeks[i] = beginSeek; } //生成随机数字 for (int i = 0; i < length; i++) { Random rand = new Random(seeks[i]); int pownum = 1 * (int)Math.Pow(10, length); randMembers[i] = rand.Next(pownum, Int32.MaxValue); } //抽取随机数字 for (int i = 0; i < length; i++) { string numStr = randMembers[i].ToString(); int numLength = numStr.Length; Random rand = new Random(); int numPosition = rand.Next(0, numLength - 1); validateNums[i] = Int32.Parse(numStr.Substring(numPosition, 1)); } //生成验证码 for (int i = 0; i < length; i++) { validateNumberStr += validateNums[i].ToString(); } return validateNumberStr; } /// <summary> /// 得到验证码图片的长度 /// </summary> /// <param name="validateNumLength">验证码的长度</param> /// <returns></returns> public static int GetImageWidth(int validateNumLength) { return (int)(validateNumLength * 12.0); } /// <summary> /// 得到验证码的高度 /// </summary> /// <returns></returns> public static double GetImageHeight() { return 22.5; } //C# MVC 升级版 /// <summary> /// 创建验证码的图片 /// </summary> /// <param name="validateCode">验证码</param> public static byte[] CreateValidateGraphic(string validateCode) { Bitmap image = new Bitmap((int)Math.Ceiling(validateCode.Length * 12.0), 22); Graphics g = Graphics.FromImage(image); try { //生成随机生成器 Random random = new Random(); //清空图片背景色 g.Clear(Color.White); //画图片的干扰线 for (int i = 0; i < 25; i++) { int x1 = random.Next(image.Width); int x2 = random.Next(image.Width); int y1 = random.Next(image.Height); int y2 = random.Next(image.Height); g.DrawLine(new Pen(Color.Silver), x1, y1, x2, y2); } Font font = new Font("Arial", 12, (FontStyle.Bold | FontStyle.Italic)); LinearGradientBrush brush = new LinearGradientBrush(new Rectangle(0, 0, image.Width, image.Height), Color.Blue, Color.DarkRed, 1.2f, true); g.DrawString(validateCode, font, brush, 3, 2); //画图片的前景干扰点 for (int i = 0; i < 100; i++) { int x = random.Next(image.Width); int y = random.Next(image.Height); image.SetPixel(x, y, Color.FromArgb(random.Next())); } //画图片的边框线 g.DrawRectangle(new Pen(Color.Silver), 0, 0, image.Width - 1, image.Height - 1); //保存图片数据 MemoryStream stream = new MemoryStream(); image.Save(stream, ImageFormat.Jpeg); //输出图片流 return stream.ToArray(); } finally { g.Dispose(); image.Dispose(); } } } }