代码拉取完成，页面将自动刷新
2023-12-09：最近项目处于重构中，会经历快速迭代，线上版本不一定是最新，暂时不要上生产环境
2023-12-27: v2 版本重构 初步完成, 从之间的 Java 风格项目改为 Golang 风格, 还有些功能在修补!
项目交流 QQ 群号：777260310
在线预览 | 项目介绍 | 技术介绍 | 目录结构 | 环境介绍 | 快速开始 | 总结&鸣谢 | 后续计划
您的 Star 是我坚持的动力，感谢大家的支持，欢迎提交 Pr 共同改进项目。
Github 地址：https://github.com/szluyu99/gin-vue-blog
Gitee 地址：https://gitee.com/szluyu99/gin-vue-blog
博客前台链接：hahacode.cn（已适配移动端）
博客后台链接：hahacode.cn/admin（暂未专门适配移动端）
博客域名已通过备案，且配置 SSL，通过 https 访问
测试账号：test@qq.com，密码：11111，前后台都可用这个账号登录
在线接口文档地址：doc.hahacode.cn，准备换成 Swagger
以下放几张简单的预览图，强烈建议点击上面的预览链接进去体验下：
Linux/Mac 可直接运行，Windows 要使用 GitBash 运行（默认终端不能执行 shell）
git clone https://github.com/szluyu99/gin-vue-blog
cd gin-vue-blog/deploy
./bootstrap.sh
Github 上有很多优秀的前后台框架，本项目也参考了许多开源项目，但是大多项目都比较重量级（并非坏处），如果从学习的角度来看对初学者并不是很友好。本项目在以博客这个业务为主的前提下，提供一个完整的全栈项目代码（前台前端 + 后台前端 + 后端），技术点基本都是最新 + 最火的技术，代码轻量级，注释完善，适合学习。
同时，本项目可用于一键搭建动态博客（参考 快速开始）。
前台：
后台：
其他：
这里写一些主流的通用技术，详细第三方库：前端参考
package.json文件，后端参考go.mod文件
前端技术栈: 使用 pnpm 包管理工具
后端技术栈:
其他:
这里简单列出目录结构，具体可以查看源码
代码仓库目录：
gin-vue-blog
├── gin-blog-admin -- 博客后台前端
├── gin-blog-front -- 博客前台前端
├── gin-blog-server -- 博客后端
├── deploy -- 部署
项目运行参考：快速开始
后端目录：简略版
gin-blog-server
├── api -- API
│ ├── front -- 前台接口
│ └── v1 -- 后台接口
├── dao -- 数据库操作模块
├── service -- 服务模块
├── model -- 数据模型
│ ├── req -- 请求 VO 模型
│ ├── resp -- 响应 VO 模型
│ ├── dto -- 内部传输 DTO 模型
│ └── ... -- 数据库模型对象 PO 模型
├── routes -- 路由模块
│ └── middleware -- 路由中间件
├── utils -- 工具模块
│ ├── r -- 响应封装
│ ├── upload -- 文件上传
│ └── ...
├── routes -- 路由模块
├── config -- 配置文件
├── test -- 测试模块
├── assets -- 资源文件
├── log -- 存放日志的目录
├── public -- 外部访问的静态资源
│ └── uploaded -- 本地文件上传目录
├── Dockerfile
└── main.go
前端目录：简略版
gin-vue-admin / gin-vue-front 通用目录结构
├── src
│ ├── api -- 接口
│ ├── assets -- 静态资源
│ ├── styles -- 样式
│ ├── components -- 组件
│ ├── composables -- 组合式函数
│ ├── router -- 路由
│ ├── store -- 状态管理
│ ├── utils -- 工具方法
│ ├── views -- 页面
│ ├── App.vue
│ └── main.ts
├── settings -- 项目配置
├── build -- 构建相关的配置
├── public -- 公共资源, 在打包后会被加到 dist 根目录
├── package.json
├── package-lock.json
├── index.html
├── tsconfig.json
├── unocss.config.ts -- unocss 配置
└── vite.config.ts -- vite 配置
├── .env -- 通用环境变量
├── .env.development -- 开发环境变量
├── .env.production -- 线上环境变量
├── .gitignore
├── .editorconfig -- 编辑器配置
部署目录：简略版
deploy
├── build -- 镜像构建
│ ├── mysql -- mysql 镜像构建
│ ├── server -- 后端镜像构建 (基于 gin-blog-server 目录)
│ └── web -- 前端镜像构建 (基于前端项目打包的静态资源)
└── start
├── docker-compose.yml -- 多容器管理
└── .env -- 环境变量
└── ...
服务器：腾讯云 2核 4G Ubuntu 22.04 LTS
对象存储：七牛云
| 开发工具 | 说明 |
|---|---|
| Vscode | Golang 后端 + Vue 前端 |
| Navicat | MySQL 远程连接工具 |
| Another Redis Desktop Manager | Redis 远程连接工具 |
| MobaXterm | Linux 远程工具 |
| Apifox | 接口调试 + 文档生成 |
| 开发环境 | 版本 |
|---|---|
| Golang | 1.19 |
| MySQL | 8.x |
| Redis | 7.x |
目前推荐安装插件已经写到 .vscode/extensions.json 中，使用 VsCode 打开项目会推荐安装。
注意，使用 VsCode 打开 gin-blog-admin 和 gin-blog-front 这两个项目，而不是打开 gin-vue-blog 这个目录！
建议下载本项目后，先一键运行起来，查看本项目在本地的运行效果。
需要修改源码的话，参考常规运行，前后端分开运行。
本项目开发环境是 Linux，如果 Windows 下运行有奇奇怪怪的问题，可以进群交流或提 Issue
如果是 Windows 系统，需要先执行以下指令，否则 Docker 构建过程可能会出 BUG。
或者直接下载 ZIP 而不是通过 git clone 克隆项目。
Linux 和 Mac 不需要进行该操作。
原因是该项目开发时基于 Linux，本项目规范使用 lf 换行符。而 Windows 的 git 在自动拉取项目时会将项目文件中换行符转换为 crlf，经过测试，构建过程会产生 BUG。
# 防止 git 自动将换行符转换为 crlf
git config --global core.autocrlf false
需要有 Docker 和 Docker Compose 的环境
详细运行文档（包含环境搭建）参考：deploy/README.md
Linux 下可以正常启动：（Windows 请使用 GitBash 进行操作）
git clone https://github.com/szluyu99/gin-vue-blog
cd gin-vue-blog/deploy
./bootstrap.sh
本地前台访问 localhost
本地后台访问 localhost/admin
默认用户：
如果运行遇到问题，请查看详细文章 deploy/README.md
需要安装 Golang、Node、MySQL、Redis 环境：
以下使用 Docker 安装环境，未做持久化处理，仅用于开发和演示
Docker 安装 MySQL：
# 注意: 必须安装 MySQL 8.0 以上版本
docker pull mysql:8.0
# 运行 MySQL
docker run --name mysql8 -e MYSQL_ROOT_PASSWORD=123456 -p 3306:3306 -d mysql:8.0
# 查看是否运行成功, STATUS 为 Up 即成功
docker ps
# 进入容器, CTRL + D 退出
docker exec -it mysql8 bash
mysql -u root -p123456
Docker 安装 Redis：
docker pull redis:7.0
# 运行 Redis
docker run --name redis7 -p 6379:6379 -d redis:7.0
# 查看是否运行成功, STATUS 为 Up 即成功
docker ps
# 进入容器, CTRL + D 退出
docker exec -it redis7 bash
redis-cli
需要先运行后端服务，再运行前端项目，因为很多前端配置由后端动态加载（如菜单等）。
拉取项目到本地：
git clone https://github.com/szluyu99/gin-vue-blog.git
后端项目运行：
# 1、进入后端项目根目录
cd gin-blog-server
# 2、修改项目运行的配置文件，默认加载位于 config/config.toml
# 3、MySQL 导入 gvb.sql
# 4、启动 Redis
# 5、运行项目
go mod tidy
go run main.go
数据库中的默认用户：
前端项目运行： 本项目使用 pnpm 进行包管理，建议全局安装 pnpm
npm install -g pnpm
前台前端：
# 1、进入前台前端项目根目录
cd gin-blog-front
# 2、安装依赖
pnpm install
# 3、运行项目
pnpm dev
后台前端：
# 1、进入后台前端项目根目录
cd gin-blog-admin
# 2、安装依赖
pnpm install
# 3、运行项目
pnpm dev
TODO
这个项目不管是前端，还是后端，都是花了比较大心血去架构的，并且从技术选型上，都是选择了目前最火 + 最新的技术栈。当然，这也是个人的学习之作，很多知识点都是边学边开发的（例如 Casbin），这个过程中也参考了很多优秀的开源项目，感谢大家的开源让程序员的世界更加美好，这也是开源本项目的目的之一。本项目中仍有很多不足，后续会继续更新。
最后，项目整体代码风格很优秀，注释完善，适合 Golang 后端开发者、前端开发者学习。
鸣谢项目：
⭐ 博客后台的前端基于 vue-naive-admin 进行二开，感谢作者的开源。但是和原项目区别较大，详见 gin-blog-admin/README.md
需要感谢的绝不止以上这些开源项目，但是一时难以全部列出，后面会慢慢补上。
高优先级:
后续有空安排上：
其他：
此处可能存在不合适展示的内容，页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容，可点击提交进行申诉，我们将尽快为您处理。