青律音乐：一套可自建、可运营、可扩展的多音源音乐解析平台

青律音乐 点击跳转

青律音乐 点我跳转
青律音乐是一套音乐解析与管理系统。它把多音源搜索、播放、歌词、下载、收藏、积分体系、后台运营和开放 API 放进同一套可自部署的程序中，既能作为个人音乐工具，也适合做带用户体系的音乐站点或为自己的应用提供统一接口。

项目的重点不是堆砌页面，而是把“找歌、解析、播放、下载、管理、对外调用”这条链路完整打通：前台使用顺手，后台状态清晰，接口调用可控，后续升级也有明确路径。

音乐可用性、可选音质和下载结果由已开启音源、账号权限与上游服务返回结果共同决定。请在合法合规、尊重版权与平台规则的前提下使用。

• 多音源统一体验：网易云音乐、QQ 音乐、酷狗音乐、酷我音乐、汽水音乐与本地上传音乐统一在一个界面中使用。
• 从搜索到下载闭环：支持搜索、链接识别、在线播放、歌词、播放列表、收藏、历史记录、批量下载和 ZIP 打包。
• 不是只有前台页面：自带用户、等级、积分、签到、卡密、公告、主题、邮件、SEO、备份、日志和数据看板。
• 开放接口可直接接入应用：提供统一 REST 风格音乐 API，支持 GET 与 POST，可按 Key 控制音源、频率、总次数和每日额度。
• 真实能力动态控制：前端与开放 API 会依据音源能力自动展示或禁用功能，不把不支持的入口留给用户点击后报错。
• 部署和升级有保障：首次安装提供环境检查和数据库初始化；已有站点支持覆盖升级与数据库迁移，尽量保护原有数据。

音源能力一览

不同平台的上游能力不同，青律音乐会如实展示当前可用功能，而不是用同一套按钮制造误导。

其中，网易云与 QQ 音乐适合完整的歌曲、歌单、专辑浏览场景；酷狗、酷我适合歌曲检索和播放补充；汽水音乐保留轻量的分享链接解析入口。

面向用户的前台体验

搜索、解析与播放

• 多音源切换与可用状态展示。
• 支持关键词搜索，也支持从混合文本中提取歌曲、歌单、专辑和分享链接中的有效标识。
• 按音源能力展示歌曲、歌单、专辑等结果，避免无效入口。
• 在线播放、播放列表、上一首/下一首、进度控制与歌词展示。
• 多音质选择，实际可用音质以音源返回与当前权限为准。
• 响应式界面，兼顾桌面端和移动端的搜索、筛选与播放操作。

收藏、历史与下载

• 收藏歌曲，也可收藏已支持的歌单和专辑。
• 保存解析历史，可快速回到最近播放或重新解析的内容。
• 单曲下载、批量下载与 ZIP 打包。
• 下载任务中心会保存任务进度和失败状态，刷新页面后任务记录不轻易丢失。
• 下载文件会尽力写入歌曲名、歌手、专辑、封面与歌词等元数据，方便离线播放器识别和管理。
• 支持用户上传音乐、封面和歌词，形成独立的本地曲库。

个性化与站点体验

• 明暗模式和多套主题风格。
• 站点公告、赞赏信息、社群入口、站点图标等可在后台维护。
• 登录、注册、邮箱验证码、找回密码与会话管理。
• 用户等级、每日额度与功能权限可按运营策略配置。

积分体系

青律音乐不只适合个人部署，也为需要用户运营的站点准备了完整基础能力：

• 每日签到、连续签到与签到积分。
• 解析、下载等操作可按音源和行为分别配置积分消耗。
• 扣积分失败保护与异常退款处理，减少误扣风险。
• 每日解析额度、游客试听额度和用户等级权限。
• 卡密/兑换码批次管理：可设置额度、有效期、总可使用次数、单用户使用上限，并查看使用记录。
• 用户管理、用户详情、等级申请处理和数据导出。

开放音乐 API

项目内置面向外部应用的统一音乐 API，可作为小程序、桌面工具、移动端应用或其他站点的音乐服务层。

已提供的接口能力

• 单音源歌曲搜索。
• 综合搜索：在支持的音源中返回歌曲、歌单和专辑结果。
• 单曲详情、歌单详情、专辑详情、歌词与播放地址获取。
• 支持 GET 和 POST 两种调用方式。
• 按音源能力返回结果，调用方可以根据统一响应结构处理数据。

调用管理能力

• 独立 API Key 管理，可单独启用或停用。
• 为每个 Key 配置允许调用的音源。
• 每分钟频率限制、累计调用次数限制、每日调用次数限制；设置为不限额时可按实际需求开放。
• 记录调用时间、来源 IP、请求方法、结果、状态码和耗时，便于排查接入问题与识别异常流量。
• 后台内置在线开发文档，按音源和操作分类展示参数与返回结构，降低接入成本。

除开放音乐 API 外，系统还提供独立的签到接口，便于与其他业务系统联动。

安装、部署与升级

青律音乐面向常见 PHP 环境设计，可用于宝塔面板和常规 Nginx/Apache 站点。

• 首次安装会检查 PHP 环境、扩展、目录权限和数据库连接，并引导创建管理员账号。
• 空数据库直接执行全新安装；检测到已有数据时，安装程序会提供全新安装与覆盖安装选择。
• 覆盖安装会以兼容既有数据、补充新结构为目标；升级后可执行数据库迁移以保持版本一致。
• 项目提供全新安装、直接解压、覆盖升级和宝塔部署等文档，便于不同场景使用。
• 前端静态资源带版本控制，降低浏览器缓存导致样式或脚本未更新的问题。

适合哪些场景

• 想部署个人音乐搜索、播放与收藏站点的开发者。
• 需要带注册、积分、等级和卡密体系的音乐社区或工具站。
• 希望为自己的 Web、小程序、桌面端或移动端提供统一音乐数据接口的团队。
• 需要将多个音源能力放入一个后台统一管理、监控和维护的站长。
• 需要上传和管理自有音频资料，同时保留在线曲库检索入口的内容团队。

最终

青律音乐希望解决的，是自建音乐服务中最容易分散的几件事：前台体验、音源接入、用户运营、接口开放和日常维护。它保留多音源的灵活性，也把能力边界、状态检测、配额控制和数据维护放到可见的位置。

如果你正在寻找一套可以从个人使用逐步扩展到带后台运营和外部 API 的 PHP 音乐系统，青律音乐提供了一套已经串联好的起点。