Jin.FileServer 2.0.1

There is a newer version of this package available.
See the version list below for details.
dotnet add package Jin.FileServer --version 2.0.1
NuGet\Install-Package Jin.FileServer -Version 2.0.1
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Jin.FileServer" Version="2.0.1" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Jin.FileServer --version 2.0.1
#r "nuget: Jin.FileServer, 2.0.1"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install Jin.FileServer as a Cake Addin
#addin nuget:?package=Jin.FileServer&version=2.0.1

// Install Jin.FileServer as a Cake Tool
#tool nuget:?package=Jin.FileServer&version=2.0.1

v2.0版上线,不仅可以保证图片不失真,并支持防盗链

使用Jin.FileServer为你的.net core网站创建文件服务器

JinFileServer,可以让你在只保存一张原图的情况下,并且保证原图不失真的情况下, 无侵入的给现有.net core项目添加动态生成图片功能,并支持防盗链。

1. 使用方法

1.1 安装
Install-Package Jin.FileServer
gihub地址:https://github.com/jinchou/Jin.FileServer
1.2 配置
app.UseJinFileServer(env);

就是这么简单,一行代码搞定。

1.3 体验一把
保证项目wwwroot文件夹中有一张图片。
假设图片地址是:
https://localhost:44370/upload/201806/1.png
那么,使用浏览器访问:
https://localhost:44370/upload/201806/1.png_200x200.png

注:这样就会在原目录下面先生成名为1.png_200x200.png,大小为200x200的png文件, 然后输出到客户端!

再次访问这个地址,这个图片由于已存在,将直接输出到客户端浏览器。

2.图片生成参数

一个受JinFileServer托管的地址由:原图地址+图片生成参数构成。

2.1 图片生成参数格式:
_宽度 x 高度 转换后的格式

如:_200x200.png
完整地址如下:
https://localhost:44370/upload/201806/1.png_200x200.png

2.2 高级使用技巧
_200.png 表示生成宽度、高度均200的图片,并保证不失真的前提下,自动会填充背景色。
_200x.png 表示生成宽度200,高度自动缩放的图片。
_x200.png 表示生成高度200,宽度自动缩放的图片。
_200x480.png 表示生成宽度200,高度480的图片,并保证不失真的前提下,自动会填充背景色。

3. 配置说明

3.1 指定图片扩展名
app.UseJinFileServer(env, opt => { 
    opt.ImageFormats= new List<string> { 
        ".bmp", ".gif", ".jpg", ".jpeg", ".png" 
    };
});

注:也是默认值。 以上配置的扩展名,在访问的时候,会自动被JinFileServer托管,当访问的地址带有以上后缀时,且带有图片生成参数,那么JinFileServer会自动生成指定要求的图片。

3.2 指定可生成的图片尺寸
app.UseJinFileServer(env, opt => { 
     opt.ImageSizes =  new List<Size>
     {
         //80, 100, 200, 480, 500, 600, 800
         new Size(80,80),
         new Size(100,100),
         new Size(200,200),
         new Size(480,480),
         new Size(500,500),
         new Size(600,600),
         new Size(800,800),
     };
});

注:也是默认值。
没有配置的尺寸,在访问的时候,JinFileServer不会进行任何处理。

4. 记录

  1. 根据webp后缀,自动缩放文件大小 ags.jpg_500x500.jpg 加_是为了把真实路径区分开。
  2. 支持防盗链
  3. 支持一般文件,支持图片
  4. 支持设定某些尺寸可以设置为自动调整
Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
.NET Core netcoreapp2.1 is compatible.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
2.1.0 1,639 8/6/2018
2.0.1 1,720 6/21/2018
2.0.0 1,821 6/20/2018
1.1.1 1,774 6/17/2018
1.1.0 1,652 6/17/2018
1.0.0 1,802 6/17/2018