Public
Star 历史趋势
数据来源: GitHub API · 生成自 Stargazers.cn
README.md
feedsystem_video_go
基于 Go + Vue 3 的短视频 Feed 系统，含账号、视频、点赞、评论、关注、Feed 流、私信、通知，支持 Redis 缓存、RabbitMQ 异步 Worker、分片上传、SSE 实时推送、Docker Compose 部署。
更完整的视频 Feed 流系统项目
LeoninCS/GCFeed 是更为全面完整的视频 Feed 流系统项目，覆盖更丰富的业务能力与工程实践。
功能
| 模块 | 功能 |
|---|---|
| 账号 | 注册、登录、Refresh Token、改名、改密、登出、头像上传、个人简介、主页统计 |
| 视频 | 普通上传、5MB 分片上传、断点续传、封面上传、发布、作者作品、详情缓存、#话题标签 |
| 点赞 | 点赞、取消点赞、是否已赞、已赞列表、RabbitMQ 异步落库、热度更新、SSE 通知 |
| 评论 | 发布、删除、列表、@username 提及通知、RabbitMQ 异步落库、热度更新 |
| 关注 | 关注、取关、粉丝列表、关注列表、粉丝/关注计数、SSE 通知 |
| Feed | 推荐流、关注流、点赞榜、热榜、话题流、冷热分离、游标分页、短视频沉浸播放 |
| 私信 | 发送私信、按对端用户查看最近 50 条会话 |
| 通知 | 点赞/评论/关注事件通知、提及通知、SSE 实时推送、通知列表、未读计数、已读标记 |
| 工程 | Docker Compose、start.sh、API/Worker 拆分运行、限流、pprof、健康检查 |
Docker Compose 一键启动
docker compose up -d --build访问：
- 前端：
http://localhost:5173 - 后端 API：
http://localhost:8080 - RabbitMQ 管理台：
http://localhost:15672（admin/password123）
Docker Compose 会读取 .env，缺省使用 feedsystem-dev-secret-key。生产环境请修改 JWT_SECRET。
脚本启动
./start.shstart.sh 默认启动 RabbitMQ、Redis、后端 API、Worker 与前端。常用开关：
START_FRONTEND=0 ./start.sh # API + Worker
START_WORKER=0 ./start.sh # API + 前端
STOP_DOCKER=1 ./start.sh # 退出时停止脚本拉起的 compose 服务
CONFIG_PATH=configs/config.yaml ./start.sh本地开发
# 启动依赖
docker compose up -d mysql redis rabbitmq
# 后端
cd backend
CONFIG_PATH=configs/config.compose-local.yaml go run ./cmd
# Worker
CONFIG_PATH=configs/config.compose-local.yaml go run ./cmd/worker
# 前端
cd frontend
npm install && npm run devCI
GitHub Actions 配置位于 .github/workflows/ci.yml，在 Pull Request 以及推送到 main、master 时运行。
- 后端：Go 1.24.x，执行
go mod download、go vet ./...、go test -race -count=1 ./... - 前端：Node.js 22，执行
npm ci、npm run build
接口清单
账号 /account
| 方法 | 路径 | 鉴权 | 说明 |
|---|---|---|---|
| POST | /register | 否 | 注册（限流 5次/时/IP） |
| POST | /login | 否 | 登录，返回 access_token + refresh_token |
| POST | /refresh | 否 | 刷新 access_token（用 refresh_token） |
| POST | /changePassword | 否 | 改密码（需旧密码） |
| POST | /findByID | 否 | 按 ID 查用户 |
| POST | /findByUsername | 否 | 按用户名查 |
| POST | /getProfile | 否 | 用户主页（视频数/获赞/粉丝数） |
| POST | /logout | JWT | 登出（同时失效双 token） |
| POST | /rename | JWT | 改名 |
| POST | /uploadAvatar | JWT | 上传头像（jpg/png/webp，≤10MB） |
| POST | /updateProfile | JWT | 更新简介/头像 |
视频 /video
| 方法 | 路径 | 鉴权 | 说明 |
|---|---|---|---|
| POST | /publish | JWT | 发布视频（自动提取 #话题） |
| POST | /uploadVideo | JWT | 上传视频文件（mp4，≤200MB） |
| POST | /uploadCover | JWT | 上传封面（jpg/png/webp，≤10MB） |
| POST | /chunk/init | JWT | 初始化分片上传（文件 MD5、大小、分片数） |
| POST | /chunk/upload | JWT | 上传单个分片（multipart，含分片 MD5 校验） |
| POST | /chunk/status | JWT | 查询已上传分片 |
| POST | /chunk/complete | JWT | 合并分片并返回 play_url |
| POST | /listByAuthorID | 否 | 按作者查视频 |
| POST | /getDetail | 否 | 视频详情缓存 |
点赞 /like
| 方法 | 路径 | 鉴权 | 说明 |
|---|---|---|---|
| POST | /like | JWT | 点赞 |
| POST | /unlike | JWT | 取消点赞 |
| POST | /isLiked | JWT | 是否已赞 |
| POST | /listMyLikedVideos | JWT | 我赞过的视频 |
评论 /comment
| 方法 | 路径 | 鉴权 | 说明 |
|---|---|---|---|
| POST | /listAll | 否 | 评论列表（分页200，按时间升序） |
| POST | /publish | JWT | 发布评论（支持 @username 提及） |
| POST | /delete | JWT | 删除评论 |
关注 /social
| 方法 | 路径 | 鉴权 | 说明 |
|---|---|---|---|
| POST | /follow | JWT | 关注 |
| POST | /unfollow | JWT | 取关 |
| POST | /getAllFollowers | JWT | 粉丝列表（含粉丝数） |
| POST | /getAllVloggers | JWT | 关注列表（含关注数） |
| POST | /getCounts | JWT | 粉丝/关注计数 |
Feed /feed
| 方法 | 路径 | 鉴权 | 说明 |
|---|---|---|---|
| POST | /listLatest | 软鉴权 | 最新视频（游标分页） |
| POST | /listLikesCount | 软鉴权 | 点赞排行（复合游标） |
| POST | /listByPopularity | 软鉴权 | 热度榜（快照分页） |
| POST | /listByFollowing | JWT | 关注流 |
| POST | /listByTag | 软鉴权 | 按 #话题 浏览 |
通知 /notification
| 方法 | 路径 | 鉴权 | 说明 |
|---|---|---|---|
| GET | /stream?token=<access_token> | 是 | SSE 实时推送，也支持 Authorization: Bearer <token> |
| POST | /list | 是 | 最近 50 条通知 |
| POST | /markRead | 是 | 标记已读；传 id 标记单条，省略 id 标记全部 |
| POST | /unreadCount | 是 | 未读计数 |
私信 /message
| 方法 | 路径 | 鉴权 | 说明 |
|---|---|---|---|
| POST | /send | JWT | 发送私信 |
| POST | /list | JWT | 对话列表 |
环境变量
| 变量 | 默认值 | 说明 |
|---|---|---|
JWT_SECRET | feedsystem-dev-secret-key | JWT 签名密钥，生产须改 |
SERVER_PORT | 8080 | 后端监听端口 |
MYSQL_HOST / MYSQL_PORT | 配置文件值 | MySQL 地址 |
MYSQL_USER / MYSQL_PASSWORD | 配置文件值 | MySQL 账号密码 |
MYSQL_ROOT_PASSWORD | 123456 | MySQL root 密码 |
MYSQL_DATABASE | feedsystem | MySQL 数据库名 |
REDIS_HOST / REDIS_PORT | 配置文件值 | Redis 地址 |
REDIS_PASSWORD | 123456 | Redis 密码 |
REDIS_DB | 0 | Redis DB |
RABBITMQ_HOST / RABBITMQ_PORT | 配置文件值 | RabbitMQ 地址 |
RABBITMQ_USER / RABBITMQ_PASS | admin / password123 | RabbitMQ 账号 |
详见 .env.example。
运维与可观测性
GET /healthz返回后端健康状态。- 本地配置默认开启 pprof：API
localhost:6060，Workerlocalhost:6061。 - 上传文件写入
backend/.run/uploads；Docker 环境挂载到backend_uploadsvolume。 - Redis 用于 Token 缓存、视频实体缓存、Feed 时间线、热榜窗口、分片上传会话。
- RabbitMQ Topic Exchange 覆盖点赞、评论、关注、热度、视频时间线事件，并配置 DLX。