MoeKoe Music是一款现代化的酷狗音乐第三方客户端,支持Windows、macOS和Linux多平台,具有简洁美观的界面设计、Hi-Fi音质支持和每日自动领取VIP功能。本文详细介绍MoeKoe Music的主要特性、安装使用方法、开发部署指南以及常见问题解决方案。

关于歌曲下载方式在文章底部
值得珍藏下载无损音乐地址(每日更新):https://zhzyk.vip/category/music/
MoeKoe Music简介
MoeKoe Music是一款开源、简洁、高颜值的跨平台音乐播放器,支持酷狗账号登录,提供歌词显示、每日推荐歌曲、主题色切换等实用功能。其最大亮点是每日自动领取VIP特权,让用户无需付费即可享受高品质音乐体验。
要想正常听歌一定要登录酷狗账号、一定要登录酷狗账号、一定要登录酷狗账号(重要的事情说三遍!!!)
🐛fix: 修复单行歌词动画不生效
🚀 feat: 歌词字体设置功能,支持全屏歌词
🎨 style: 调整样式
🚀 feat: 添加返回顶部组件并移除旧的返回顶部按钮
🚀 feat: 添加自定义页面滚动条组件,接管系统
🎨 style: 重构推荐搜索界面样式
🐛fix: 修复歌曲当前播放定位问题
🚀 feat: 优化麦克风设备选择器
🚀 feat: 添加各歌单骨架加载效果
🎨 style: 添加歌词容器渐变效果和动态缩放动画
🚀feat: 更新云盘歌曲列表显示逻辑
🚀refactor: 重构播放列表相关逻辑,优化分页和数据加载处理
🚀feat: 更改在线更新安装为静默安装模式
{/collapse-item}
{collapse-item label="V1.6.7"}
🚀perf: 优化声明组件,支持动态加载用户协议内容
🚀perf: 调整骨架屏组件
📝 docs: 新增更新日志链接
🚀perf: 美化更新日志展示效果,支持跳转查看
✨ feat: 添加独立桌面歌词字体设置 closes #1050
🐛fix: 修复 PWA 可用性设置; 调整设置页面样式
✨ feat: 优化右键菜单位置调整逻辑
✨ feat: 添加歌词窗口的拖动和调整大小功能,优化整体交互体验
🚀perf: 风险验证模块
✨ feat: 添加风险验证模块,集成安全验证逻辑
✨ feat: 添加背景图和装饰元素到识别页面,优化视觉效果
🐛fix: 修复用户性别
✨ feat: 添加听歌识曲功能
🔄 update: 更新API V.5.1
🎨 style: 更新多个视图和布局以支持粘性头部
🎨 style: 调整歌单描述样式
🐛 fix: 修复 watch 后台路由监听
🎨 style: 调整登录页面样式
🐛fix: 修复搜索页面监听缓存冲突问题
fix: 修复暗黑模式下的样式问题
feat: 优化原生右键菜单分组
🐛 fix: 修复侧边栏在暗黑模式下的样式
✨ feat: 增强虚表滚动性能,优化列表显示和缓冲逻辑
🐛 fix: 修复弹窗层级问题
🚀perf: 优化滚动位置恢复逻辑,优化页面体验
✨ feat: 优化路由缓存和动画效果,提升页面切换体验
✨ feat: 增强路由视图动画效果,优化页面切换体验
🚀perf: 优化设置卡片开关体验
{/collapse-item}
{collapse-item label="v1.6.5"}
发布于 2026年6月5日
What's Changed
- 🔖 release: 83周 V1.6.5 版本发布
- ✨ feat: 添加新手引导功能,支持用户引导和操作提示
- 🚀fix: 优化配置选项
- ✨ feat: 添加对Web平台应用版本显示
- 🚀fix: 优化SongQueue.js
- ✨ feat: 增强本地音乐支持
- ✨ feat: 添加文件夹历史记录功能,支持快速切换和删除历史记录
- ✨ feat: 添加播放模式切换菜单
- feat: 增加顺序播放模式 (#1003)
- 🐛 fix: 部分歌曲的歌词存在base64解码失败 closes #1001
- 🚀fix: 优化页面切换样式
- 🚀fix: 优化歌单专辑时间显示
- 🐛 fix: 移除主窗口加载 Chrome 扩展的 DOM 准备事件监听器
- 🚀fix: 优化桌面歌词设置持久化功能
- ✨ feat: 添加自定义托盘菜单服务
{/collapse-item} - 🐛 fix: 修复部分歌曲重试失败 Closes #948
- 🐛 fix: 修正启动页面设置导致白屏 Closes #945 Closes #949 Closes #950
- 🚀fix: 使用环境变量的 PowerShell 路径
- 🔖 release: V1.6.2 🤐猜猜我偷偷更新了什么
- ✨ feat: 更新logo图标文件
- fix(settings): let meta key and numpad keys can be set to shortcut (#937)
- 🚀 feat: 增强无版权收藏歌曲播放(#927)
- ✨feat: 增加搜索页面原唱标志 Closes #934
- 🚀 feat: 强化插件窗口验证
- ci(*): avoid to use deprecated keywords and actions (#931)
- 🔧 chore: 更新依赖样式至本地 (Closes #933)
- 💄 ui: 更新主题颜色和样式以提升用户界面一致性
- 🚀 feat: 优化"我的喜欢"显示 (#576)
- ✨feat: 添加启动页设置选项以增强用户体验
- ⬆️ upgrade: 升级 API服务 V1.5.1
- refactor(styles): replace css to scss style sheet (#922)
- 🐛 fix: 优化歌词获取逻辑,避免重复请求并处理过期请求 Closes #917
📝 docs: 添加徽章以增强 README 文件的可视化效果
{/collapse-item}What's Changed
- 🔖 release: 周期性更新,非必要无需更新
- 🐛 fix: 修复分享可能出现的异常
- 🐛 fix: 修复事件处理函数参数,增加事件对象解构
- 🚀 feat: 优化歌曲信息展示和样式
- 🚀 feat: 优化播放逻辑 Closes #902
- 🔥 remove: 删除无用代码
- 🚀 feat: 增强插件能力
{/collapse-item}
{collapse-item label="v1.5.9"}
建议:登陆后/音乐库/vip签到,手动点一下vip签到
发布于 2026年2月6日 - 🐛 fix 🔖 release: 修复VIP领取失败
- 任务:更新子模块 API
Linux: 跟进ARM64编译支持
What's Changed
- Linux: 跟进ARM64编译支持 by @LFRon in
{/collapse-item} - 💥 breaking: 重构目录结构
- 🐛 fix: 修复掉登录问题
- ⬆️ upgrade: 升级 API服务 V1.5.0
- ✨feat: 添加 RPC 基础 URL 管理功能,支持自定义设置与测试连接
- 🐛 fix: 优化设备信息管理,修复 dfid 获取逻辑
- feat: 🎸 macOS 状态栏歌词跑马灯支持与构建策略优化 (#823)
- 🚀 perf: 优化插件系统
- 🐛 fix: 移除播放兼容模式,Closes #817
- 🚀 perf: 升级新的VIP接口 Closes #816, #820
- 🐛 fix: 修复MV无法播放,Closes #804
- ✨ feat: 添加音频输出设备选择功能
✨ feat: 添加音频输出设备变化监听与麦克风权限请求功能
{/collapse-item}
{collapse-item label="v1.5.7"}修复风控问题 (已知问题:会强制退出登录)
fix: open mv window for electron
修复:打开 Electron 的 mv 窗口
Squashed commit of the following:
已取消以下提交:
⬆️ upgrade: 升级 API服务谨慎升级 v1.5.3 ,会导致 获取音乐失败
What's Changed
🔖 release: 发布v1.5.4(发布于 2025年12月6日)
- upgrade: 升级Dockerfile node版本 (#714)
- 🔥 remove: 移除不完全的HTTPS支持(ps:该更新可能引发安全问题)
- ✨ feat: 使用authorization认证
- ✨ feat: 增加数据源配置
- 🐛 fix: 修复登录后播放失败问题 ,Closes #708
- 修复ARM64架构下Linux无法编译API而引发应用编译失败 by @LFRon in #711
- upgrade: 升级Dockerfile node版本 by @BIGMONK in #714
{/collapse-item} - ✨ feat: 支持调整桌面歌词窗口大小&新增一个Bug
- 🚀 perf: 桌面长歌词滚动效果 Closes #335
- 🐛 fix: 修复无歌词时不更新问题,Closes #624
- 🚀 perf: 优化添加到列表 Closes #643
- 🚀 perf: 优化界面激活逻辑 Closes #611
- 🚀 perf: 歌单跳转当前播放歌曲按钮优化 Closes #605
- ✨ feat: 添加一键播放 Closes #604
- 🐛 fix: 兼容自定义背景插件,Closes #626
- ✨ feat: 添加帮助链接功能
- 🗑️ cleanup: 移除示例插件
- 📈 analytics: 添加issue验证 (#586)
- 📈 analytics: 增加issue验证条件,移除 PULL_REQUEST_TEMPLATE.md 填充 (#581)
- ✨ feat: 新增SMTC协议时间轴信息支持 Closes #554
- ✨ feat: 新增榜单歌曲支持动态无限加载,Closes #521
- ✨ feat: 新增支持多账号绑定手机登录,Closes #19
{/collapse-item}
{collapse-item label="v1.5.1"} - 📝docs: 更新自述文件图片 🔖 release:
- 🐛 fix: 修复linux下托盘图标格式错误
- ✨ feat: 新增插件系统
- ✨ feat: 新增多网络架构概念(Multi-network Architecture)
- 🚀 perf: 若桌面歌词超出屏幕重启将被重置
- 🚀 perf: 优化设置界面,使其更加易用
- 🚀 perf: 增加歌单上限至500个
- 🚀 perf: 优化托盘图标显示
- 🚀 perf: 优化Mac托盘图标,优化歌词乱码问题
- 🐛 fix: 修复无歌词重复请求导致错误
- ✨ feat: [Beta]新增支持播放本地音乐
- 📝docs: General PR Template
- 📝docs: 添加问题模板的检查项和说明
{/collapse-item}
What's Changed
- ci: 添加 Docker 和 Docker Compose 配置以支持容器化部署
- docs: 在README.md中添加本地docker编译方式
- feat(PWA): 添加PWA支持以提升应用体验
- refactor: 优化Docker配置和README文档
- 添加Touchbar控制及歌词显示
{/collapse-item}
客户端安装软件下载

主要特性
- 现代化界面设计:简约而不简单的UI设计,提供流畅的用户体验
- Hi-Fi音质支持:支持高品质音频播放,享受极致音乐体验
- 主题切换功能:支持浅色/深色主题,并提供多种主题色彩选择
- 跨平台兼容性:完美运行于Windows、macOS和Linux系统
- 每日推荐歌曲:智能推荐算法,发现更多好音乐
- 无社交干扰:专注于音乐本身,无任何社交功能
- 官方服务器直连:直接连接酷狗官方服务器,无第三方API
- 自动领取VIP:每日自动领取VIP特权,登录即享VIP
- 启动问候语:个性化启动问候,增添使用乐趣
- 歌词显示功能:实时显示歌词,享受K歌体验
安装与使用
下载安装
- 访问下载页面获取最新版本
- 根据操作系统选择对应的安装包
- 下载并安装应用程序

账号登录
首次启动时,建议登录酷狗账号以获得完整音乐体验:
- 点击左侧菜单中的"登录"按钮
- 使用酷狗账号密码或扫码登录
- 登录成功后即可同步歌单和收藏
基本操作
- 搜索音乐:在顶部搜索栏输入关键词
- 播放控制:使用底部播放控制栏控制音乐播放
- 查看歌词:点击播放界面中的歌词图标
- 切换主题:在设置中调整界面主题
- 创建歌单:在"我的音乐"中创建和管理歌单

开发与部署
技术栈
- 前端框架: Vue 3
- 构建工具: Vite
- 桌面框架: Electron
- 编程语言: JavaScript
- 状态管理: Pinia
- UI组件库: Element Plus
环境准备
- Node.js (推荐v18.x或更高版本)
- npm (通常随Node.js一起安装)
- Git
获取源码
git clone https://github.com/iAJue/MoeKoeMusic.git
cd MoeKoeMusic
npm install本地开发
npm run dev构建应用
# 构建所有平台版本
npm run build
# 仅构建Windows版本
npm run build:win
# 仅构建macOS版本
npm run build:mac
# 仅构建Linux版本
npm run build:linux常见问题解决
macOS"应用已损坏"提示
在 macOS 系统上,当您下载并尝试打开 MoeKoe Music 时,可能会遇到系统提示应用"已损坏"或"无法打开"的问题。这通常是由于 macOS 的安全机制(Gatekeeper)阻止了未经苹果官方认证的应用运行所导致的。
方法一:使用终端清除隔离属性(推荐):
清除应用扩展属性,在终端输入:
xattr -cr /Applications/MoeKoeMusic.app注意:如果你把 MoeKoe Music 拖到了“应用程序”文件夹以外的位置,或者应用的名字不完全一样,需要把 /Applications/MoeKoeMusic.app 换成你电脑上对应的正确路径。 如果软件名不一样,请把 MoeKoeMusic.app 换成它准确的名字
用双引号 " " 包住路径(推荐,最不容易出错代码如下)
xattr -cr "/Applications/MoeKoe Music.app"📌 快捷技巧:不用手打路径
在终端输入(注意最后有个空格):
xattr -cr 打开“访达” → “应用程序”文件夹 ( 也可以在屏幕顶部的"访达"菜单栏里,找到并点击"前往",然后选择"应用程序"这时,会打开一个新的"应用程序"文件夹窗口。用鼠标按住这个app应用图标,将它从磁盘窗口拖拽到终端窗口里,松开鼠标即可。 )
把 MoeKoe Music 的图标直接拖进终端窗口
终端会自动补全带正确转义的完整路径
按下回车即可
执行成功后不会有任何输出信息,但再次双击应用就能正常打开了。
如果执行后还是提示找不到文件,可能是应用名字不完全匹配,可以在终端输入:'ls /Applications/ | grep MoeKoe'
查看一下确切的名字,再按上面的格式处理。
第二种解决方法:
临时禁用Gatekeeper(仅测试用),在终端输入以下命令并按回车(系统会提示你输入管理员密码):
sudo spctl --master-disable注意:输入密码时,屏幕上不会有任何显示,这是正常的,直接输入完按回车即可。
点击屏幕左上角的苹果图标 -> 系统设置 -> 隐私与安全性。
在这个页面的中间部分,往下滑,找到 “安全性” 这一栏。 允许一下来源应用程序里选择:任何来源。
操作完成后,务必立即重新打开安全设置,在终端中执行:
sudo spctl --master-enable系统设置 -> 隐私与安全性。
在这个页面的中间部分,往下滑,找到 “安全性” 这一栏。 允许一下来源应用程序里选择:任何来源,改回需要的安全设置
自动领取VIP问题
- 确保使用最新版本MoeKoe Music
- 尝试退出后重新登录
- 清除应用缓存后再次尝试
- 如问题持续,可能是官方政策限制
VIP歌曲播放问题
- 确认账号VIP权益是否有效
- 重新启动应用并重新登录
- 对于确实无法播放的VIP歌曲,可能需要使用官方应用
Windows7不兼容问题
MoeKoe Music已不再支持Windows7系统,建议升级到Windows10或更高版本。
更新-内附苹果手机安装包,请不要升级,理论上每日签到可实现"永久VIP"

苹果手机客户端领取方法:
在右下角,我的>福利活动中心>天天签到领VIP
如果播放失败,请更新到最新版。