XBlog是dotnet core
平台下的个人博客开源系统,它只需要通过Copy的方式即可以部署到Linux和windows系统中;如果你有安全证书那只需要简单配置一下即可提供安全的Https
服务。接下来主要介绍XBlog功能、部署和基础设置。
技术要点
- 基于
dotnet core
平台,可以运行在windows和linux系统上 - 完全基于
BeetleX.FastHttpAp
框架开发 - 前后端分离,完全脱离后端视图引擎;基于vuejs和webapi模式
- 混合HTTP和Websocket,当浏览器兼容Websocket的情况下请求会使用Websocket.
- 基于javascript前端Markdown,降低文章在服务端解释的损耗
- 支持HTTPS满足安全访问的需求
- javascript async/await 对访问的浏览器要求比较高,旧版本浏览器可能无法查看
项目地址:https://github.com/IKende/XBlog
功能介绍
XBlog提供了博客的基础功能主要包括:文章管理,分类管理,评论管理,文件管理,系统资源监控和文章搜索功能.
首页预览
后台预览
设置
主要配置博客信息如Title
,ElasticSearch服务地址
,关于
,JWT KEY
和设置用户密码
等。
部署
XBlog部署非常简单,把编译好的文件复制运行即可。
下载编译好的文件包:
https://github.com/IKende/XBlog/blob/master/Publish/XBlog.zip
获取源代码:
https://github.com/IKende/XBlog自己编译
运行环境要求
提供.net core 2.1或更高版本的linux、windows系统。把编译好的代码复制到相关目录下运行以下命令:
dotnet BeetleX.Blog.dll
配置ElasticSearch
由于XBlog的数据分类检索都是使用ElasticSearch的功能,安装ElasticSearch可以查看以下文章,需要安装中文分词插件IK
https://www.ikende.com/blog/87.html
安装完成后只需要在系统管理后台设置一下即可,默认是指向http://localhost:9200
根据地址配置。
系统检测到ElasticSearch可用的情况,边框为绿色;如果检测错误会红色并有相关错误信息。检测成功后可以通过测试分词按钮来测试一下分词效果
安全配置
系统默认用户名admin
,密码123456
建议运行后修改密码,还有JWT Key
也得新创建一个新的,确保Key和其他运行环境不一致。
配置访问端口和Https
由于BeetleX.FastHttpAp
是支持https功能,所以只需要在HttpConif.json
设置三项内容即可
"Port": 8080, "SSL": true, "CertificateFile": "c:\\ikende.com.pfx", "CertificatePassword": "*****",
端口默认是8080
如果需要80需要自行修改,开启https
分别是开启SSL,设置证书文件和对应的密码(linux和windows设置方式一样)默认端口是443。
问题
如果使用或扩展中存在问题可以提交到 https://github.com/IKende/XBlog/issues