+9
日增长
7,185
stars
454
forks
19
watchers
114
prs
1,030
issues
73
releases
README
MoeKoe Music
一款开源简洁高颜值的酷狗第三方客户端
🌎 GitHub仓库 |
📦️ 下载安装包 |
💬 访问博客 |
🏠 项目主页
🇨🇳 简体中文 |
🇨🇳 繁体中文 |
🇯🇵 日本語 |
🇺🇸 English |
🇰🇷 한국어 |
🇷🇺 Русский
!images
❤️ 前言
早在10年前后的样子,那会在用网页版QQ的时候我就已经开始使用酷狗音乐了(也是十来年的老粉了),所以这些年收藏的歌曲全部都在上面.后来我也尝试开始使用网易云或QQ音乐,也尝试把酷狗的歌单导入进去,但是效果都不尽人意.我听的大多是日漫OP,好多歌曲都没办法找到.
兜兜转转最后还是回到酷狗,但是在Mac端的酷狗,时常可能会出现不能播放的情况,虽说界面没什么功能,但也挺好的.在网友的安利下,我现在一直是在酷狗的概念版上听歌,并且是市面上为数不多能免费听VIP歌曲的音乐播放软件了,力推.
我在我的个人介绍页面说我特别喜欢听歌,尤其是日漫OP.怎么证明呢?(之前我网页版歌单也年久失修了)那就自己开发一个音乐播放器.
✨ 特性
- ✅ 使用 Vue.js 全家桶开发
- 🔴 酷狗账号登录(扫码/手机/账号登录)
- 📃 支持歌词显示
- 📻 每日推荐歌曲
- 🔕 无任何社交功能
- 🔗 官方服务器直连
- ✔️ 每日自动领取VIP,登录就是VIP
- 🎨 主题色切换
- 👋 启动问候语
- ⚙️ 多平台支持
- 🧩 超级插件系统
- 🧭 布局个性化设置
- 🥚 隐藏功能与彩蛋系统
- 🚀 新手引导系统
- ✨ 更多特性由你来探索
📢 Todo List
- [x] 📺 支持 MV 播放
- [x] 🌚 Light/Dark Mode 自动切换
- [x] 👆 支持 Touch Bar
- [x] 🖥️ 支持 PWA
- [x] ⌨️ 全局快捷键
- [x] 🤟 多语言支持
- [x] 📻 桌面歌词
- [x] ⚙️ 系统架构优化
- [x] 🎶 歌曲、歌单/收藏、取消
查看更新日志
📦️ 安装
1. 客户端安装
访问本项目的 Releases 页面下载安装包。
2. WEB端安装(docker)
注意:部署后请开放服务器对应端口才可使用,或者使用反向代理实现域名访问。
1. 方式一:快速启动(推荐)
git clone --depth=1 https://github.com/MoeKoeMusic/MoeKoeMusic.git
cd MoeKoeMusic
docker compose up -d &
2. ~~方式二:使用docker-compose一键安装 (镜像暂未上传官方)~~
docker run -d --name MoeKoeMusic -p 8080:8080 -e PORT=6521 -e platform=lite iajue/moekoe-music:latest
3. 方式三:宝塔容器编排
远程镜像,版本可能会落后于官方
version: '3.3'
services:
moekoe-music:
镜像地址
image: registry.cn-wulanchabu.aliyuncs.com/youngxj/moekoe-music:latest
container_name: moekoe-music 容器名
restart: unless-stopped 自动重启
build:
context: .
dockerfile: Dockerfile
environment:
- PORT=6521
- platform=lite
ports: 端口映射
- "8080:8080" 前端服务
- "6521:6521" 接口服务
复制内容上面的内容,粘贴到宝塔面板的容器编排里面,编排名称为MoeKoeMusic,点击部署即可。
3. 一键部署
需在环境变量(VITE_APP_API_URL)中填写自己的API地址
⚙️ 开发
1. 克隆本仓库
sh
git clone --depth=1 https://github.com/MoeKoeMusic/MoeKoeMusic.git
2. 进入目录并安装依赖
sh
cd MoeKoeMusic
pnpm install --frozen-lockfile
3. 启动开发者模式
- 在浏览器里开发
sh
pnpm run dev
- 在客户端开发模式下开发
sh
pnpm run dev:client
4. 构建前端
为你的目标平台选择一条命令来构建前端
sh
pnpm run build 为网页端或客户端构建前端
pnpm run build:docker 为 Docker 镜像构建前端
5. 编译项目
- Windows:
sh
pnpm run electron:build:win [默认 NSIS 安装包]
- Linux:
sh
pnpm run electron:build:linux [默认 AppImage 格式]
- macOS:
sh
pnpm run electron:build:macos [默认 macOS 双架构]
更多命令请查看 package.json 文件 scripts
👷♂️ 编译客户端
如果在 Release 页面没有找到适合你的设备的安装包的话,你可以根据下面的步骤来打包自己的客户端。
1. 安装 Node.js,并确保 Node.js 版本 = 24。
2. 使用 git clone --depth=1 https://github.com/MoeKoeMusic/MoeKoeMusic.git 克隆本仓库到本地。
3. 使用 pnpm install --frozen-lockfile 安装项目依赖。
4. Top issues
#1176[新需求]: MINI播放器模式4 comments · 2026-09-20#1166[新需求]: 有定时关闭功能吗3 comments · 2026-09-14#1246electron-builder 依赖项 minimatch 中危漏洞 CVE-2026-1187642 comments · 2026-11-06#1241没有原版的“猜你喜欢”电台功能1 comments · 2026-10-31
Discussions
#1264听音识曲无法使用系统音频是怎么回事?0 comments · 2026-11-15#1263组队专贴1 comments · 2026-11-15#1262能不能加个最近听的功能,每日推荐听过的歌切了歌单之后找不到了0 comments · 2026-11-14#1250无法安装v1.7.21 comments · 2026-11-06#1249可不可以增加一个歌曲播完之后节奏融合功能,类似EchoMusic那个0 comments · 2026-11-06#1244组队转帖,来吧!1 comments · 2026-11-02#1243"暂无歌词"1 comments · 2026-11-01#1240关于我只是做了个功能被广告盯上这件事2 comments · 2026-10-30
Latest release
Release v1.7.2 Hotfix 2 v1.7.2 2026-11-08[!IMPORTANT] 该版本修改了部分插件接口 部分插件可能无法正常使用 如果你介意请等待插件开发者适配后再更新到该版本 [!TIP] 如果你是插件开发者可以参阅插件迁移文档 What's Changed feat: realize report and sync listen time by @LateDreamXD in https://github.com/MoeKoeMusic/MoeKoeMusic/pull/1206 feat: 实现 macOS 关闭窗口后隐藏 Dock 图标 by @No-World in https://github.com/MoeKoeMusic/MoeKoeMusic/pull/1213 feat(api): built api into electron client by @LateDreamXD in https://github.com/MoeKoeMusic/MoeKoeMusic/pull/1217 feat(electron/extensions): add apiMode permission to start api service automatically for extensions needs by @LateDreamXD in https://gi