# kyu-blog

**Repository Path**: yhy-yu/kyu-blog

## Basic Information

- **Project Name**: kyu-blog
- **Description**: K鱼博客平台，基于最新的Vue3+StringBoot创建，提供博客、在线游戏、音乐、聊天室等功能，简约而不简单，唯美设计
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: https://blog.kyu-verse.site/
- **GVP Project**: No

## Statistics

- **Stars**: 6
- **Forks**: 2
- **Created**: 2024-12-14
- **Last Updated**: 2025-08-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Java, Vue, 聊天室, 博客, SpringBoot

## README

## 博客介绍

<p align=center>
  <a href="https://blog.kyu-verse.site/">
    <img src="https://img.kyu-verse.site/kyublog/img/kyu-marker.png" alt="K鱼博客" style="border-radius: 20%;width: auto; height: auto; max-width: 13%; max-height: 20%">
  </a>
</p>

<p align="center">
   <a target="_blank" href="https://gitee.com/yhy-yu/kyu-blog">
      <img src="https://img.kyu-verse.site/kyublog/svg//agreement.svg"/>
      <img src="https://img.kyu-verse.site/kyublog/svg//JDK-1.8%2B-green.svg"/>
      <img src="https://img.kyu-verse.site/kyublog/svg//springboot-2.4.1.RELEASE-green.svg"/>
      <img src="https://img.kyu-verse.site/kyublog/svg//vue-3.4.21-green.svg"/>
      <img src="https://img.kyu-verse.site/kyublog/svg//mysql-8.0.24-green.svg"/>
      <img src="https://img.kyu-verse.site/kyublog/svg//mybatis--plus-3.4.0-green.svg"/>
      <img src="https://img.kyu-verse.site/kyublog/svg//redis-7.2.4-green.svg"/>
      <img src="https://img.kyu-verse.site/kyublog/svg//elasticsearch-7.9.2-green.svg"/>
   </a>
</p>

> 这是一个博客项目，简介易上手的设计初衷，兼容功能性，如果您觉得还不错，请在下载源码前点一下页面右上角的**Star**，这会让我更有动力来完善这个项目，致谢~

[在线地址](#在线地址) | [目录结构](#目录结构) | [项目特点](#项目特点) | [运行和部署](#运行和部署) | [技术介绍](#技术介绍) | [运行环境](#运行环境)

<img src="https://img.kyu-verse.site/kyublog/web/kyu-blog-img.png" alt="K鱼博客" style="width: auto; height: auto;">

## 在线地址

**项目链接：[K鱼博客](https://blog.kyu-verse.site/)**

## 站点演示地址，
**后台链接：[K鱼博客后台管理系统](https://admin.kyu-verse.site/)**

演示账号:kyu 密码:123456

**Gitee地址：** [https://gitee.com/yhy-yu/kyu-blog](https://gitee.com/yhy-yu/kyu-blog)

您对本项目的Star是我坚持的动力，感谢大家的支持，欢迎提交pr共同改进项目。

## 目录结构

前端项目blog-web为前台，blog-admin为后台。

后端项目位于blog下。

```
blog
├── kyu-admin         --  后台管理系统的controller模块
├── kyu-common        --  通用模块
├── kyu-generate      --  代码生成模块
├── kyu-quartz        --  定时任务模块
├── kyu-server        --  博客启动类模块
├── kyu-web           --  门户接口模块

```
## 项目特点

- 前后端分离部署，适应当前潮流。
- 管理端参考"vue-element-template"设计，侧边栏，历史标签，面包屑自动生成。
- 后台管理支持修改背景图片，博客配置等信息，操作简单，支持上传相册。
- 评论支持表情输入回复等
- 接入第三方登录，减少注册成本。
- 留言采用弹幕墙，更加炫酷。
- 支持代码高亮和复制，图片预览，深色模式等功能，提升用户体验。
- 搜索文章支持高亮分词，响应速度快。
- 新增文章目录、推荐文章等功能，优化用户体验。
- 新增aop注解实现日志管理
- 支持动态权限修改，采用RBAC模型，前端菜单和后台权限实时更新。
- 代码支持多种文件上传模式（七牛云oss或本地上传），可支持配置。：2024-08-10
- 代码支持多种搜索模式全文搜索（Elasticsearch或MYSQL），策略模式配置可扩展。
- 代码遵循阿里巴巴开发规范，利于开发者学习。
- 使用netty+websocket技术实现博客群聊和单聊功能：2024-10-05
- 加入避免防盗链设计，优化一键导入三方网站博文后静态资源不回显问题
- 新增用户博客发布：2024-12-22
- 博客页增加全局音乐播放功能，用户可搜索：2024-12-29

## 运行和部署

**SQL文件位于根目录下的 blog.sql**

**ps：请先运行后端项目，再启动前端项目，前端项目配置由后端动态加载。**

可直接导入该项目于本地，修改后端配置文件中的数据库等连接信息，项目中使用到的关于邮箱、七牛云功能等第三方授权登录等需要自行开通。

当你克隆项目到本地后可使用账号：admin，密码：123456 进行登录

本地访问接口文档地址：http://127.0.0.1:8800/kyu/doc.html

| 标题                                                         | 部署链接                                    |
|------------------------------------------------------------|-----------------------------------------|
| **本地部署流程请[点击这里](https://blog.kyu-verse.site/article/283)** | https://blog.kyu-verse.site/article/283 |
| **服务器部署流程[点击这里](https://blog.kyu-verse.site/article/284)** | https://blog.kyu-verse.site/article/284 |


## 技术介绍

**前端：** vue3.0 +  pinia + vue-router + axios + element-plus + echarts

**后端：** SpringBoot + nginx + docker + sa-token + Swagger2 + MyBatisPlus + Mysql + Redis + elasticsearch 

**其他：** 接入QQ、微博、码云、微信公众号等第三方登录，接入七牛云对象存储

## 运行环境

**服务器：** 腾讯云2核4G CentOS7.6

**对象存储：** 七牛云OSS

**最低配置：** 1核2G服务器（关闭ElasticSearch）

## 开发环境

| 开发工具                          |           说明            |
|-------------------------------| ------------------------- |
| IDEA                          | Java开发工具IDE            |
| VSCode                        | Vue开发工具IDE             |
| Navicat                       | MySQL远程连接工具          |
| Another Redis Desktop Manager | Redis远程连接工具          |
| MobaXterm_Persona             | Linux远程连接和文件上传工具 |

|    开发环境    | 版本     |
| ------------- |--------|
| JDK           | 1.8    |
| MySQL         | 8.0.24 |
| Redis         | 7.2.4  |
| Elasticsearch | 7.9.2  |