项目简介

闪灵 Sharine 是一款 Web 短视频平台应用，基于 SpringCloud + Consul 微服务架构，配合 Docker & Kubernetes 实现容器化集群管理。数据库则采用 MySQL + Redis 主缓一体化设计，通过缓存管理器配合 Spring Data 实现自动化缓存管理。本项目开发代码较为规范，可供学习参考。

近期正在重构，如需体验请选择 dev 分支
建议前往 docs 查看完整文档
Demo 视频地址：http://s3nb7l0x2.hn-bkt.clouddn.com/demo.mp4

线上体验

线路屏蔽海外，且测试服务器网络环境复杂，建议优先考虑本地部署进行体验 部分视频无法浏览属正常现象，测试数据中的链接来源于互联网，并不保证其链接有效性

http://ipv4.rinkore.com:15001 测试账号 [email protected] 测试密码 mikkoayaka 当然您也可以选择注册一个账号体验一下

自行部署

环境准备

本项目提供了测试用数据集，请访问 Github 仓库路径 Sharine/server/src/main/resources/Sharine.sql 进行下载

• JDK 17 及以上(测试版本：Oracle JDK 17)
• 支持 JDBC 的 SQL 数据库环境(测试版本：MySQL 5.7.26)
• Redis 数据库环境(测试版本：Redis for Windows 5.0.14)
• Docker 相关环境(测试版本：Docker Desktop 4.21.1)

开始对接

后端部署

请修改后端相关配置文件，完成以下对接：

• SQL 数据库

• Redis 数据库

• Consul 服务中心

• SMTP 邮箱服务

• 七牛云 API

  首先请前往 Github 自动构建页面 下载最新的微服务端 jar 包。 配置文件修改方式有以下两种：

1. 直接使用压缩软件打开微服务端 jar 包，前往 BOOT-INF/classes/ 路径下修改 bootstrap.yml 以及该路径下 config 文件夹中的线上环境配置，修改完毕后保存。
2. 在微服务端 jar 包同目录下创建 config 文件夹，再自行创建 bootstrap.yml 配置文件 下面是 video-service 视频微服务端配置文件参考示例：

# bootstrap.yml
server:
  port: 23401
spring:
  application:
    name: video-service
    id: 1
  profiles:
    active: prod
  config:
    import: consul:localhost:8500/config
  cloud:
    consul:
      config:
        format: yaml
        data-key: ${spring.application.name}-${spring.profiles.active}
      discovery:
        instance-id: ${spring.application.name}-${spring.application.id}
        health-check-timeout: 1s
        prefer-ip-address: true

创建完毕后，前往 Consul 管理页面，进入 K/V 存储中心，添加相应的配置：

# config/video-service-prod.yml
spring:
  # 数据库配置，请按实际环境修改
  datasource:
    type: com.zaxxer.hikari.HikariDataSource
    driver-class-name: com.mysql.cj.jdbc.Driver
    # 数据库连接 URL
    url: jdbc:mysql://localhost:3306/sharine?serverTimezone=Asia/Shanghai&allowMultiQueries=true
    # 数据库用户
    username: root
    # 数据库密码
    password: root
    # 连接池相关配置，无特殊需要可默认不做更改
    hikari:
      minimum-idle: 5
      # 空闲连接存活最大时间，默认600000（10分钟）
      idle-timeout: 180000
      # 连接池最大连接数，默认是10
      maximum-pool-size: 10
      # 此属性控制从池返回的连接的默认自动提交行为,默认值：true
      auto-commit: true
      # 连接池名称
      pool-name: MyHikariCP
      # 此属性控制池中连接的最长生命周期，值0表示无限生命周期，默认1800000即30分钟
      max-lifetime: 1800000
      # 数据库连接超时时间,默认30秒，即30000
      connection-timeout: 30000
      connection-test-query: SELECT 1
  jpa:
    show-sql: false
    hibernate:
      ddl-auto: update
  data:
    # Redis 数据库相关配置
    redis:
      host: localhost
      port: 6379
      password: root
      # SMTP 邮箱配置
  mail:
    host: smtp.163.com
    username: 用户名
    password: 密码
    default-encoding: UTF-8
    port: 587
    properties:
      mail:
        smtp:
          auth: true
          socketFactory:
            class: javax.net.ssl.SSLSocketFactory
# 七牛云相关配置
qiniu:
  access-key: key
  secret-key: key
  bucket: sharine
  domain-of-bucket: s336zn7wo.hn-bkt.clouddn.com
# 闪灵后端应用配置
application:
  # 用户订阅频道最大容量，超过容量则按先进先出规则删除最早数据
  subscribe-channel-size: 128
  # 每IP每日有效播放量统计(防止反复刷播放)
  cache-view-video-size: 256
  # 每IP每分钟请求限制
  query-per-minute-limit: 1200

修改完毕配置文件以后，在服务端同目录下创建服务端启动脚本，可参考以下内容：

# start.bat
# 如果没有配置 Java 环境变量，请修改 Java 为 java.exe 的具体路径
Java -Xms8G -Xmx8G -jar server.jar
pause

编写完成后即可双击启动后端服务器。

前端部署

请首先前往 https://nodejs.org/en 安装 Node.js 环境，并从 项目仓库 拉取 Sharine/web 前端项目文件，修改项目根目录 .env 文件中的环境变量，改为后端服务器 URL。

测试环境

1. 运行 npm install 补全缺失依赖
2. 运行 npm run dev 运行前端

生产环境

1. 运行 npm install 补全缺失依赖
2. 运行 npm run build 打包前端项目文件为 dist 文件夹
3. 下载 nginx 后自行修改相关配置，将前端打包后得到的 dist 文件夹解压到 nginx 配置文件 http.server.location.root 指定的目录下，并运行 nginx