mini-tiktok

Mini-Tiktok 极简版抖音

一、基本介绍

1.1 项目介绍

mini-tiktok是一个基于微服务框架Kitex和HTTP框架Hertz开发的极简抖音后端项目; 您可以在极简抖音App使用说明 - 青训营版中获取安卓APP下载链接; 所有接口及说明文档请参考极简版抖音接口说明文档；

本项目来自第五届字节跳动青训营后端专场，感谢字节跳动提供的技术学习和交流平台

1.2 技术栈

• 本项目使用Go语言开发，采用了字节跳动开源的微服务RPC框架Kitex和HTTP框架Hertz；
• 本项目使用MySQL、Redis以及MongoDB作为数据库支持，并且使用ETCD实现微服务的发现与注册；
• 此外本项目还使用到了viper、gorm、jaeger等第三方库以及使用nginx提供文件访问服务。

1.3 项目结构

本项目将需求拆分为七个RPC服务、一个http的api接口以及一个静态资源访问的接口：

项目整体架构：

项目文件结构：

├── cmd: 
│    ├── api: API访问接口
│    ├── comment：评论发布和查询相关微服务
│    ├── favorite：视频点赞及列表相关微服务
│    ├── feed：视频流推送微服务
│    ├── message：用户聊天微服务
│    ├── publish：视频发布及列表查询相关微服务
│    ├── relation：关注、粉丝和朋友相关功能微服务
│    └── user：用户登录、注册、查询相关功能微服务
├── config: 配置信息结构, 对应yaml配置文件
├── idl: 接口描述文件
│    ├── comment.thrift：评论相关
│    ├── favorite.thrift：点赞相关
│    ├── feed.thrift：视频推送
│    ├── message.thrift：聊天相关
│    ├── publish.thrift：视频发布相关
│    ├── relation.thrift：关注相关
│    └── user.thrift：用户相关
├── kitex_gen: 由kitex代码生成工具生成
├── model: 数据实体
└── pkg: 工具和组件

二、项目启动

1. 环境准备

本项目在Ubuntu 22.04 LTS下进行开发和测试，Windows用户推荐使用WSL2编译运行，并且准备好以下环境：

• 请保证Go编译器版本为1.9.x，以确保代码能够正常编译运行；
• 需要MySQL8.0及以上版本，并且提前创建好一个数据库，字符集为utf8mb4；
• 本项目使用的MongoDB版本为v6.0.6，确保使用支持内存缓存和磁盘缓存的版本以达到最好的运行效果；
• 尽量使用最新版Redis作为缓存数据库；
• 搭建Nginx服务器映射视频文件上传目录，配置文件可参考以下代码：

  server {
      listen 8081; # 端口
      server_name localhost; # 服务名
      charset utf-8; # 避免中文乱码
      root /data; # 显示的根索引目录，即文件上传目录
  
      location / {
          autoindex on;             # 开启索引功能
          autoindex_exact_size off; # 关闭计算文件确切大小（单位bytes），只显示大概大小（单位kb、mb、gb）
          autoindex_localtime on;   # 显示本机时间而非 GMT 时间
      }
  }
  

• 安装ffmpeg，用于截取视频封面；
• 搭建etcd服务，用于服务的注册与发现。

2. 编译和运行

以cmd/user为例，1）进入目录 2）编译 3）运行（请根据config_template.yaml填写配置信息，并且将其重命名为config.yaml后运行）：

cd cmd/user
sh build.sh 
sh output/bootstrap.sh