音乐解析插件

社区搜索弹窗支持「音乐」模式：检索网易云 / 酷我，试听后一键收录；自动下载多音质音频、上传网盘并发帖，站内已有同曲帖子则直接跳转。

功能简介

依赖插件： 社区、网盘资源；按需安装夸克网盘、光鸭网盘（及百度 Cookie）。

安装与启用

1. 将本插件放入 plugins/musicparse/，在后台安装并启用。
2. 确认已安装并启用：社区、网盘资源；需要上传时再配置夸克 / 光鸭（或百度）。
3. 打开本插件配置，按下方「必配项」填完后保存。

后台配置说明

必配项

1. 启用音乐解析  

  打开后，前台搜索弹窗才出现音乐相关能力。

1. 自动发帖版块  

  勾选解析成功后发帖所在版块（建议只选一个；多选取第一个）。建议选「音乐」类型版块。

1. 音源代理（香港 / 海外必填）  

  服务器在香港或海外时，网易 / 酷我常按 IP 不给直链。请填大陆出口的 HTTP / SOCKS5 代理，例如：

  ```text

  http://43.x.x.x:7890

  socks5://43.x.x.x:1080

  ```

  - 不要填 127.0.0.1（除非代理就跑在本机且出口是大陆）。

  - 不要填站点自己的端口（如 8081）。

  - 解析请求与音频下载都会走该代理。

建议配置（提高成功率）

1. 网易云 Cookie  

  登录 music.163.com 后复制整段 Cookie，至少含 MUSICU；有 __csrf、NMTID 更好。会员账号有助于 320 / 无损。  

  不要把网易 Cookie 填到酷我栏。

1. 酷我 Cookie  

  登录 www.kuwo.cn 后复制整段，常见含 userid、sid、websid、HmIuvt_…。

1. 网盘上传  

  - 夸克 / 光鸭：在对应插件完成登录；本插件打开「上传夸克 / 光鸭」即可（不强制打开对方的「启用」开关）。  

  - 百度：打开「上传百度网盘」并填写 Cookie / BDUSS。

其它项

前台使用方法

1. 打开站点搜索（或带音乐模式的搜索弹窗）。
2. 输入歌名 / 歌手，在结果中查看网易云、酷我条目。
3. 试听：点击播放；走站点同源地址，由服务器经代理拉取音频。
4. 收录：

  - 站内已有对应帖子 → 进入详情。

  - 未收录 → 登录后点击解析；任务入队后台处理。

1. 成功后会自动发帖，正文含播放卡片与歌词，下方网盘资源提供下载链接；可通过站内消息获知结果。

香港服务器代理示例

在大陆 VPS上启动代理（示例 gost）：

nohup /root/gost -L=http://:7890 >/root/gost.log 2>&1 &

防火墙 / 安全组放行 7890，来源建议仅允许香港站点公网 IP。

香港机验证：

curl -x http://大陆IP:7890 -I https://music.163.com

通了之后，在本插件「音源代理」填写：

http://大陆IP:7890

保存后再试听 / 收录。代理进程建议做成开机自启，避免重启后失效。

常见问题

试听 / 收录提示「接口未返回音频直链」  

• 香港机未配或代理已挂；先测 curl -x。  
• Cookie 过期或填错栏目（MUSIC_U 误填酷我）。  
• 强版权曲 / 仅 APP 可播：可能无网页直链，可换同名另一音源或其它曲目。

只能播大约 30 秒  

该曲对当前账号只有试听权限。插件会优先完整曲并尝试换源；仍只有试听时才会用短片段兜底。

能试听但收录失败  

收录默认要更高音质（如 FLAC/320）并上传网盘。检查网盘登录、音质配置，以及是否被版权限制为不可下载。

/musicparse/play-url 打不开音频  

该地址返回 JSON，不是播放文件。试听请用：

/musicparse/play?source=netease&id=歌曲ID

或页面内播放按钮。

任务一直排队  

单进程 php -S 可能堵死。生产环境用 PHP-FPM；必要时配置 cron_key 用定时访问 /musicparse/cron 清积压。

相关接口（供排查）

使用注意

• 请仅使用自有账号 Cookie，遵守网易云、酷我及当地法律法规；勿用于未授权传播。
• Cookie、代理地址属于敏感配置，勿泄露到公开场合。
• 版权曲、会员曲、仅 APP 曲无法保证 100% 可解析；代理与有效会员 Cookie 可明显提高成功率。