Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/KaniuBillows/MuKaiMusic

一个免费的音乐平台，致力于：一个平台所有音乐
https://github.com/KaniuBillows/MuKaiMusic

Last synced: 3 months ago
JSON representation

一个免费的音乐平台，致力于：一个平台所有音乐

Host: GitHub
URL: https://github.com/KaniuBillows/MuKaiMusic
Owner: KaniuBillows
Archived: true
Created: 2019-11-07T09:56:08.000Z (over 4 years ago)
Default Branch: microService
Last Pushed: 2022-12-07T01:03:29.000Z (over 1 year ago)
Last Synced: 2024-01-16T11:38:32.314Z (5 months ago)
Language: C#
Size: 14.5 MB
Stars: 13
Watchers: 2
Forks: 2
Open Issues: 28
Metadata Files:
- Readme: README.md

Lists

awesome-stars - MuKaiMusic

README

# MuKaiMusic with MicroService
一个免费的音乐平台，致力于：一个平台所有音乐。
本项目只是个人学习开发用的，任何人，任何组织不得以任何理由商用。
此分支为微服务架构，将主力维护此分支，原master分支为自己傻乎乎造轮子的产物。
## Demo
https://music.kaniu.pro

# 微服务架构
这一段时间并没有添加新的功能，但是并没有偷懒。正在学习全新的微服务架构，奈何手上没啥项目，那就好拿Mukai Music开刀了。
本人才疏学浅，也是第一次玩这个，如果能帮到你，我非常高兴。如果做的不好，希望能得到建议。

## 项目基于原Mukai Music重构而来
* 感谢[jsososo/MiguMusicApi](https://github.com/jsososo/MiguMusicApi)
* 感谢[Binaryify/NeteaseCloudMusicApi](https://github.com/Binaryify/NeteaseCloudMusicApi)
* 感谢React-Native-Community.

## React-Native客户端
1. 配置好React-Native开发环境以及Expo Cli，准备一台设备,目前仅在Android环境测试过,
由于项目依赖的react-native-sound在Windows运行会出现一个'[RNSound.IsAndroid](https://github.com/zmxv/react-native-sound/issues/592)'的错误，所以只能在设备上跑,
后续会继续尝试解决此问题，如果实在无法解决，会考虑使用Expo.Audio来进行音频播放.
2. 进入MuKaiMusic/Clients/React-Native
3. `yarn add`
4. `expo eject`
5. `yarn android`

2020-10-12：目前仅包含一个miniPlayer，后续会持续更新.

### 使用Docker，更加易于部署（我的数据库用的RDS（便宜），不然直接放Docker里面了，会更方便）
### Ocelot网关，咱.NET就是好啊
### Consul服务治理，微服务必备
### 完全解耦各个模块，但为了保证数据格式同一，任然保留DataAstract项目，其中定义了数据结构（各个音乐平台数据结构太不一样了，不同一很麻烦）
### JWT验证方案，单独的验证服务，单点登录必备（但是注册账户、用户资料还没来得及搞，哈哈哈）
### 整合三个音乐平台，基本能听许多许多歌曲了
### 将不同平台的歌曲保存为自己的歌单（已开发完成API，客户端正在开发，详见Mukai Playlist）

## 功能
1. 各个平台搜索:
咪咕[/migu/search?keyword=陈奕迅](https://api.kaniu.pro/migu/search?keyword=陈奕迅)
酷我[/kuwo/search?keyword=陈奕迅](https://api.kaniu.pro/kuwo/search?keyword=陈奕迅)
网易[/ne/search?keyword=陈奕迅](https://api.kaniu.pro/ne/search?keyword=陈奕迅), 要整合请自己整合，这里可以用编辑距离对排序进行优化哦
2. 获取Url,直接平台对应的id
酷我为例：[/kuwo/url?id=45275102](https://api.kaniu.pro/kuwo/url?id=45275102)
3. 获取专辑图片，直接平台对应的id
咪咕为例：[/migu/pic?id=54680](https://api.kaniu.pro/migu/pic?id=54680)
4. 获取歌词，咪咕要的是copyrightId,酷我和网易是直接歌曲id
网易为例: [/ne/lyric?id=551816010](https://api.kaniu.pro/ne/lyric?id=551816010)
5. 获取推荐歌单，暂时只有网易云的，其他的我在考虑要不要也弄
[/ne/playlist/personlized?limit=10](https://api.kaniu.pro/ne/playlist/personlized?limit=10)
6. 获取歌单详情
[/ne/playlist/detail?id=532711476](https://api.kaniu.pro/ne/playlist/detail?id=532711476)

... 用户歌单功能做了API，客户端还没来得及做，先不放出来了，后面再更新吧

# 如何部署（如果部署遇到问题，可以试试联系我，或许咱能帮你呢）
0. 一个Docker，一个RDS（账户用），一个MongoDB（自定义歌单用）
1. 配置Docker网络，新建名为“mynet”的network，并将其设置为172.18.0.0/16（当然你完全可以选择设置其他网段，但是你得更改所有项目的相关配置文件建议你还是照做）
2. 通过Consul路径下的docker-compose.yml，启动Consul，默认包含一个Server和Client。当然，你可以修改它。
3. 在保证Consul已经Ok的情况下，其他的服务你可以以任意顺序启动（docker-compose.yml）。
4. 如果你在服务文件夹里发现了build.cmd,或者build.sh，那么麻烦在用docker-compose之前，先运行它。（因为这服务需要DataAbstarct中定义的数据结构，但是DataAbstract并不在Docker上下文中，所以我们直接构建应用程序，并复制到Docker镜像中）
5. Mukai Auth，需要一个关系型数据库(我是postgresql)(你可以在它的配置文件中设置对应的连接字符串（appsettings.{Environment}.json）然后用对应的EF Core工具进行迁移，记得修改Startup.cs)。
6. Mukai Playlist需要一个MongoDB,需要在appsettings.{Environment}.json中进行配置。
7. Mukai Account 是账户服务，对用户注册，用户信息存储等服务。用户头像默认实现依靠的阿里云Oss，你可以自己实现IFileService接口，存储在数据库或是文件系统都可以。
8. Angular客户端，你需要修改Environment.ts中的BaseURL,并指向你的Ocelot网关地址。

## 部署步骤写的很详细，目的是帮助你更加熟悉它。你或许也可以试试用一个docker-compose.yml搞定所有。