项目简介
AzuLLia - Core是一个基于Go语言开发的博客内容管理接口项目,借助Gin框架与MongoDB数据库,为开发者快速搭建博客系统后端服务提供助力。该项目具备丰富的API接口和中间件功能,支持用户认证、权限管理、数据操作等核心功能,且能通过Docker和Docker Compose在不同环境轻松部署。
项目的主要特性和功能
- 丰富的API接口:涵盖文章管理、标签管理、分类管理、用户管理等多个API接口,支持增删改查操作。
- JWT用户认证:采用JSON Web Token (JWT) 进行用户认证和授权,保障系统安全。
- 中间件支持:内置权限检查和错误处理中间件,如用户登录验证和404错误处理。
- MongoDB数据库操作:支持对MongoDB数据库的CRUD操作,高效管理博客内容。
- Swagger文档支持:集成Swagger,自动生成API文档,便于开发者查阅和测试接口。
- Docker部署:支持通过Docker和Docker Compose快速部署,保证环境的一致性和可移植性。
安装使用步骤
1. 获取源码
使用git复制项目仓库源码:
shell
2. 环境配置
修改项目根目录下的Service.env
文件,配置数据库连接信息、服务器地址、端口等。示例配置如下:
```
WEBSITE_HOST=127.0.0.1
WEBSITE_PORT=:80
DB_HOST=127.0.0.1 DB_PORT=27017 DB_USER=root DB_PASSWD=12345678 DB_POOL_SIZE=10 DB_DATA_BASE=azullia
GIN_MODE=debug
JWT_KEY = key HASH_KEY = secret key ```
3. 选择部署方式
使用Docker部署
在项目根目录下执行以下命令构建Docker镜像:
shell
docker build -t azullia:latest .
运行容器:
shell
docker run -itd -p 8000:80 -p 27017:27017 --name azullia-service azullia:latest
使用Docker Compose部署
在项目根目录下执行以下命令启动服务:
shell
docker-compose -f ./docker-compose.yml -p azullia up -d
4. 检测服务是否正常启动
使用以下命令检测服务是否正常运行:
shell
curl --request GET --url 'http://127.0.0.1:8000/about'
若返回以下JSON,表明服务已成功启动:
json
{
"code": 0,
"msg": "success",
"path": "/about",
"data": {
"version": "x.x.x"
}
}
5. 访问API
通过浏览器或curl工具访问API接口,测试功能。Swagger文档可通过访问http://127.0.0.1:8000/swagger/index.html
查看。
下载地址
点击下载 【提取码: 4003】【解压密码: www.makuang.net】