mirror of
https://github.com/anjoy8/Blog.Core.git
synced 2024-09-20 23:48:27 +08:00
245 lines
12 KiB
Markdown
245 lines
12 KiB
Markdown
<img align="right" height="50px" src="http://apk.neters.club/logocore.png">
|
||
|
||
# Blog.Core
|
||
|
||
[English](README-en.md) | 简体中文
|
||
|
||
[](#) [](https://github.com/anjoy8/Blog.Core/actions) [](https://dev.azure.com/laozhangisphi/anjoy8/_build?definitionId=1) [](https://codecov.io/gh/anjoy8/Blog.Core) [](https://github.com/anjoy8/Blog.Core/blob/master/LICENSE) [](https://github.com/boennemann/badges) [](https://github.com/boennemann/badges/fork) [](https://www.cnblogs.com/laozhang-is-phi/)
|
||
|
||
|
||
|
||
|
||
|
||
|
||
<div style="text-align: center;">
|
||
<a href="https://mvp.microsoft.com/zh-cn/PublicProfile/5003704?fullName=anson%20zhang" >
|
||
<img src="http://apk.neters.club/MVP_Logo_Horizontal_Preferred_Cyan300_CMYK_72ppi.png" alt="MVP" >
|
||
</a>
|
||
|
||
|
||
</div>
|
||
|
||
|
||
Blog.Core 开箱即用的企业级前后端分离【 .NET Core6.0 Api + Vue 2.x + RBAC】权限框架。
|
||
其他版本看具体分支吧🎉
|
||
官网：http://apk.neters.club/.doc/
|
||
|
||
|
||
|
||
**已被多家公司所使用(80+🐱🚀)：[点击查看列表](https://github.com/anjoy8/Blog.Core/issues/75)**
|
||
|
||
项目单体部署，并发在400~500，一切正常(不保证自己的各种错误写法)。
|
||
如果搭配负载，效果更好。
|
||
|
||
#### ❤ 真实用户反馈 ❤
|
||
```
|
||
1、A~CoderDong:
|
||
应用场景：使用Blog.Core为基础骨架开发，搭建Client监控类守护进程项目，To C 客户群，
|
||
并发情况：目前压测并发5k正常8秒处理完，并发10k可15秒处理完毕，异常不会丢失。
|
||
生产配置：一台服务器（Linux环境 + 至强8核的16G内存 + mysql数据库 + 3台Nginx负载）
|
||
|
||
```
|
||
|
||
|
||
|
||
|
||
|
||
#### Dokcer 快速启动
|
||
如果想在服务器或者本地快速查看接口效果，直接Docker启动容器即可：
|
||
```
|
||
# 可以挂载配置文件和日志文件
|
||
# 这里只是接口效果，想看前端效果，可以异步Blog.Admin查看后台管理系统
|
||
docker run --name=apkcontainer -d \
|
||
-v /data/appsettings.json:/app/appsettings.json \
|
||
-v /data/Log/:/app/Log \
|
||
-it -p 9291:9291 laozhangisphi/apkimg
|
||
```
|
||
|
||
|
||
### 功能与进度
|
||
|
||
框架模块：
|
||
- [x] 采用`仓储+服务+接口`的形式封装框架；
|
||
- [x] 异步 async/await 开发；
|
||
- [x] 接入国产数据库ORM组件 —— SqlSugar，封装数据库操作；
|
||
- [x] 支持自由切换多种数据库，MySql/SqlServer/Sqlite/Oracle/Postgresql/达梦/人大金仓；
|
||
- [x] 实现项目启动，自动生成种子数据 ✨；
|
||
- [x] 五种日志记录，审计/异常/请求响应/服务操作/Sql记录等；
|
||
- [x] 支持项目事务处理（若要分布式，用cap即可）✨；
|
||
- [x] 设计4种 AOP 切面编程，功能涵盖：日志、缓存、审计、事务 ✨；
|
||
- [x] 支持 T4 代码模板，自动生成每层代码；
|
||
- [x] 或使用 DbFirst 一键创建自己项目的四层文件（支持多库）；
|
||
- [x] 封装`Blog.Core.Webapi.Template`项目模板，一键重建自己的项目 ✨；
|
||
- [x] 搭配多个前端案例供参考和借鉴：Blog.Vue、Blog.Admin、Nuxt.tbug、Blog.Mvp.Blazor ✨；
|
||
- [x] 统一集成 IdentityServer4 认证 ✨;
|
||
|
||
组件模块：
|
||
- [x] 提供 Redis 做缓存处理；
|
||
- [x] 使用 Swagger 做api文档；
|
||
- [x] 使用 MiniProfiler 做接口性能分析 ✨；
|
||
- [x] 使用 Automapper 处理对象映射；
|
||
- [x] 使用 AutoFac 做依赖注入容器，并提供批量服务注入 ✨；
|
||
- [x] 支持 CORS 跨域；
|
||
- [x] 封装 JWT 自定义策略授权；
|
||
- [x] 使用 Log4Net 日志框架，集成原生 ILogger 接口做日志记录；
|
||
- [x] 使用 SignalR 双工通讯 ✨；
|
||
- [x] 添加 IpRateLimiting 做 API 限流处理;
|
||
- [x] 使用 Quartz.net 做任务调度（目前单机多任务，集群调度暂不支持）;
|
||
- [x] 支持 数据库`读写分离`和多库操作 ✨;
|
||
- [x] 新增 Redis 消息队列 ✨;
|
||
- [x] 新增 RabbitMQ 消息队列 ✨;
|
||
- [x] 新增 EventBus 事件总线 ✨;
|
||
- [x] 新增 - 统一聚合支付;
|
||
- [x] 新增 - Nacos注册中心配置;
|
||
- [x] 新增 - ES 搜索配置;
|
||
- [x] 新增 - Apollo 配置;
|
||
- [x] 新增 Kafka 消息队列，并配合实现EventBus ✨;
|
||
- [x] 新增 微信公众号管理，并集成到Blog.Admin后台 ✨;
|
||
- [ ] 计划 - 数据部门权限;
|
||
|
||
微服务模块：
|
||
- [x] 可配合 Docker 实现容器化；
|
||
- [x] 可配合 Jenkins 实现CI / CD；
|
||
- [x] 可配合 Consul 实现服务发现；
|
||
- [x] 可配合 Nacos 实现服务发现；
|
||
- [x] 可配合 Ocelot 实现网关处理；
|
||
- [x] 可配合 Nginx 实现负载均衡；
|
||
- [x] 可配合 Ids4 实现认证中心；
|
||
|
||
|
||
|
||
|
||
## 给个星星! ⭐️
|
||
如果你喜欢这个项目或者它帮助你, 请给 Star~
|
||
如果你的项目中借鉴了本项目，请稍微说明下[https://github.com/anjoy8/Blog.Core/issues/75](https://github.com/anjoy8/Blog.Core/issues/75)，开源不易✨。
|
||
|
||
## 贡献者们
|
||
|
||
Thanks goes to these wonderful people ([✨](https://github.com/anjoy8/Blog.Core/graphs/contributors)):（排名暂时按提交顺序）
|
||
|
||
<!-- prettier-ignore-start -->
|
||
| [<img src="https://avatars3.githubusercontent.com/u/28941816?s=460&v=3" width="100px;"/><br /><sub> anjoy8</sub>](https://github.com/anjoy8) <br /> 💻📖 💡 | [<img src="https://avatars0.githubusercontent.com/u/36782822?s=460&v=3" width="100px;"/><br /><sub> hudingwen</sub>](https://github.com/hudingwen) <br /> 💻 👀 | [<img src="https://avatars0.githubusercontent.com/u/32299016?s=460&v=3" width="100px;"/><br /><sub>binyly </sub>](https://github.com/binyly) <br />💻 👀 📖 👍 | [<img src="https://avatars0.githubusercontent.com/u/48714336?s=460&v=3" width="100px;"/><br /><sub>wuare </sub>](https://github.com/wuare) <br /> 💻😀 | [<img src="https://avatars3.githubusercontent.com/u/54385223?s=460&v=3" width="100px;"/><br /><sub>skang0401 </sub>](https://github.com/skang0401) <br /> 📖| [<img src="https://avatars1.githubusercontent.com/u/24422140?s=460&v=3" width="100px;"/><br /><sub>Jamnine</sub>](https://github.com/Jamnine) <br />💻 🌍|
|
||
| :---: | :---: | :---: | :---: | :---: | :---: |
|
||
|[<img src="https://avatars1.githubusercontent.com/u/19725014?s=460&v=3" width="118px;"/><br /><sub>aion1998 </sub>](https://github.com/aion1998) <br />👍|[<img src="https://avatars1.githubusercontent.com/u/54570786?s=460&v=3" width="118px;"/><br /><sub>RLei123 </sub>](https://github.com/RLei123) <br />😄|[<img src="https://avatars1.githubusercontent.com/u/33676184?s=460&v=3" width="118px;"/><br /><sub>cluyun </sub>](https://github.com/cluyun) <br />🍬|[<img src="https://avatars3.githubusercontent.com/u/33139361?s=460&v=3" width="118px;"/><br /><sub>blue20171027 </sub>](https://github.com/blue20171027) <br />✈|[<img src="https://avatars0.githubusercontent.com/u/15273487?s=460&v=3" width="118px;"/><br /><sub>anewboyz </sub>](https://github.com/anewboyz) <br />💻|[<img src="https://avatars3.githubusercontent.com/u/16607609?s=460&v=3" width="118px;"/><br /><sub>jxd728 </sub>](https://github.com/jxd728) <br />🌍|
|
||
|[<img src="https://avatars0.githubusercontent.com/u/25163291?s=460&v=3" width="118px;"/><br /><sub>wmchuang </sub>](https://github.com/wmchuang) <br />🍟|[<img src="https://avatars2.githubusercontent.com/u/23184470?s=400&v=3" width="118px;"/><br /><sub>liuzhenyulive </sub>](https://github.com/liuzhenyulive) <br />💻|[<img src="https://avatars1.githubusercontent.com/u/34571008?s=400&v=3" width="118px;"/><br /><sub>JsonBy </sub>](https://github.com/JsonBy) <br />💻 💡 🤔|[<img src="https://avatars2.githubusercontent.com/u/34576675?s=400&v=3" width="118px;"/><br /><sub>hsxian </sub>](https://github.com/hsxian) <br />🎉|[<img src="https://avatars0.githubusercontent.com/u/58431215?s=400&v=4" width="118px;"/><br /><sub>cuno92 </sub>](https://github.com/cuno92) <br />📖|[<img src="https://avatars0.githubusercontent.com/u/22249987?s=400&v=3" width="118px;"/><br /><sub>317447880 </sub>](https://github.com/317447880) <br />💻|
|
||
|[<img src="https://avatars0.githubusercontent.com/u/55371978?s=400&v=3" width="118px;"/><br /><sub>Shuisen </sub>](https://github.com/Shuisen) <br />💻|[<img src="https://avatars0.githubusercontent.com/u/45479028?s=400&v=3" width="118px;"/><br /><sub>www5255977 </sub>](https://github.com/www5255977) <br />🌍|[<img src="https://avatars0.githubusercontent.com/u/49057777?s=400&v=3" width="118px;"/><br /><sub>867824092 </sub>](https://github.com/867824092) <br />🍳|
|
||
<!-- prettier-ignore-end -->
|
||
|
||
This project follows the [all-contributors](https://github.com/anjoy8/Blog.Core/graphs/contributors) specification.
|
||
Contributions of any kind are welcome!
|
||
|
||
|
||
|
||
## 官方文档 📕
|
||
|
||
还在陆续整理中，不过基本操作都在,包括如何新手入门，配置数据，连接DB等等
|
||
|
||
[官方文档](http://apk.neters.club/.doc/)
|
||
[公众号重要文章+视频地址](https://mvp.neters.club/)
|
||
|
||
|
||
|
||
|
||
|
||
|
||
### 系统架构图
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
### 系统压测结果报告
|
||
|
||
|
||
<div align=center><img width="500" src="http://apk.neters.club/JMeterTest.png" /></div>
|
||
|
||
本项目是 .netCore 后端部分，前端部分请看我的另三个Vue工程项目
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|个人博客Vue版本|tBug项目Nuxt版本|VueAdmin权限管理后台|
|
||
|-|-|-|
|
||
|[https://github.com/anjoy8/Blog.Vue](https://github.com/anjoy8/Blog.Vue)|[https://github.com/anjoy8/Nuxt.tBug](https://github.com/anjoy8/Nuxt.tBug)|[https://github.com/anjoy8/Blog.Admin](https://github.com/anjoy8/Blog.Admin)|
|
||
|[http://vueblog.neters.club](http://vueblog.neters.club)|[http://tibug.neters.club](http://tibug.neters.club)|[http://vueadmin.neters.club](http://vueadmin.neters.club)|
|
||
|
||
|
||
|
||
|
||
|
||
### 初始化项目
|
||
|
||
|
||
下载项目后，编译如果没问题，直接运行即可，会自动生成种子数据，数据库是`Sqlite`，接口文档是`swagger`。
|
||
|
||
更多操作，点击这里：http://apk.neters.club/.doc/guide/getting-started.html
|
||
|
||
|
||
|
||
|
||
## Nuget Packages
|
||
|
||
| Package | NuGet Stable | Downloads |
|
||
| ------- | -------- | ------- |
|
||
| [Blog.Core.Webapi.Template](https://www.nuget.org/packages/Blog.Core.Webapi.Template/) | [](https://www.nuget.org/packages/Blog.Core.Webapi.Template/) | [](https://www.nuget.org/packages/Blog.Core.Webapi.Template/) |
|
||
|
||
|
||
关于如何使用，点击这里：https://www.cnblogs.com/laozhang-is-phi/p/10205495.html
|
||
|
||
|
||
|
||
|
||
## 其他后端框架
|
||
目前一共开源四个框架项目，感兴趣的可以看看
|
||
|
||
|单层项目|简单仓储框架|仓储+服务+接口|DDD框架|
|
||
|-|-|-|-|
|
||
|CURD+Seed|CURD+Seed+DI|CURD+Seed+DI+AOP等|DDD+EFCore+DI+EventBus等|
|
||
|[NetCore-Sugar-Demo](https://github.com/anjoy8/NetCore-Sugar-Demo)|[Blog.SplRepository.Demo](https://github.com/anjoy8/Blog.SplRepository.Demo)|[Blog.Core](https://github.com/anjoy8/Blog.Core)|[ChristDDD](https://github.com/anjoy8/ChristDDD)|
|
||
| -|[Blog-EFCore-Sqlite](https://github.com/anjoy8/Blog-EFCore-Sqlite)|- | -|
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
## 售后服务与支持
|
||
|
||
鼓励作者，简单打赏，入微信群，随时随地解答我框架中（NetCore、Vue、DDD、IdentityServer4等）的疑难杂症。
|
||
注意主要是帮忙解决bug和思路，不会远程授课，但是可以适当发我代码，我帮忙调试，
|
||
打赏的时候，备注自己的微信号，我拉你进群，两天内没回应，QQ私聊我（3143422472）；
|
||
|
||
[赞赏列表](http://apk.neters.club/.doc/Contribution/)
|
||
|
||
|
||
<img src="http://apk.neters.club/laozhangisphigood.jpg" alt="赞赏码" width="300" >
|
||
[图片若加载不出来，点这里](http://apk.neters.club/laozhangisphigood.jpg)
|
||
|
||
|
||
|
||
*****************************************************
|
||
### 文章+视频+直播
|
||
|
||
博客园：https://www.cnblogs.com/laozhang-is-phi/
|
||
|
||
Bilibili：https://space.bilibili.com/387802716
|
||
|
||
直播间：https://live.bilibili.com/21507364
|
||
|
||
```
|
||
```
|
||
|
||
|
||
|
||
|
||
如果你感觉看着这整个项目比较费劲，我单抽出来了几个子Demo，方便学习，项目地址 ：[https://github.com/anjoy8/BlogArti](https://github.com/anjoy8/BlogArti)
|
||
|
||
|
||
|