中文 | English
通过学习 Deali-Axy 大佬的 StarBlog 而编写的 Vue.js + ASP .Net Core 博客项目
集成了前端博客页面与简易的后台管理
进行了一定的部署优化,确保提供开箱即用的体验,包括为所有用户提供了免费图床
- 前端:Vue.js 3 + ElementPlus + md-editor-v3
- 后端:.Net 8 + ASP .Net Core + FreeSQL + JWT身份验证 + PostgreSQL/SQLite
KeyBlog.Data:数据模型+初始化程序,运行该程序进行数据库初始化+markdown文章批量导入KeyBlog.Server:项目后端部分KeyBlog.client:Vue 前端网页部分
- 初始化时批量导入本地markdown文件,并自动根据文件夹构建层级分类
- 查看博客正文,提供目录用于跳转
- 博客正文显示页面增加更多信息,如更新时间等
- 博客正文页面底部实现评论系统
- 搜索博客 & 对博客进行排序
- 在线编辑功能(实现对普通用户和管理员的不同在线编辑:普通用户仅能下载到本地,管理员可自由选择远程发布或本地保存)
- 在线编辑时可上传图片或从剪贴板粘贴,之后,图片自动上传到图床并插入链接(对于普通用户,提供了免费图床的调用,设置在
OnlineEditor.vue;对于管理员用户,图床地址和token请在appsettings.json手动设置) - 在线编辑时的版本历史记录 & 自动保存
- 文章主题 & 代码主题变更 & 黑夜模式
- 更多自定义主题选项
- 壁纸轮换
- 管理系统,实现对博客的增删改查,覆盖大多数场景
- 在管理系统内上传本地文件夹或文件
- 访问统计
本项目基于 .Net8 开发,构建之前请确保已经安装 .Net8 SDK。
git clone https://github.com/Arcticn/KeyBlog.git
cd .\KeyBlog\
dotnet publish "KeyBlog.Server" --configuration Release --output "KeyBlog.Server\publish"
dotnet publish操作会自动执行npm run build并将生成的静态文件存放到publish文件夹
如果选择使用SQLite,在dotnet publish完成后,将代码随附的初始化后的SQlite数据库app.db复制进入KeyBlog.Server\publish文件夹下
进入publish文件夹,启动KeyBlog.Server.exe,默认监听在localhost:5179上
如果需要初始时批量导入markdown或者更换数据库,请先调整并运行KeyBlog.Data相关内容以进行初始化
如果您想要部署到Azure,建议使用Azure远程PostgreSQL数据库服务并更改相关代码
-
使用虚拟机服务(更灵活,但免费级别的机器不可靠)
直接部署publish文件夹。需要注意调整端口到80或443
-
使用AppService应用服务(F1层免费,且更方便)
可以使用
Github Action自动部署,无需调整端口,申请AppService可能花费较长时间(约几天)。- Action推送配置可以使用Visual Studio发布选项自动生成,建议跳过API管理部分