ASP.NET Core在Docker下面生成简易验证码

背景

验证码这个功能是十分常见的，各大系统的登录页面都会有。今天介绍一下最为普通的验证码。

无论最终给到前端的是图片格式的验证码还是base64格式的验证码，其实都离不开这样的一步操作，都要先在后台生成一个图片。

就个人经验来说，早期的.NET Core想在Linux/Docker下面搞图片这些还是相对麻烦一些的，首先是组件这一块，其次是依赖这一块。

不过，现在方便多了。

下面就基于ImageSharp这个组件来实践一下。

准备工作

安装相应的nuget包

<ItemGroup><PackageReference Include="SixLabors.ImageSharp" Version="1.0.0-beta0007" /><PackageReference Include="SixLabors.Fonts" Version="1.0.0-beta0009" /><PackageReference Include="SixLabors.ImageSharp.Drawing" Version="1.0.0-beta0007" />
</ItemGroup>

需要注意的是，ImageSharp目前还不是正式版。

准备一下字体文件

示例用的是comic.ttf，这个只有240kb，算是比较小的了。

这里选一个小一点的字体是因为不想让打包好的镜像太大，如果各位大佬有更小体积的字体可以告诉我一下哈。

编码实现

首先是生成随机数，应该不用说太多，如果先生成完成不一样的数字或字母，自由控制就好。

private static string GenCode(int num)
{var code = string.Empty;var r = new Random();for (int i = 0; i < num; i++){code += Chars[r.Next(Chars.Length)].ToString();}return code;
}

然后就是生成的核心代码了。

private static readonly Color[] Colors = { Color.Black, Color.Red, ... };
private static readonly char[] Chars = { '0', .... };
private static readonly int Width = 90;
private static readonly int Height = 35;public static (string code, byte[] bytes) GenVCode(int num)
{var code = GenCode(num);var r = new Random();using var image = new Image<Rgba32>(Width, Height);// 字体var font = SystemFonts.CreateFont(SystemFonts.Families.First().Name, 25, FontStyle.Bold);image.Mutate(ctx =>{// 白底背景ctx.Fill(Color.White);// 画验证码for (int i = 0; i < code.Length; i++){ctx.DrawText(code[i].ToString(), font, Colors[r.Next(Colors.Length)], new PointF(20 * i + 10, r.Next(2, 12)));}// 画干扰线for (int i = 0; i < 10; i++){var pen = new Pen(Colors[r.Next(Colors.Length)], 1);var p1 = new PointF(r.Next(Width), r.Next(Height));var p2 = new PointF(r.Next(Width), r.Next(Height));ctx.DrawLines(pen, p1, p2);}// 画噪点for (int i = 0; i < 80; i++){var pen = new Pen(Colors[r.Next(Colors.Length)], 1);var p1 = new PointF(r.Next(Width), r.Next(Height));var p2 = new PointF(p1.X + 1f, p1.Y + 1f);ctx.DrawLines(pen, p1, p2);}});using var ms = new System.IO.MemoryStream();// gif 格式image.SaveAsGif(ms);return (code, ms.ToArray());
}

都是中规中矩的代码，这里需要注意下面几个地方：

关于字体，这里取的是当前系统的第一个，如果系统一个字体都没有，那肯定是抛异常的。正常的.net core的docker镜像是没有的，所以这也是为什么我们在前面要准备字体的原因。
Fill、DrawText、DrawLines这三个画图的方法大家看看说明就可以了
对于生成格式，老黄这里用的是Gif，它支持Bmp，Gif，Jpeg，Png还有Base64，大家可以按需选择，这里建议用Gif或Jpeg，因为生成的图片会比较小，2.5kb左右。

最后就是调用了。

[HttpGet]
public IActionResult GetCode()
{var (code, bytes) = VCodeHelper.GenVCode(4);// code handle logicSystem.Console.WriteLine(code);return File(bytes, "image/gif");
}

Dockerfile

简单修改一下Dockerfile，加一句复制字体的命令。

FROM mcr.microsoft.com/dotnet/core/aspnet:3.1-buster-slim AS base
WORKDIR /app
EXPOSE 80# 复制字体到 /usr/share/fonts 目录
COPY ./comic.ttf /usr/share/fonts/comic.ttfFROM mcr.microsoft.com/dotnet/core/sdk:3.1-buster AS build
WORKDIR /src
COPY . .
RUN dotnet restore "VCodeTest.sln"
WORKDIR /src/VCodeTest
RUN dotnet build "VCodeTest.csproj" -c Release -o /app/buildFROM build AS publish
RUN dotnet publish "VCodeTest.csproj" -c Release -o /app/publishFROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .
ENTRYPOINT ["dotnet", "VCodeTest.dll"]

效果

生成镜像，运行效果如下：

文中的示例代码可以在我的github找到:

https://github.com/catcherwong-archive/2020/tree/master/05/VCodeTest

小结

ImageSharp 这个组件用起来还是挺舒服的，大家可以尝试尝试。