YesPlayMusic

qier222MIT活跃维护

基于 Electron 和 Vue 的第三方网易云音乐播放器,界面精致,支持 Windows、macOS、Linux 以及 PWA,让你在桌面端也能获得流畅的在线听歌体验。

高颜值的第三方网易云播放器,支持 Windows / macOS / Linux :electron:

v0.4.11发布于 2026-10-10 11:14 UTC33,616star +19 / 7 天4,674fork同步于 2026-11-10 23:23 UTC

怎么上手

由 README 提炼,执行前请确认
brew install --cask yesplaymusic
硬件要求按 README 说明

README 未说明硬件要求;支持 Windows、macOS、Linux 桌面平台,另有网页版可部署到 Vercel 或自有服务器

有 Docker 镜像
下载:源码 zip·GitHub Releases(安装包)本站不镜像安装包

项目说明

由 README 自动翻译提炼

高颜值第三方网易云音乐播放器,跨平台桌面客户端,无社交功能

基于 Electron 和 Vue 的第三方网易云音乐播放器,界面精致,支持 Windows、macOS、Linux 以及 PWA,让你在桌面端也能获得流畅的在线听歌体验。

核心能力

  • 用 Vue.js 全家桶开发的 Electron 桌面客户端
  • 支持扫码、手机、邮箱登录网易云账号
  • 集成 UnblockNeteaseMusic 自动替换变灰歌曲链接
  • 支持 MV 播放、歌词显示、私人 FM 与每日推荐
  • 支持 PWA 安装、Last.fm Scrobble 与音乐云盘

容易踩的坑

网页版不支持 UnblockNeteaseMusic 替换变灰歌曲;YouTube 音源需自行安装 yt-dlp;自建部署需先单独部署 NeteaseCloudMusicApi 并配置 VUE_APP_NETEASE_API_URL

内容由模型根据 README 生成,可能不完整或不准确,以官方文档为准。看原文 README

最近发版

5 个版本v0.4.11
  1. v0.4.110.4.11最新正式版2026-10-10 · 2026-10-10 11:14 UTC

    更新日志

    ✨ 新特性

    • Touch Bar 歌词:在配备 Touch Bar 的 MacBook 上,播放时 Touch Bar 中间会实时显示当前歌词(原有的前进 / 后退、搜索和播放列表按钮已移除,以留出显示空间),感谢 @KawakazeNotFound(#2407)
    • 主题颜色:设置页新增「主题颜色」选项,除原始颜色外,还提供日落、海洋、森林三种渐变配色,感谢 @wuzhi456(#2461)
    • 托盘图标颜色:设置页新增「托盘图标颜色」选项,可选择自动、浅色或深色,让托盘图标在不同系统主题和任务栏背景下都清晰可见,感谢 @657kbps(#2414)
    • 云盘歌曲内嵌歌词:播放未与网易云曲库关联的云盘歌曲时,会显示上传音频文件中内嵌的歌词,感谢 @Cinvin(#2419)
    • 每日推荐一键播放:每日推荐页面新增「播放」按钮,可直接播放全部推荐歌曲,感谢 @Utopia-V(#2482)

    🐛 修复

    • 修复听歌记录无法同步到网易云音乐的问题:网易云已不再统计旧接口上报的播放记录,现改为与官方客户端相同的上报方式,「最近播放」与「听歌排行」恢复正常更新;同时修复一首歌自然播放结束时被重复上报、以及未实际播放的歌曲也被上报的问题,感谢 @LucasYanzy(#2485)
    • 修复歌曲缓存上限不生效、缓存会无限增长的问题,感谢 @fatelove42(#2430)
    • 修复歌词页最后几行歌词无法滚动到页面中间的问题,感谢 @LucasYanzy(#2487)
    • 修复在歌词页进入全屏后离开歌词页,窗口会卡在全屏状态、只能按 F11 退出的问题,感谢 @xianshi3(#2483)
    • 修复歌词时间戳中的毫秒部分解析错误,导致部分歌词与歌曲不同步的问题,感谢 @HomeArchbishop(#2441)
    • 修复在播放栏上拖动进度条或音量条时,松开鼠标会误打开歌词页的问题,感谢 @12471220(#2444)
    • 修复深色主题下托盘菜单图标对比度不足、看不清的问题,感谢 @Utopia-V(#2481)
    • Linux:修复 D-Bus 断开连接后 MPRIS 更新导致应用崩溃的问题,感谢 @FSpark 和 @GyrumAscend(#2457、#2480)
    • 网页版:修复部署到 Netlify 后直接访问子页面出现 404 的问题,感谢 @LittleChest(#2467)

    🔧 其他

    • 设置页「缓存」标题补上多语言翻译,感谢 @yottanami(#2488)
    • 开发环境迁移至 Nix,并修复在本地打包 Linux 安装包(deb / rpm 等)时的工具链问题

    感谢本版本的所有贡献者,其中 12 位是首次参与贡献!

    完整变更:https://github.com/qier222/YesPlayMusic/compare/v0.4.10...v0.4.11

  2. v0.4.100.4.102025-10-09 · 2025-10-09 08:39 UTC
    查看更新说明

    What's Changed

    New Contributors

    Full Changelog: https://github.com/qier222/YesPlayMusic/compare/v0.4.9...v0.4.10

  3. v0.4.92024-11-08 · 2024-11-08 11:55 UTC
    查看更新说明

    What's Changed

    New Contributors

    Full Changelog: https://github.com/qier222/YesPlayMusic/compare/v0.4.8...v0.4.9

  4. v0.4.8-22024-03-05 · 2024-03-05 12:52 UTC
    查看更新说明

    This release aims to resolve the blank screen problem when logging in.

    What's Changed

    Full Changelog: https://github.com/qier222/YesPlayMusic/compare/v0.4.8-1...v0.4.8-2

  5. v0.4.8-12024-03-04 · 2024-03-04 16:31 UTC
    查看更新说明

    Correct the build process (thanks to @DaiQiangReal) and bump the version number in package.json.

    What's Changed

    New Contributors

    Full Changelog: https://github.com/qier222/YesPlayMusic/compare/v0.4.8...v0.4.8-1

用户点评

登录用户的真实使用记录,可按版本和硬件筛选
共 0 条

    还没有人点评。第一个说出真实体验的人最有价值。

    README 原文

    未翻译

    Library

    全新版本

    全新 2.0 Alpha 测试版已发布,欢迎前往 Releases 页面下载。 当前版本将会进入维护模式,除重大 bug 修复外,不会再更新新功能。

    ✨ 特性

    • ✅ 使用 Vue.js 全家桶开发
    • 🔴 网易云账号登录(扫码/手机/邮箱登录)
    • 📺 支持 MV 播放
    • 📃 支持歌词显示
    • 📻 支持私人 FM / 每日推荐歌曲
    • 🚫🤝 无任何社交功能
    • 🌎️ 海外用户可直接播放(需要登录网易云账号)
    • 🔐 支持 UnblockNeteaseMusic,自动使用各类音源替换变灰歌曲链接 (网页版不支持)
      • 「各类音源」指默认启用的音源。
      • YouTube 音源需自行安装 yt-dlp。
    • ✔️ 每日自动签到(手机端和电脑端同时签到)
    • 🌚 Light/Dark Mode 自动切换
    • 👆 支持 Touch Bar 歌词显示 Library
    • 🖥️ 支持 PWA,可在 Chrome/Edge 里点击地址栏右边的 ➕ 安装到电脑
    • 🟥 支持 Last.fm Scrobble
    • ☁️ 支持音乐云盘
    • ⌨️ 自定义快捷键和全局快捷键
    • 🎧 支持 Mpris
    • 🛠 更多特性开发中

    📦️ 安装

    Electron 版本由 @hawtim 和 @qier222 适配并维护,支持 macOS、Windows、Linux。

    访问本项目的 Releases 页面下载安装包。

    • macOS 用户可以通过 Homebrew 来安装:brew install --cask yesplaymusic

    • Windows 用户可以通过 Scoop 来安装:scoop install extras/yesplaymusic

    同类项目(排名无先后)

    欢迎大家通过 PR 分享你的项目,让更多人看到!

    ⚙️ 部署至 Vercel

    除了下载安装包使用,你还可以将本项目部署到 Vercel 或你的服务器上。下面是部署到 Vercel 的方法。

    本项目的 Demo (https://music.qier222.com) 就是部署在 Vercel 上的网站。

    Powered by Vercel

    1. 部署网易云 API,详情参见 Binaryify/NeteaseCloudMusicApi 。你也可以将 API 部署到 Vercel。

    2. 点击本仓库右上角的 Fork,复制本仓库到你的 GitHub 账号。

    3. 点击仓库的 Add File,选择 Create new file,输入 vercel.json,将下面的内容复制粘贴到文件中,并将 https://your-netease-api.example.com 替换为你刚刚部署的网易云 API 地址:

    {
      "rewrites": [
        {
          "source": "/api/:match*",
          "destination": "https://your-netease-api.example.com/:match*"
        }
      ]
    }
    
    1. 打开 Vercel.com,使用 GitHub 登录。

    2. 点击 Import Git Repository 并选择你刚刚复制的仓库并点击 Import。

    3. 点击 PERSONAL ACCOUNT 旁边的 Select。

    4. 点击 Environment Variables,填写 Name 为 VUE_APP_NETEASE_API_URL,Value 为 /api,点击 Add。最后点击底部的 Deploy 就可以部署到 Vercel 了。

    ⚙️ 部署到自己的服务器

    除了部署到 Vercel,你还可以部署到自己的服务器上

    1. 部署网易云 API,详情参见 Binaryify/NeteaseCloudMusicApi
    2. 克隆本仓库
    git clone --recursive https://github.com/qier222/YesPlayMusic.git
    
    1. 安装依赖
    yarn install
    
    
    1. (可选)使用 Nginx 反向代理 API,将 API 路径映射为 /api,如果 API 和网页不在同一个域名下的话(跨域),会有一些 bug。

    2. 复制 /.env.example 文件为 /.env,修改里面 VUE_APP_NETEASE_API_URL 的值为网易云 API 地址。本地开发的话可以填写 API 地址为 http://localhost:3000,YesPlayMusic 地址为 http://localhost:8080。如果你使用了反向代理 API,可以填写 API 地址为 /api。

    VUE_APP_NETEASE_API_URL=http://localhost:3000
    
    1. 编译打包
    yarn run build
    
    1. 将 /dist 目录下的文件上传到你的 Web 服务器

    ⚙️ 宝塔面板 docker 应用商店 部署

    1. 安装宝塔面板,前往宝塔面板官网 ,选择正式版的脚本下载安装。

    2. 安装后登录宝塔面板,在左侧导航栏中点击 Docker,首次进入会提示安装 Docker 服务,点击立即安装,按提示完成安装

    3. 安装完成后在应用商店中找到 YesPlayMusic,点击安装,配置域名、端口等基本信息即可完成安装。

    4. 安装后在浏览器输入上一步骤设置的域名即可访问。

    ⚙️ Docker 部署

    1. 构建 Docker Image
    docker build -t yesplaymusic .
    
    1. 启动 Docker Container
    docker run -d --name YesPlayMusic -p 80:80 yesplaymusic
    
    1. Docker Compose 启动
    docker-compose up -d
    

    YesPlayMusic 地址为 http://localhost

    ⚙️ 部署至 Replit

    1. 新建 Repl,选择 Bash 模板

    2. 在 Replit shell 中运行以下命令

    bash <(curl -s -L https://raw.githubusercontent.com/qier222/YesPlayMusic/main/install-replit.sh)
    
    1. 首次运行成功后,只需点击绿色按钮 Run 即可再次运行

    2. 由于 replit 个人版限制内存为 1G(教育版为 3G),构建过程中可能会失败,请再次运行上述命令或运行以下命令:

    cd /home/runner/${REPL_SLUG}/music && yarn install && yarn run build
    

    👷‍♂️ 打包客户端

    如果在 Release 页面没有找到适合你的设备的安装包的话,你可以根据下面的步骤来打包自己的客户端。

    1. 打包 Electron 需要用到 Node.js 和 Yarn。可前往 Node.js 官网 下载安装包。安装 Node.js 后可在终端里执行 npm install -g yarn 来安装 Yarn。

    2. 使用 git clone --recursive https://github.com/qier222/YesPlayMusic.git 克隆本仓库到本地。

    3. 使用 yarn install 安装项目依赖。

    4. 复制 /.env.example 文件为 /.env 。

    5. 选择下列表格的命令来打包适合的你的安装包,打包出来的文件在 /dist_electron 目录下。了解更多信息可访问 electron-builder 文档

    命令说明
    yarn electron:build --windows nsis:ia32Windows 32 位
    yarn electron:build --windows nsis:arm64Windows ARM
    yarn electron:build --linux deb:armv7lDebian armv7l(树莓派等)
    yarn electron:build --macos dir:arm64macOS ARM

    :computer: 配置开发环境

    本项目由 NeteaseCloudMusicApi 提供 API。

    运行本项目

    # 安装依赖
    yarn install
    
    # 创建本地环境变量
    cp .env.example .env
    
    # 运行(网页端)
    yarn serve
    
    # 运行(electron)
    yarn electron:serve
    

    本地运行 NeteaseCloudMusicApi,或者将 API 部署至 Vercel

    # 运行 API (默认 3000 端口)
    yarn netease_api:run
    

    ☑️ Todo

    查看 Todo 请访问本项目的 Projects

    欢迎提 Issue 和 Pull request。

    📜 开源许可

    本项目仅供个人学习研究使用,禁止用于商业及非法用途。

    基于 MIT license 许可进行开源。

    灵感来源

    API 源代码来自 Binaryify/NeteaseCloudMusicApi

    🖼️ 截图

    lyrics library-dark album ![home-2][home-2-screens hot] artist search home explore