Bangumi Server 是什么bgm.tv 新后端项目全解析【免费下载链接】serverAPI server for bgm.tv项目地址: https://gitcode.com/gh_mirrors/server17/serverBangumi Server是 ACG 社区网站 bgm.tvBangumi 番组计划的新后端 API 服务项目用 Go 语言从零重构的开源项目。如果你对动漫、游戏、书籍的收藏管理感兴趣或者想了解一个真实的大型 Go 后端如何设计这篇bgm.tv 新后端项目全解析会带你快速看懂它的定位、技术栈与启动方式。它不仅是老牌动画数据库的新引擎更是学习现代 Go Web 架构的绝佳范本。一、什么是 bgm.tv为什么要重写后端bgm.tv中文常称Bangumi 番组计划是国内 ACG 爱好者使用最广泛的动漫、游戏、书籍数据库与社区平台。用户可以收藏条目、标记观看进度、参与 wiki 编辑并浏览丰富的角色、人物资料。随着业务发展旧的后端架构逐渐难以满足新功能的需求于是官方启动了新后端项目也就是Bangumi Server。它负责为api.bgm.tv提供公开 API为前端页面提供数据支撑同时承担搜索、消息队列、数据导出等配套能力。二、Bangumi Server 的核心功能与亮点这个新后端项目的功能覆盖了 bgm.tv 的核心业务主要有以下几大块条目系统动画、书籍、游戏、三次元等条目的查询与详情角色与人物角色资料、人物资料及其与条目的关联关系⭐收藏系统用户对条目、角色、人物的收藏与进度管理修订系统wiki 编辑的历史修订记录查询搜索服务基于 Meilisearch 的条目、角色、人物搜索目录Index用户自建条目列表与收藏这些能力通过一套OpenAPI 规范的公开接口对外提供定义文件位于 openapi/v0.yaml前端开发者可以直接参考接口文档进行对接。三、Bangumi Server 技术栈一览作为一个现代化的 Go 后端Bangumi Server 的技术选型相当标准且前沿类别技术选型用途编程语言Go 1.26高性能并发后端Web 框架EchoHTTP 路由与中间件ORMGORM GORM Gen数据模型与类型安全的查询数据库MySQL主数据存储缓存Redisrueidis 客户端缓存与限流消息队列Kafkabinlog 订阅与事件流搜索引擎Meilisearch全文搜索依赖注入go.uber.org/fx模块化装配对象存储S3图片处理与存储依赖清单可以查看项目根目录的 go.mod其中甚至包含项目自研的 wiki 解析器bangumi/wiki-parser-go用于解析 bgm.tv 特有的 wiki infobox 语法。四、Bangumi Server 目录结构快速解读第一次接触这个项目可能会被庞大的目录吓到。其实结构非常清晰可以按层理解cmd/三个可执行入口对应 web、canal、archive 三个命令config/配置结构与环境变量定义dal/数据访问层包含 GORM Gen 自动生成的 DAO 与 Query 代码internal/核心业务领域如 auth、subject、character、person、collections 等web/HTTP 层路由、Handler、中间件与请求响应封装openapi/OpenAPI 接口定义与测试pkg/可复用的通用工具包dam、gstr、gtime、logger 等其中 Web 层的路由定义集中在 web/routes.go你可以在这里看到/v0前缀下的所有公开 API 路径比如条目、角色、人物、收藏、修订、搜索等接口。五、Bangumi Server 快速启动方法想要在本地跑起来项目提供了非常友好的 task 命令体系基于 go-task核心命令如下task # 查看所有构建目标 task web # 构建并启动 HTTP 服务器 task consumer # 启动 Kafka 消费者 task test # 运行单元测试无需外部依赖 task lint # 运行代码检查启动前需要准备 MySQL 与 Redis相关的环境变量定义在 config/config.go 中例如环境变量默认值说明MYSQL_HOST127.0.0.1数据库地址MYSQL_DBbangumi数据库名REDIS_URIredis://127.0.0.1:6379/0Redis 连接HTTP_PORT3000HTTP 监听端口MEILISEARCH_URL空搜索服务地址可选KAFKA_BROKER空Kafka 地址可选你还可以把这些配置写入.env文件task 命令会自动加载。六、三个命令行工具各司其职Bangumi Server 编译后提供三个子命令分别承担不同的职责web启动 HTTP API 服务器是面向用户和前端的主要服务canal基于 Kafka 的 MySQL binlog 订阅处理当前用于用户密码修改等事件同步相关代码见 canal/archive将数据库中的条目、角色、人物、章节及各类关系导出为 JSON Lines 格式的 zip 归档实现代码在 cmd/archive/main.go这种一个项目、多命令的设计让核心逻辑与辅助工具共享同一套代码库非常值得学习。七、Bangumi Server 适合谁学习和使用ACG 数据爱好者可以基于公开 API 构建自己的动漫收藏、进度管理小工具Go 后端开发者这里有一套完整的 DDD 分层、依赖注入、中间件、限流、缓存、搜索、消息队列实战案例数据分析者利用archive命令导出的数据可以离线分析整个站点的条目与评分分布八、写在最后作为 bgm.tv 的新后端项目Bangumi Server 用现代 Go 技术栈重新诠释了一个老牌 ACG 数据库的 API 层。无论你是想调用它的接口还是想从中学习大型 Go 项目的工程实践这个开源项目都值得深入研究。想本地体验的话直接克隆仓库并执行task web即可开始探索之旅【免费下载链接】serverAPI server for bgm.tv项目地址: https://gitcode.com/gh_mirrors/server17/server创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考