飞鹅博客系统初始化及二次开发（二）后端#

一、后端开发#

1.1 项目结构解析#

飞鹅博客系统后端基于Go语言和Iris框架开发，采用了清晰的分层架构设计。以下是项目的核心目录结构：

1
├── cmd/                      # 命令行入口
2
│   └── flygoose/             # 主程序入口
3
│       ├── flygoose-config.yaml  # 配置文件示例
4
│       └── main.go           # 程序启动文件
5
├── configs/                  # 配置相关
6
│   └── config.go             # 配置结构定义
7
├── datasource/               # 数据源连接
8
│   └── db.go                 # 数据库初始化
9
├── inits/                    # 应用初始化
10
│   ├── flygoose_init.go      # 应用初始化逻辑
11
│   └── middle.go             # 中间件配置
12
├── pkg/                      # 公共包
13
│   ├── beans/                # 数据传输对象
14
│   ├── models/               # 数据模型
15
│   ├── tlog/                 # 日志工具
16
│   └── tools/                # 通用工具
17
├── web/                      # Web相关
18
│   ├── controllers/          # 控制器
19
│   ├── daos/                 # 数据访问层
20
│   ├── middlers/             # 中间件
21
│   └── services/             # 业务逻辑层
22
└── docs/                     # 文档
23
    └── 接口文档.md           # API接口文档

1.2 核心配置文件说明#

1.2.1 主配置文件结构#

配置文件位于configs/config.go，定义了系统的核心配置结构：

1
// 全局配置文件实例
2
var Cfg *Config
3

4
type Config struct {
5
    Http         HttpCfg     `yaml:"http"`         // HTTP服务配置
6
    Database     DatabaseCfg `yaml:"database"`     // 数据库配置
7
    ExecuteDir   string                             // 可执行文件目录
8
    StaticDir    string                             // 静态文件目录
9
    StaticImgDir string                             // 图片静态目录
10
}
11

12
type HttpCfg struct {
13
    Port int `yaml:"port"`                         // 服务端口
14
}
15

16
type DatabaseCfg struct {
17
    Driver   DbDriverType `yaml:"driver"`          // 数据库类型(mysql或postgresql)
18
    Host     string       `yaml:"host"`            // 数据库IP
19
    Name     string       `yaml:"name"`            // 数据库名称
20
    Port     int          `yaml:"port"`            // 数据库端口
21
    User     string       `yaml:"user"`            // 用户名
22
    Password string       `yaml:"password"`        // 密码
23
}

1.2.2 配置文件示例#

1
# 服务端口
2
http:
3
  port: 29090
4
# 数据库配置
5
database:
6
  driver: mysql
7
  host: 127.0.0.1
8
  port: 3306
9
  name: db_flygoose
10
  user: flygoose
11
  password: flygoose

1.3 应用初始化流程#

应用初始化主要在inits/flygoose_init.go中实现，包含以下核心步骤：

1.3.1 创建应用实例#

1
func NewFlygooseApp(cfg *configs.Config) *FlygooseApp {
2
    app := new(FlygooseApp)
3
    app.Cfg = cfg
4
    app.Engine = iris.New()
5
    // 配置CORS中间件
6
    app.Engine.UseRouter(cors.New().Handler())
7
    return app
8
}

1.3.2 启动应用#

1
func (m *FlygooseApp) Start() {
2
    m.InitDir()       // 初始化目录
3
    m.initLog()       // 初始化日志
4
    m.initDB()        // 初始化数据库
5
    m.initRouter()    // 初始化路由
6
    m.run()           // 启动服务
7
}

1.3.3 数据库初始化与自动迁移#

1
func (m *FlygooseApp) initDB() {
2
    // 初始化数据库连接
3
    if m.Cfg.Database.Driver == configs.DbDriverMySQL {
4
        datasource.InitMySql(cfg)
5
    } else if m.Cfg.Database.Driver == configs.DbDriverPostgreSQL {
6
        datasource.InitPostgreSQL(cfg)
7
    } else {
8
        panic(errors.New("暂不支持其它数据库"))
9
    }
10

11
    // 自动迁移数据模型
12
    m.initAutoMigrate()
13

14
    // 初始化默认管理员账户
15
    m.initDefaultAdmin()
16
}

1.3.4 路由配置#

1
func (m *FlygooseApp) initRouter() {
2
    v1 := m.Engine.Party(configs.Flygoose_Url_Prefix)  // API前缀
3
    {
4
        // 前端接口
5
        mvc.New(v1.Party("/site")).Handle(flygoose.NewSiteController())
6
        mvc.New(v1.Party("/blog")).Handle(flygoose.NewBlogController())
7
        mvc.New(v1.Party("/special")).Handle(flygoose.NewSpecialController())
8
        mvc.New(v1.Party("/ai")).Handle(ai.NewDeepSeekController()) // AI相关接口（注：此为个人修改版本新增功能，详情请参考 https://github.com/AI-FIRE/）
9

10
        // 管理端接口
11
        mvc.New(v1.Party("/health")).Handle(admin.NewHealthController())                 //健康检查
12
        mvc.New(v1.Party("/admin/access")).Handle(admin.NewAccessController())           //访问相关接口
13
        mvc.New(v1.Party("/admin/blog")).Handle(admin.NewBlogController())               //博客相关接口
14
        mvc.New(v1.Party("/admin/link")).Handle(admin.NewLinkController())               //友链相关接口
15
        mvc.New(v1.Party("/admin/site")).Handle(admin.NewSiteController())               //网站信息相关接口
16
        mvc.New(v1.Party("/admin/category")).Handle(admin.NewCategoryController())       //博客分类相关接口
17
        mvc.New(v1.Party("/admin/notice")).Handle(admin.NewNoticeController())           //公告分类相关接口
18
        mvc.New(v1.Party("/admin/special")).Handle(admin.NewSpecialController())         //专栏相关接口
19
        mvc.New(v1.Party("/admin/file")).Handle(admin.NewFileController())               //文件相关接口
20
        mvc.New(v1.Party("/admin/banner")).Handle(admin.NewBannerController())           //轮播图相关接口
21
        mvc.New(v1.Party("/admin/workStation")).Handle(admin.NewWorkStationController()) //统计数据
22
    }
23
}

1.4 数据模型设计#

系统的数据模型定义在pkg/models/目录下，主要包含以下模型：

Admin: 管理员模型
Blog: 博客文章模型
Category: 分类模型
Link: 友链模型
Notice: 公告模型
Section: 页面区块模型
Site: 网站信息模型
Special: 专栏模型
Webmaster: 站长模型
Banner: 轮播图模型
AI相关模型（注：此为个人修改版本新增功能，详情请参考 https://github.com/AI-FIRE/）

1.5 业务逻辑分层#

1.5.1 控制器层 (Controllers)#

控制器层负责处理HTTP请求，接收参数，调用业务逻辑，并返回响应。控制器位于web/controllers/目录下，分为前端控制器和管理端控制器。

示例：博客控制器

1
// 前端博客控制器
2
func NewBlogController() *BlogController {
3
    return &BlogController{
4
        BlogService: services.NewBlogService(),
5
    }
6
}
7

8
// 管理端博客控制器
9
func NewBlogController() *BlogController {
10
    return &BlogController{
11
        BlogService: services.NewBlogService(),
12
    }
13
}

1.5.2 业务逻辑层 (Services)#

业务逻辑层负责处理核心业务逻辑，位于web/services/目录下。

1.5.3 数据访问层 (DAOs)#

数据访问层负责与数据库交互，位于web/daos/目录下。

1.6 AI功能集成#

注：AI功能为个人修改版本新增功能，详情请参考 https://github.com/AI-FIRE/

系统集成了DeepSeek AI功能，相关代码位于以下位置：

pkg/beans/ai/: AI相关数据传输对象
pkg/models/ai/: AI配置模型
web/controllers/ai/: AI控制器
web/daos/ai/: AI数据访问
web/services/ai/: AI业务逻辑

AI接口示例：

1
// 直接返回型DeepSeek AI聊天接口
2
func (c *DeepSeekController) ChatFirstPageAi(ctx iris.Context) {
3
    // 处理AI聊天请求
4
}
5

6
// 流式传输型DeepSeek AI聊天接口
7
func (c *DeepSeekController) StreamChatFirstPageAi(ctx iris.Context) {
8
    // 处理AI流式聊天请求
9
}

1.7 开发环境搭建#

1.7.1 依赖安装#

1
go mod tidy

1.7.2 本地运行#

1
go run cmd\flygoose\main.go

1.7.3 配置说明#

在cmd/flygoose/flygoose-config.yaml文件中配置数据库连接信息：

1
# 服务端口
2
http:
3
  port: 29090
4
# 数据库配置
5
database:
6
  driver: mysql
7
  host: 127.0.0.1
8
  port: 3306
9
  name: db_flygoose
10
  user: root
11
  password: root

1.8 编译与打包#

1.8.1 本地编译#

1
# Windows平台编译
2
$env:GOOS="windows"; $env:GOARCH="amd64"; go build -o flygoose-api-2.0-win-amd64.exe ./cmd/flygoose
3

4
# Linux平台编译
5
$env:GOOS="linux"; $env:GOARCH="amd64"; go build -o flygoose-api-2.0-linux-amd64 ./cmd/flygoose
6

7
# macOS平台编译 (Intel芯片)
8
$env:GOOS="darwin"; $env:GOARCH="amd64"; go build -o flygoose-api-2.0-darwin-amd64 ./cmd/flygoose
9

10
# macOS平台编译 (Apple芯片)
11
$env:GOOS="darwin"; $env:GOARCH="arm64"; go build -o flygoose-api-2.0-darwin-arm64 ./cmd/flygoose

1.8.2 运行编译后的程序#

1
# Linux平台
2
chmod +x flygoose-api-2.0-linux-amd64
3
./flygoose-api-2.0-linux-amd64 -c flygoose-config.yaml
4

5
# Windows平台
6
flygoose-api-2.0-win-amd64.exe -c flygoose-config.yaml

1.9 健康检查#

系统提供了健康检查接口，用于验证服务是否正常运行：

1
curl http://localhost:29090/api/health

返回结果：

1
{"code":1,"data":null,"message":"success"}

二、管理端前端开发#

（管理端前端部分将在后续章节中详细介绍）

三、二次开发指南#

3.1 添加新功能模块#

3.1.1 创建数据模型#

在pkg/models/目录下创建新的数据模型。

3.1.2 创建数据传输对象#

在pkg/beans/目录下创建对应的数据传输对象。

3.1.3 创建数据访问层#

在web/daos/目录下创建数据访问层。

3.1.4 创建业务逻辑层#

在web/services/目录下创建业务逻辑层。

3.1.5 创建控制器#

在web/controllers/目录下创建控制器。

3.1.6 注册路由#

在inits/flygoose_init.go文件中注册新的路由。

3.2 AI功能扩展#

注：AI功能为个人修改版本新增功能，详情请参考 https://github.com/AI-FIRE/

系统支持扩展AI功能，可以在web/controllers/ai/、web/daos/ai/和web/services/ai/目录下添加新的AI接口和功能。

3.3 配置扩展#

在configs/config.go文件中添加新的配置项，并在cmd/flygoose/flygoose-config.yaml文件中配置对应的值。

四、部署说明#

4.1 服务器部署#

4.1.1 准备工作#

服务器或云主机（推荐配置：2核4G以上，操作系统：Ubuntu 20.04+）
MySQL 8.0+ 数据库
Nginx（可选，用于反向代理和HTTPS配置）

4.1.2 安装依赖#

1
# 更新系统
2
apt-get update
3

4
# 安装依赖
5
apt-get install -y vim wget curl mysql-server

4.1.3 配置数据库#

1
# 登录MySQL
2
mysql -u root -p
3

4
# 创建数据库
5
CREATE DATABASE db_flygoose DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
6

7
# 创建用户并授权
8
CREATE USER 'flygoose'@'%' IDENTIFIED BY 'flygoose';
9
GRANT ALL PRIVILEGES ON db_flygoose.* TO 'flygoose'@'%';
10
FLUSH PRIVILEGES;
11

12
# 退出
13
EXIT;

4.1.4 部署应用#

1
# 创建应用目录
2
mkdir -p /opt/flygoose
3

4
# 上传编译好的程序和配置文件
5
cd /opt/flygoose
6

7
# 修改配置文件
8
vim flygoose-config.yaml
9

10
# 赋予执行权限
11
chmod +x flygoose-api-2.0-linux-amd64
12

13
# 后台运行
14
nohup ./flygoose-api-2.0-linux-amd64 -c flygoose-config.yaml &

4.1.5 Nginx配置（可选）#

1
# 安装Nginx
2
apt-get install -y nginx
3

4
# 配置Nginx
5
vim /etc/nginx/conf.d/flygoose.conf

Nginx配置示例：

1
server {
2
    listen 80;
3
    server_name yourdomain.com;
4

5
    location /api {
6
        proxy_pass http://localhost:29090;
7
        proxy_set_header Host $host;
8
        proxy_set_header X-Real-IP $remote_addr;
9
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
10
    }
11
}

1
# 重启Nginx
2
systemctl restart nginx

4.2 Docker部署（可选）#

项目包含Dockerfile，可以使用Docker进行部署。

1
# 构建镜像
2
docker build -t flygoose-api .
3

4
# 运行容器
5
docker run -d -p 29090:29090 -v ./flygoose-config.yaml:/app/flygoose-config.yaml --name flygoose-api flygoose-api

五、接口文档#

详细的API接口文档请参考docs/接口文档.md文件。

六、常见问题与解决方案#

6.1 数据库连接失败#

检查数据库服务是否正常运行
检查数据库连接配置是否正确
检查数据库用户权限是否正确

6.2 服务启动失败#

检查端口是否被占用
检查配置文件是否正确
检查日志文件获取详细错误信息

6.3 AI功能无法使用#

注：AI功能为个人修改版本新增功能，详情请参考 https://github.com/AI-FIRE/

检查AI配置是否正确
检查网络连接是否正常
检查AI服务是否可用

音乐

音乐

飞鹅博客系统初始化及二次开发（二）后端

飞鹅博客系统初始化及二次开发（二）后端#

一、后端开发#

1.1 项目结构解析#

1.2 核心配置文件说明#

1.2.1 主配置文件结构#

1.2.2 配置文件示例#

1.3 应用初始化流程#

1.3.1 创建应用实例#

1.3.2 启动应用#

1.3.3 数据库初始化与自动迁移#

1.3.4 路由配置#

1.4 数据模型设计#

1.5 业务逻辑分层#

1.5.1 控制器层 (Controllers)#

1.5.2 业务逻辑层 (Services)#

1.5.3 数据访问层 (DAOs)#

1.6 AI功能集成#

1.7 开发环境搭建#

1.7.1 依赖安装#

1.7.2 本地运行#

1.7.3 配置说明#

1.8 编译与打包#

1.8.1 本地编译#

1.8.2 运行编译后的程序#

1.9 健康检查#

二、管理端前端开发#

三、二次开发指南#

3.1 添加新功能模块#

3.1.1 创建数据模型#

3.1.2 创建数据传输对象#

3.1.3 创建数据访问层#

3.1.4 创建业务逻辑层#

3.1.5 创建控制器#

3.1.6 注册路由#

3.2 AI功能扩展#

3.3 配置扩展#

四、部署说明#

4.1 服务器部署#

4.1.1 准备工作#

4.1.2 安装依赖#

4.1.3 配置数据库#

4.1.4 部署应用#

4.1.5 Nginx配置（可选）#

4.2 Docker部署（可选）#

五、接口文档#

六、常见问题与解决方案#

6.1 数据库连接失败#

6.2 服务启动失败#

6.3 AI功能无法使用#

支持与分享

评论区

音乐

文章目录