冈易云产品系统

音乐流媒体与社交娱乐平台

随着数字音乐产业的快速发展，用户对音乐聆听体验的需求日益多样化。本项目聚焦于音乐流媒体服务领域的细分市场，致力于解决用户在日常音乐消费过程中面临的核心痛点。当前音乐版权分散在不同平台导致用户体验割裂，部分优质歌曲因版权限制或地域约束无法正常播放，严重影响了用户的音乐消费体验。本项目基于网易云音乐API进行深度二次开发与持续维护，为用户提供一个稳定、高效、功能完善的第三方音乐播放解决方案，满足用户在音乐发现、播放、社交分享等全场景下的使用需求，适用于个人音乐服务器搭建、开发者学习研究、跨平台音乐聚合等多种应用场景，具有广泛的市场应用价值和开源社区贡献意义

核心功能模块：

1. 音乐播放与管理 提供完整的音乐播放链路支持，包括歌曲搜索、在线播放、歌单创建与管理、收藏夹功能等。用户可通过关键字搜索歌曲、歌手、专辑，支持按照热门、最新等维度进行筛选排序。播放功能支持顺序播放、随机播放、单曲循环等常见模式，播放器界面展示歌曲封面、歌词同步等增值信息。

2. 用户认证系统 实现了多种登录认证方式，包括手机号验证码登录、二维码登录、匿名登录等功能。用户登录后可获取个人收藏、播放历史、关注列表等私有数据，游客模式则提供基础的音乐探索功能，满足不同用户的隐私保护需求。

3. 歌曲解锁（解灰）机制 这是本项目的核心特色功能。通过整合多个音乐音源（QQ音乐、酷狗音乐、酷我音乐、咪咕音乐等），当用户播放的歌曲在主源无法播放时，系统会自动切换至备用音源进行播放，实现歌曲的"解锁"功能。该机制支持FLAC无损音质自动匹配，并可根据用户偏好设置音源优先级。

4. 社交互动功能 支持歌曲评论、评论点赞、动态发布、分享等社交功能。用户可对歌曲发表评论并查看其他用户的评论，支持热评和最新评论两种排序方式。动态功能允许用户分享音乐到个人动态页，形成以音乐为核心的社交网络。

5. 个人数据中心 为登录用户提供完整的个人数据中心，包括：我的收藏、播放历史、关注列表、粉丝列表、音乐成就等功能入口。用户可清晰了解自己的音乐偏好、使用时长、累计听歌数量等统计信息，增强用户粘性。

6. 推荐与发现系统 基于用户听歌历史和偏好标签，提供个性化推荐歌单、新歌速递、排行榜等发现入口，帮助用户快速找到符合口味的音乐内容。排行榜模块涵盖热歌榜、新歌榜、飙升榜等多种维度

技术架构设计：

后端技术栈： 本项目后端基于Node.js环境开发，采用Express框架构建RESTful API服务。核心依赖包括：axios用于发起HTTP请求处理与第三方音乐平台的接口通信；crypto-js实现接口签名加密；dotenv管理环境变量配置；express-fileupload处理文件上传场景。在接口设计层面，项目遵循模块化开发原则，将每个API接口独立封装在module目录下，便于维护和扩展。服务器默认运行在3000端口，支持通过PORT环境变量自定义配置。

前端技术栈： 前端项目采用Vue3作为核心框架，使用Vite作为构建工具获得更快的开发体验。状态管理采用Pinia替代传统的Vuex，提供更简洁高效的响应式状态管理方案。路由管理使用Vue Router实现页面导航。前后端通信通过axios统一封装API请求方法，支持请求拦截、响应格式化、错误统一处理等能力。UI层面采用原生CSS样式自定义，未引入第三方UI框架，确保项目体积轻量化。

核心模块实现：

1. 多音源切换机制 项目实现了统一的外层API接口，内部集成多个音乐平台的播放器接口。当主源请求失败或歌曲不可用时，系统按照预设的音源优先级自动尝试备用音源。解灰逻辑集成在接口层，对前端完全透明，无需前端感知底层实现细节。

2. 配置生成与设备注册 服务启动时自动进行设备注册，生成匿名token和随机中文IP地址用于API调用请求。配置生成器（generateConfig）负责初始化必要的认证参数，确保API调用能够正常发起。

3. 数据流动设计 前端Vue应用通过API服务层与后端通信，后端Node.js服务作为中间层转发请求至各音乐平台接口。这种架构设计既保护了用户隐私（真实请求由服务端发起），又实现了跨平台音乐资源的统一访问。

部署与扩展： 项目提供Docker容器化部署支持，