myblog

swagger接口文档

初衷

该项目模仿《go 语言编程之旅》的博客后台，并修改和增加了部分功能。

还是想去红岩网校吧，真的好想。

技术选型

1. web:gin
2. orm:gorm
3. database:MySQL
4. 全文检索:wukong
5. 文件存储:七牛云存储smms图床
6. 配置文件 go-yaml

项目结构

-myBlog
    |-configs 配置文件目录
    |-docs 文档目录
    |-global 全局变量目录
    |-internal 内部模块目录
        |-dao 数据访问目录
        |-middleware HTTP中间件目录
        |-model 模型目录
        |-routers 路由相关逻辑目录
            |-api 接口目录
        |-service 项目核心业务逻辑目录
    |-pkg 项目相关模块包目录
        |-app 基本功能
        |-captcha 图片验证码
        |-convert 类型转换
        |-email 邮件
        |-errcode 错误码
        |-limiter 限流器
        |-logger 日志
        |-setting 配置
        |-tracer 链路追踪
        |-upload 上传文件
        |-util 其他
    |-scripts 各类构建、安装、分析等操作的脚本目录
    |-storage 项目生成的临时文件目录
        |-logs 项目日志目录
        |-uploads 项目上传的文件目录
    |-third_party 第三方资源工具目录
    |-vendor 项目依赖其他开源项目目录
    |-view 模板文件目录
    |-main.go 程序执行入口
    |-setup.go

TODO

• 文章、页面访问统计
• GitHub登录发表评论
• rss订阅
• 图形验证码
• 七牛云SMMS图床
• 邮箱提醒功能
• 链路追踪
• 统一超时、接口限流控制
• 系统日志
• 优雅重启和停止
• Markdown

安装部署

本项目使用govendor管理依赖包，govendor安装方法

go get -u github.com/kardianos/govendor

git clone https://github.com/flowerwedding/myblog
cd myblog
govendor sync
go run main.go

使用方法

使用说明

使用 /auth 接口登录，每次发送请求携带所生成的 token，或放在请求头中

注意事项

1. 如果需求上传图片功能请自行申请七牛云存储空间，并修改配置文件填写
   • qiniu_accesskey
   • qiniu_secretkey
   • qiniu_fileserver 七牛访问地址
   • qiniu_bucket 空间名称
2. 如果需要使用邮件功能，请自行填写
   • smtp_username
   • smtp_password
   • smtp_from
   • smtp_to

效果图