README.md 7.5 KB
Newer Older
Y
yadong.zhang 已提交
1
# DBlog简介
Y
yadong.zhang 已提交
2
DBlog是一款简洁美观、自适应的Java博客系统。使用springboot开发,前端使用Bootstrap。支持移动端自适应,配有完备的前台和后台管理功能。
Y
更新  
yadong.zhang 已提交
3 4 5 6 7

# 注:请使用该项目的朋友优先查阅下【[Wiki](https://gitee.com/yadong.zhang/DBlog/wikis)】

群中好多朋友,现在仍在问的问题大都写在【[Wiki](https://gitee.com/yadong.zhang/DBlog/wikis)】中了,希望各位朋友能自己翻阅下相关资料,高效提问,避免重复问题。谢谢

Y
yadong.zhang 已提交
8 9
**网站预览**    
 
智布道's avatar
智布道 已提交
10 11
[https://www.zhyd.me](https://www.zhyd.me)  

Y
yadong.zhang 已提交
12
**开源地址**   
智布道's avatar
智布道 已提交
13 14
1. [Gitee](https://gitee.com/yadong.zhang/DBlog)    
2. [Github](https://github.com/zhangyd-c/DBlog)    
Y
yadong.zhang 已提交
15

Y
yadong.zhang 已提交
16 17 18
## 写在前面的话
ps: 虽然我知道,大部分人都是来了**直接下载源代码**后就潇洒的离开,并且只有等到下次**突然想到**“我天~~我得去看看DBlog这烂项目更新新功能了吗”的时候才会重新来到这儿,即使你重新来过,我估计你也只有两个选择:    

Y
yadong.zhang 已提交
19
发现更新代码了 --> 下载源码后重复上面的步骤    
Y
yadong.zhang 已提交
20 21 22 23 24 25 26 27 28 29 30 31
发现没更新代码 --> 直接关闭浏览器

虽然我知道现实就是如此的残酷,但我还是要以我萤虫之力对各位到来的同仁发出一声诚挚的嘶吼:

**如果喜欢,请多多分享!!多多Star!!fork可以,但还是请star一下!!**


### 开发环境

| 工具    | 版本或描述                |
| ----- | -------------------- |
| OS    | Windows 7            |
Y
yadong.zhang 已提交
32
| JDK   | 1.8+                 |
Y
yadong.zhang 已提交
33 34
| IDE   | IntelliJ IDEA 2017.3 |
| Maven | 3.3.1                |
Y
yadong.zhang 已提交
35
| MySQL | 5.6.4                |
Y
yadong.zhang 已提交
36 37 38 39 40 41 42 43 44 45 46

### 模块划分

| 模块         | 释义                      |
| ---------- | ----------------------- |
| blog-core  | 核心业务类模块,提供基本的数据操作、工具处理等 |
| blog-admin | 后台管理模块                  |
| blog-web   | 前台模块                    |


### 技术栈
Y
yadong.zhang 已提交
47

48
- Springboot 2.0.1
Y
yadong.zhang 已提交
49 50 51 52 53
- Apache Shiro 1.2.2
- Logback
- Redis
- Lombok
- Websocket
Y
yadong.zhang 已提交
54
- MySQL、Mybatis、Mapper、Pagehelper
Y
yadong.zhang 已提交
55 56 57
- Freemarker
- Bootstrap 3.3.0
- wangEditor
Y
yadong.zhang 已提交
58
- jQuery 1.11.1、jQuery Lazyload 1.9.7、fancybox、iCheck
Y
yadong.zhang 已提交
59 60
- 阿里云OSS
- kaptcha
Y
yadong.zhang 已提交
61 62 63
- Qiniu
- ...

智布道's avatar
智布道 已提交
64 65 66 67 68 69 70 71 72 73
### 功能简介

- 支持wangEditor和Markdown两种富文本编辑器,可以自行选择
- 在线申请友情链接,无需站长手动配置,只需申请方添加完站长的连接后自行申请即可
- 支持将文件提交到百度站长收录平台,加快百度引擎的收录
- 自研评论系统
- 后台配备完善的权限管理
- 自带robots、sitemap等seo模板,实现自动生成robots和sitemap
- 系统配置支持快速配置。可通过后台手动修改诸如域名信息、SEO优化、赞赏码、七牛云以及更新维护通知等。

Y
yadong.zhang 已提交
74 75 76 77 78 79

### 使用方法

1. 使用IDE导入本项目
2. 新建数据库`CREATE DATABASE dblog;`
3. 导入数据库`docs/db/dblog.sql`
Y
yadong.zhang 已提交
80 81 82 83
4. 修改配置文件
   1. 数据库链接属性(在`resources/application-{env}.yml`配置文件中搜索`datasource`或定位到L.7) 
   2. redis配置(在`resources/application.yml`配置文件中搜索`redis`或定位到L.65)
   3. mail配置(在`resources/application-{env}.yml`配置文件中搜索`mail`或定位到L.14)
84 85
   4.[七牛云](http://qiniu.com)】配置(见sys_config表中qiniu_*开头的字段)    
   注:因为系统存在redis缓存,如果是第一次使用,可以直接修改sys_config表内容,如果不是第一次用,建议使用admin项目中的`系统配置`页面修改相关配置内容
Y
yadong.zhang 已提交
86
5. 运行项目(三种方式)
智布道's avatar
智布道 已提交
87
   1. 项目根目录下执行`mvn -X clean package -Dmaven.test.skip=true -Ptest`编译打包(注:-Ptest中的test为环境标识),然后cd到blog-web目录下执行`java -jar target/blog-web.jar`
Y
yadong.zhang 已提交
88 89 90 91
   2. 项目根目录下执行`mvn springboot:run`
   3. 直接运行`BlogWebApplication.java`
6. 浏览器访问`http://127.0.0.1:8443`

92

Y
yadong.zhang 已提交
93
**后台用户**
Y
yadong.zhang 已提交
94

Y
yadong.zhang 已提交
95
_超级管理员_: 账号:root  密码:123456  (本地测试使用这个账号,admin没设置权限)
Y
yadong.zhang 已提交
96

Y
yadong.zhang 已提交
97
_普通管理员_: 账号:admin  密码:123456
Y
yadong.zhang 已提交
98

99 100 101 102
_评论审核管理员_: 账号:comment-admin  密码:123456

注:后台用户的创建,尽可能做到**权限最小化**

Y
yadong.zhang 已提交
103
更多详情,请参考【[Wiki](https://gitee.com/yadong.zhang/DBlog/wikis)
104

Y
yadong.zhang 已提交
105
### 更新日志
106 107 108 109
2018-06-20

**修改功能:**

Z
zmingchun 已提交
110 111
优化:  
    升级Spring Boot至2.0.1版本及其他关联版本升级;  
112
    使用Maven Profile管理Spring Boot Profiles,支持动态切换profile;
Y
yadong.zhang 已提交
113

Y
yadong.zhang 已提交
114 115 116 117 118 119 120 121 122 123
2018-06-10

**修改功能:**

新增:    
	markdown版的编辑器、评论框    
	控制文章的评论框是否显示    
	修改密码功能    
优化:相关页面进行优化    

Y
yadong.zhang 已提交
124 125 126 127 128 129 130 131 132 133 134 135
2018-06-05

**修改功能:**

修复: admin用户首页报错的问题    

优化:
1. ROOT用户默认拥有所有权限
2. admin页面改为macro引用的方式
3. 登录界面
4. 日志记录

136 137 138 139 140 141 142 143 144
2018-05-25

**修改功能:**

1. 修复后台标签等分页失败的问题
2. 修复前台自动申请友链失败的问题
3. 其他一些问题


145 146 147 148 149 150 151
2018-05-22

**修改功能:**

1. 完善shiro权限(数据库、页面)。注:需要重新执行下`sys_resources``sys_role_resources`两张表的`insert`语句
2. redis配置默认不含密码(鉴于大多数朋友的redis都没有密码做此修改,不过本人 **强烈建议**设置下密码)

Y
yadong.zhang 已提交
152 153 154 155 156 157 158 159 160 161 162 163 164 165 166
2018-05-18

**修复bug:**

1. web端自动申请友链后不显示的问题
2. config表修改后不能实时刷新的问题
	
**增加功能:**
1. 网站赞赏码
2. 百度推送功能(链接提交到百度站长平台)
	
**修改功能:**
1. 百度api的ak和百度推送的token以及七牛云的配置改为通过config表管理
3. admin模块菜单通过标签实时获取
3. 弹窗工具类js结构调整
Y
yadong.zhang 已提交
167

168
你能看到这儿已经很不容易了,剩下的自己先摸索摸索吧,实在不行,加QQ群[190886500](http://shang.qq.com/wpa/qunwpa?idkey=9f986e9b33b1de953e1ef9a96cdeec990affd0ac7855e00ff103514de2027b60),进群可以选择性的备注:~~欧巴群主我爱你~~(咳咳,鉴于部分群友的抗议,该备注就不用了),麻烦大家换成:`我猜群主一定很帅`
Y
yadong.zhang 已提交
169 170 171 172

### 图片预览

**前台页面**
智布道's avatar
智布道 已提交
173 174 175
![PC-首页](https://gitee.com/yadong.zhang/DBlog/raw/master/docs/img/pc-index.png?v=1.0)
![PC-文章详情页](https://gitee.com/yadong.zhang/DBlog/raw/master/docs/img/pc-detail.png?v=1.0)
![手机](https://gitee.com/yadong.zhang/DBlog/raw/master/docs/img/m.png?v=1.0)
Y
yadong.zhang 已提交
176
**后台页面**
智布道's avatar
智布道 已提交
177 178 179 180 181 182 183
![首页](https://gitee.com/yadong.zhang/DBlog/raw/master/docs/img/admin-index.png?v=1.0)
![菜单](https://gitee.com/yadong.zhang/DBlog/raw/master/docs/img/admin-menu.png?v=1.0)
![文章列表](https://gitee.com/yadong.zhang/DBlog/raw/master/docs/img/admin-articles.png?v=1.0)
![发表文章](https://gitee.com/yadong.zhang/DBlog/raw/master/docs/img/admin-article2.png?v=1.0)
![markdown版的编辑器](https://gitee.com/uploads/images/2018/0610/145228_06541ada_784199.png?v=1.0 "markdown版的编辑器")
![角色列表](https://gitee.com/yadong.zhang/DBlog/raw/master/docs/img/admin-role.png?v=1.0)
![角色分配](https://gitee.com/yadong.zhang/DBlog/raw/master/docs/img/admin-role2.png?v=1.0)
Y
yadong.zhang 已提交
184 185 186 187 188 189 190 191 192 193 194 195 196 197


 ### 生命不息,折腾不止! 更多信息,请关注:
 1. [我的博客](https://www.zhyd.me)
 2. [我的微博](http://weibo.com/211230415)
 3. [我的头条号](http://www.toutiao.com/c/user/3286958681/)
 4. [我的mooc](http://www.imooc.com/u/1175248/articles)

 ### 有任何问题可以
- [给我留言](https://www.zhyd.me/guestbook)


### 开源协议

智布道's avatar
智布道 已提交
198
 [MIT](https://gitee.com/yadong.zhang/DBlog/blob/master/LICENSE)