README.md · devin.gong/Furion

[![star](https://gitee.com/monksoul/Furion/badge/star.svg?theme=gvp)](https://gitee.com/monksoul/Furion/stargazers) [![fork](https://gitee.com/monksoul/Furion/badge/fork.svg?theme=gvp)](https://gitee.com/monksoul/Furion/members) [![GitHub stars](https://img.shields.io/github/stars/MonkSoul/Furion?logo=github)](https://github.com/MonkSoul/Furion/stargazers) [![GitHub forks](https://img.shields.io/github/forks/MonkSoul/Furion?logo=github)](https://github.com/MonkSoul/Furion/network) [![GitHub license](https://img.shields.io/badge/license-Apache2-yellow)](https://gitee.com/monksoul/Furion/blob/master/LICENSE) [![nuget](https://img.shields.io/nuget/v/Furion.svg?cacheSeconds=10800)](https://www.nuget.org/packages/Furion)

</div>

让 .NET 开发更简单，更通用，更流行。

</div>

## 💐 序言

> 无私奉献不是天方夜谭，有时候，我们也可以做到。

## 🍕 名字的由来

> 故事是这样子的：
>
> 自微软宣布 `.NET 5` 平台消息之后，就琢磨着开发一个基于 `.NET 5` 平台的开发框架，想做第一个吃 `.NET 5` 螃蟹尝鲜之人。
>
> 一开始想到了 `Lazier` 作为框架的名称，中文有 **更懒** 的意思。符合我的 “一切从简，只为了更懒” 的开发理念。
>
> 但是 **更懒** 和 **更烂** 中文读音相近且没有特色，而且寓意也不是很好，对此换名问题苦恼了好些天。
>
> 刚好有一次在 QQ 群中无意间刷到了群友发的 **“先知”** 单词：**“`Furion`”**，就那一刻，就认定它了！
>
> `Furion` 中文有 `先知` 的意思，恰好符合我创造框架的初衷。所以，**`Furion`** 就诞生了。

## 🍔 关于 LOGO

`Furion` 标志设计理念是借鉴著名的 [袋鼠理论](https://baike.baidu.com/item/%E8%A2%8B%E9%BC%A0%E7%90%86%E8%AE%BA) 设计的。

袋鼠具有**长腿、育袋、自我奔跑**特点。

- `长腿`：代表着 `Furion` 拥有稳健的双腿，走在科技的前沿，走的更远，跑的更快。
- `育袋`：小育袋、大作为。期待 `Furion` 能够育孕出更多 .NET 优秀开发者和生机勃勃的生态。
- `自我奔跑`：`Furion` 自身也要不断学习、不断进步、不断创新、不断开拓。

## 🍯 开源案例

- **[考试君](https://gitee.com/pig0224/ExamKing)**：基于 `Furion` 的在线考试系统
- **[园丁](https://gitee.com/hgflydream/Gardener)**：基于 `Furion` + `Blazor` 的超简单后台管理系统
- **[Queer](https://gitee.com/songzhidan/queer)**：基于 `Furion` + `Layui` 的通用型管理系统
- **[Pear Admin](https://gitee.com/pear-admin/pear-admin-furion)**：`PearAdmin` 官方和 `Furion` 官方合作管理系统
- **[JoyAdmin](https://gitee.com/a106_admin/joy-admin)**：基于 `Furion` + `iviewadmin` 开发的管理系统

## 🍟 文档地址

- 国内文档：[https://monksoul.gitee.io/furion/](https://monksoul.gitee.io/furion/)
- 国外文档：[https://furion.pro](https://furion.pro)

**目前文档正在逐步完善中。**

## 🥦 系列教程

- **Furion 视频教程：[https://space.bilibili.com/695987967](https://space.bilibili.com/695987967)**
- Furion 使用例子：[https://gitee.com/monksoul/furion-samples](https://gitee.com/monksoul/furion-samples) **可能大部分示例已经不通用**
- Furion 系列教程：[《学 .NET 5 从 Furion 开始》](https://gitee.com/monksoul/Furion/blob/main/tutorials) 系列

## 🌭 开源地址

- Gitee：[https://gitee.com/monksoul/Furion](https://gitee.com/monksoul/Furion)
- GitHub：[https://github.com/monksoul/Furion](https://github.com/monksoul/Furion)
- Docker：[https://hub.docker.com/r/monksoul/furion](https://hub.docker.com/r/monksoul/furion)
- Nuget：[https://www.nuget.org/packages/Furion](https://www.nuget.org/packages/Furion)

## 🍿 Docker 镜像

- `Docker Hub` 线上镜像

```shell
docker run --name furion -p 5000:80 monksoul/furion:v1.4.3
```

- `手动` 打包镜像

打开 `CMD/Shell/PowerShell` 进入 `Furion` 项目根目录打包 `Furion` 镜像：

```shell
docker build -t furion:v1.4.3 .
```

打包成功后，直接 `docker run`：

```shell
docker run --name furion -p 5000:80 furion:v1.4.3
```

## 🥥 Furion 官方包

|                                                                     包类型                                                                      | 名称                                       |                                                                                          版本                                                                                           | 描述                       |
| :---------------------------------------------------------------------------------------------------------------------------------------------: | ------------------------------------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | -------------------------- |
|                   [![nuget](https://shields.io/badge/-Nuget-blue?cacheSeconds=604800)](https://www.nuget.org/packages/Furion)                   | Furion                                     |                                     [![nuget](https://img.shields.io/nuget/v/Furion.svg?cacheSeconds=10800)](https://www.nuget.org/packages/Furion)                                     | Furion 核心包              |
|   [![nuget](https://shields.io/badge/-Nuget-blue?cacheSeconds=604800)](https://www.nuget.org/packages/Furion.Extras.Authentication.JwtBearer)   | Furion.Extras.Authentication.JwtBearer     |     [![nuget](https://img.shields.io/nuget/v/Furion.Extras.Authentication.JwtBearer.svg?cacheSeconds=10800)](https://www.nuget.org/packages/Furion.Extras.Authentication.JwtBearer)     | Furion Jwt 拓展包          |
| [![nuget](https://shields.io/badge/-Nuget-blue?cacheSeconds=604800)](https://www.nuget.org/packages/Furion.Extras.DependencyModel.CodeAnalysis) | Furion.Extras.DependencyModel.CodeAnalysis | [![nuget](https://img.shields.io/nuget/v/Furion.Extras.DependencyModel.CodeAnalysis.svg?cacheSeconds=10800)](https://www.nuget.org/packages/Furion.Extras.DependencyModel.CodeAnalysis) | Furion CodeAnalysis 拓展包 |
|       [![nuget](https://shields.io/badge/-Nuget-blue?cacheSeconds=604800)](https://www.nuget.org/packages/Furion.Extras.Web.HttpContext)        | Furion.Extras.Web.HttpContext              |              [![nuget](https://img.shields.io/nuget/v/Furion.Extras.Web.HttpContext.svg?cacheSeconds=10800)](https://www.nuget.org/packages/Furion.Extras.Web.HttpContext)              | Furion HttpContext 拓展包  |
|     [![nuget](https://shields.io/badge/-Nuget-blue?cacheSeconds=604800)](https://www.nuget.org/packages/Furion.Extras.ObjectMapper.Mapster)     | Furion.Extras.ObjectMapper.Mapster         |         [![nuget](https://img.shields.io/nuget/v/Furion.Extras.ObjectMapper.Mapster.svg?cacheSeconds=10800)](https://www.nuget.org/packages/Furion.Extras.ObjectMapper.Mapster)         | Furion Mapster 拓展包      |
|  [![nuget](https://shields.io/badge/-Nuget-blue?cacheSeconds=604800)](https://www.nuget.org/packages/Furion.Extras.DatabaseAccessor.SqlSugar)   | Furion.Extras.DatabaseAccessor.SqlSugar    |    [![nuget](https://img.shields.io/nuget/v/Furion.Extras.DatabaseAccessor.SqlSugar.svg?cacheSeconds=10800)](https://www.nuget.org/packages/Furion.Extras.DatabaseAccessor.SqlSugar)    | Furion SqlSugar 拓展包     |
|   [![nuget](https://shields.io/badge/-Nuget-blue?cacheSeconds=604800)](https://www.nuget.org/packages/Furion.Extras.DatabaseAccessor.Dapper)    | Furion.Extras.DatabaseAccessor.Dapper      |      [![nuget](https://img.shields.io/nuget/v/Furion.Extras.DatabaseAccessor.Dapper.svg?cacheSeconds=10800)](https://www.nuget.org/packages/Furion.Extras.DatabaseAccessor.Dapper)      | Furion Dapper 拓展包       |
|       [![nuget](https://shields.io/badge/-Nuget-blue?cacheSeconds=604800)](https://www.nuget.org/packages/Furion.Extras.Logging.Serilog)        | Furion.Extras.Logging.Serilog              |              [![nuget](https://img.shields.io/nuget/v/Furion.Extras.Logging.Serilog.svg?cacheSeconds=10800)](https://www.nuget.org/packages/Furion.Extras.Logging.Serilog)              | Furion Serilog 拓展包      |

## 🍄 Furion 脚手架

|                                                                 模板类型                                                                 | 名称                             |                                                                                 版本                                                                                 | 描述                   |
| :--------------------------------------------------------------------------------------------------------------------------------------: | -------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------: | ---------------------- |
|       [![nuget](https://shields.io/badge/-Nuget-yellow?cacheSeconds=604800)](https://www.nuget.org/packages/Furion.Template.Mvc/)        | Furion.Template.Mvc              |              [![nuget](https://img.shields.io/nuget/v/Furion.Template.Mvc.svg?cacheSeconds=10800)](https://www.nuget.org/packages/Furion.Template.Mvc/)              | Mvc 模板               |
|       [![nuget](https://shields.io/badge/-Nuget-yellow?cacheSeconds=604800)](https://www.nuget.org/packages/Furion.Template.Api/)        | Furion.Template.Api              |              [![nuget](https://img.shields.io/nuget/v/Furion.Template.Api.svg?cacheSeconds=10800)](https://www.nuget.org/packages/Furion.Template.Api/)              | WebApi 模板            |
|       [![nuget](https://shields.io/badge/-Nuget-yellow?cacheSeconds=604800)](https://www.nuget.org/packages/Furion.Template.App/)        | Furion.Template.App              |              [![nuget](https://img.shields.io/nuget/v/Furion.Template.App.svg?cacheSeconds=10800)](https://www.nuget.org/packages/Furion.Template.App/)              | Mvc/WebApi 模板        |
|      [![nuget](https://shields.io/badge/-Nuget-yellow?cacheSeconds=604800)](https://www.nuget.org/packages/Furion.Template.Razor/)       | Furion.Template.Razor            |            [![nuget](https://img.shields.io/nuget/v/Furion.Template.Razor.svg?cacheSeconds=10800)](https://www.nuget.org/packages/Furion.Template.Razor/)            | RazorPages 模板        |
| [![nuget](https://shields.io/badge/-Nuget-yellow?cacheSeconds=604800)](https://www.nuget.org/packages/Furion.Template.RazorWithWebApi/)  | Furion.Template.RazorWithWebApi  |  [![nuget](https://img.shields.io/nuget/v/Furion.Template.RazorWithWebApi.svg?cacheSeconds=10800)](https://www.nuget.org/packages/Furion.Template.RazorWithWebApi/)  | RazorPages/WebApi 模板 |
|      [![nuget](https://shields.io/badge/-Nuget-yellow?cacheSeconds=604800)](https://www.nuget.org/packages/Furion.Template.Blazor/)      | Furion.Template.Blazor           |           [![nuget](https://img.shields.io/nuget/v/Furion.Template.Blazor.svg?cacheSeconds=10800)](https://www.nuget.org/packages/Furion.Template.Blazor/)           | Blazor 模板            |
| [![nuget](https://shields.io/badge/-Nuget-yellow?cacheSeconds=604800)](https://www.nuget.org/packages/Furion.Template.BlazorWithWebApi/) | Furion.Template.BlazorWithWebApi | [![nuget](https://img.shields.io/nuget/v/Furion.Template.BlazorWithWebApi.svg?cacheSeconds=10800)](https://www.nuget.org/packages/Furion.Template.BlazorWithWebApi/) | Blazor/WebApi 模板     |

**[如何使用脚手架](https://monksoul.gitee.io/furion/docs/template)**

## 🍎 框架特点

- 全新面貌：基于 `.NET 5` 平台，没有历史包袱
- 极易入门：只需要一个 `Inject()` 即可完成配置
- 极速开发：内置丰富的企业应用开发功能
- 极少依赖：框架只依赖两个第三方包
- 极其灵活：轻松面对多变复杂的需求
- 极易维护：采用独特的架构思想，只为长久维护设计
- 完整文档：提供完善的开发文档

## 🥞 架构设计

正在整理中...

## 🥝 功能模块

## 🥐 框架依赖

`Furion` 为了追求极速入门，极致性能，尽可能的不使用或减少第三方依赖。目前 `Furion` 仅集成了以下两个依赖：

- [MiniProfiler](https://github.com/MiniProfiler/dotnet)：性能分析和监听必备
- [Swashbuckle](https://github.com/domaindrivendev/Swashbuckle.AspNetCore)：`Swagger` 接口文档

麻雀虽小五脏俱全。`Furion` 即使只集成了这两个依赖，但是主流的 `依赖注入/控制反转`，`AOP` 面向切面编程，`事件总线`，`数据验证`，`数据库操作` 等等一个都不少。

## 🥗 环境要求

- Visual Studio 2019 16.8 +
- .NET 5 SDK +
- .Net Standard 2.1 +

## 🥪 支持平台

- 运行环境
  - Windows
  - Linux
  - MacOS
  - Docker/K8S/K3S/Rancher
  - Xamarin/MAUI
- 数据库
  - SqlServer
  - Sqlite
  - Azure Cosmos
  - MySql
  - MariaDB
  - PostgreSQL
  - InMemoryDatabase
  - Oracle（**并未完全适配**）
  - Firebird
  - 达梦数据库
- 应用部署
  - Kestrel
  - Nginx
  - Jexus
  - IIS
  - Apache
  - PM2
  - Supervisor
  - 单文件
  - 容器（Docker/K8S/K3S/Rancher）

## 🍖 关于性能

`Furion` 目前采用 `Visual Studio 2019 16.8` 自带性能测试和 `JMeter` 进行测试，由于篇幅有限，只贴部分测试图，测试结果如下：

---

## 🍚 关于作者

一个拥有 12 年开发经验 `.NETer`。喜欢分享，喜欢新技术，在互联网多个技术领域皆有涉猎，[MIP(dotNET China Most Influential Professionals)](https://www.chinadot.net/) 专家，同时多次获得开源中国 Gitee 授予 GVP 证书。

## 🍤 项目成员

🎈 欢迎更多的开发者加入 `Furion` 大家庭。

## 🍝 他们都在用

- 百签科技（广东）有限公司
- 码为科技（广州）有限公司
- 夫上技术（阳江）有限公司
- 广州启顺国际货运代理有限公司
- 森丰供应链服务（广州）有限公司
- 中山赢友网络科技有限公司
- 中山模思软件科技有限公司
- 珠海市恒泰新软件有限责任公司
- 珠海思诺锐创软件有限公司
- 深圳市易胜科技有限公司
- 重庆虫儿飞科技有限公司
- 重庆林木森科技有限公司
- 深圳市品立方科技有限公司
- 上海奥达科股份有限公司
- 中山市泓升软件科技有限公司
- 唐山天权建筑科技有限公司
- 北京帝龙科技有限公司
- 深圳市希立网络有限公司
- 广州市飞帆计算机技术有限公司
- 泉州市润海信息科技有限公司
- 成都市彼岸里信息科技有限公司
- 福建省山水生活服务集团有限公司
- 安徽宝典网络科技有限公司

如果您的项目使用到 `Furion` 开发，可以告诉我们。

## 🍻 贡献代码

`Furion` 遵循 `Apache-2.0` 开源协议，欢迎大家提交 `PR` 或 `Issue`。

如果要为项目做出贡献，请查看贡献指南。

## 🍍 捐赠列表

注：排序按捐赠顺序书写

| 捐赠人昵称      | 捐赠金额（元）        | 附语                                         |
| --------------- | --------------------- | -------------------------------------------- |
| 🤴 爱吃油麦菜   | **100**               | 感谢您的开源项目！                           |
| 👳‍♂️ 麦壳饼       | **200**               | 感谢您的开源项目！                           |
| 👨 Sun          | **100**               | 感谢您的开源项目！                           |
| 👶 d617617      | **20**                | 感谢您的开源项目！                           |
| 👦 Diqiguoji008 | **16.66**             | 见贤思齐                                     |
| 👲 nodyang      | **100**               | 感谢您的开源项目！                           |
| 👳‍♀️ mictxd       | **100**               | 吹过的牛都实现。                             |
| 🧓 欧流全       | **10**                | 希望将来超越 Spring                          |
| 👨‍⚕️ lionkon      | **10**                | ...看了框架感觉拿来学习是很不错的...         |
| 😤 好人！       | **10**                | Nice 的小僧，我们的 dotnetchina 马上火起来了 |
| 😮 木木 Woody   | **10**                | 感谢您的开源项目！                           |
| 😚 Joker Hou    | **QQ 超级会员一个月** |                                              |
| 🤠 ccdfz        | **QQ 专属红包 199**   |                                              |
| 🌝 天夫李总     | **支付宝 6666**       | Furion 非常有意思，持续关注                  |
| 😝 六尘子       | **微信红包 199**      | 公司已经使用，小小敬意                       |
| 🤠 ccdfz        | **QQ 专属红包 200**   | 赞助一根内存条                               |
| 🤑 邓亮灯       | **28.88**             | 感谢您的开源项目！                           |
| 😬 天道酬勤     | **微信二维码 188**    | 小小心意                                     |
| 🥰 却月居士     | **QQ 专属红包 100**   | 恭喜发财                                     |
| 🤩 鲁旭         | **100**               | 感谢您的开源项目！                           |
| 😬 散客行       | **微信二维码 666**    | 终于找到一个不错的框架                       |
| 😌 本心         | **100**               | 项目功能很强大                               |
| 🙆‍♂️ 毕业生       | **100**               | 请你喝杯咖啡                                 |
| 🦹‍♀️ 猪鼻子       | **微信二维码 668**    | 好                                           |
| 🧟‍♂️ 明年·今日    | **200**               | 使用的框架里最爽的，最理想的！加油           |
| 👨‍🎓 过去的过去   | **50**                | 感谢您的开源项目！                           |
| 👨‍🔧 万里兮       | **100**               | 新公司的第一个项目从 Furion 开始             |
| 👴 Muphalem     | **20**                | 很热心很亲切的开发者，加油！                 |
| 💂‍♂️ 吃锅巴的码农 | **微信二维码 500**    | 就冲你的文档写得好！                         |
| 🤴 三重罗生门   | **微信红包 200**      | 下次烤鱼你请！                               |
| 🤵 李涛         | **10**                | 加油，我们看到了 dotnet 美好的明天 :)        |

非常感谢您们的支持，正是因为您们，中国开源才可以越走越远，`Furion` 越走越远。

## 🥔 QQ 交流群

**dotNET 中国 ①** 🥇（已满）

**dotNET 中国 ②**（空余）

## 🧆 友情链接

👉 **[Furion](https://gitee.com/monksoul/Furion)** 👉 **[SqlSugar](https://github.com/sunkaixuan/SqlSugar)** 👉 **[Layx](https://gitee.com/monksoul/LayX)** 👉 **[t-io](https://gitee.com/tywo45/t-io)** 👉 **[ThinkPHP](http://www.thinkphp.cn/)** 👉 **[Hutool](https://hutool.cn/)** 👉 **[BootstrapAdmin](https://gitee.com/LongbowEnterprise/BootstrapAdmin)** 👉 **[BootstrapBlazor](https://www.blazor.zone/)** 👉 **[IoTSharp](https://gitee.com/IoTSharp/IoTSharp)** 👉 **[Anno.Core](https://github.com/duyanming/Anno.Core)** 👉 **[WaterCloud](https://gitee.com/qian_wei_hong/WaterCloud)**

## 🍵 特别鸣谢

在这里特别感谢 QQ 网名：`蓝狐星` 为 `Furion` 提供演示云服务器。

devin.gong/Furion

简介

发行版

贡献者

近期动态

devin.gong/Furion .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

devin.gong/Furion