Ubuntu 下使用网易云音乐：ncm-cli 入门
727 字
4 分钟
Ubuntu 下使用网易云音乐：ncm-cli 入门
ncm-cli 是什么
ncm-cli 是网易云音乐的命令行工具，可以在终端中完成歌曲搜索、播放、歌词查看和播放状态管理。对于习惯使用 Ubuntu、远程终端或轻量桌面环境的用户来说，这是一种不依赖图形客户端的使用方式。
本文记录一套基础使用流程，更多安装与配置说明可以参考官方文档。
前置条件
使用前需要准备：
- Node.js 18 或更高版本。
- 网易云音乐开放平台账号，以及用于配置的 API Key（
appId和privateKey）。 - 一台可以运行 npm 的 Ubuntu 或其他 Linux 环境。
如果只想先了解完整的安装要求，可以查看 网易云音乐开放平台。
安装与配置
1. 安装 ncm-cli
先确认 Node.js 版本，然后通过 npm 全局安装：
node --versionnpm install -g @music163/ncm-cli2. 配置 API Key
安装完成后运行配置向导：
ncm-cli configure按照提示填入开放平台提供的 appId 和 privateKey。配置完成后，登录网易云音乐账号：
ncm-cli login如果登录超时，可以重新执行 ncm-cli login。不要把 privateKey、登录信息或命令输出中的敏感内容发布到文章、截图和日志中。
常用命令
下面列出日常使用中最常见的命令：
| 操作 | 命令 |
|---|---|
| 搜索歌曲 | ncm-cli search song --keyword "林俊杰" |
| 播放歌曲 | ncm-cli play --song --encrypted-id <加密 ID> --original-id <原始 ID> |
| 暂停播放 | ncm-cli pause |
| 继续播放 | ncm-cli resume |
| 下一首 | ncm-cli next |
| 上一首 | ncm-cli prev |
| 调节音量 | ncm-cli volume 60 |
| 查看播放状态 | ncm-cli state |
| 查看歌词 | ncm-cli song lyric --id <歌曲 ID> |
音量范围是 0 到 100。搜索结果中的歌曲信息会提供播放所需的 ID，实际能否播放还取决于账号权限和歌曲资源情况。
例如，先搜索歌曲，再根据返回的 ID 播放：
ncm-cli search song --keyword "林俊杰"ncm-cli play --song --encrypted-id <加密 ID> --original-id <原始 ID>使用 TUI 播放器
如果希望在终端中使用交互式界面，可以运行：
ncm-cli tuiTUI 模式更适合持续播放和浏览歌曲；如果只想快速执行某个操作，直接使用上面的命令即可。
常见问题
ncm-cli: command not found
通常是 npm 的全局 bin 目录没有加入 PATH。可以先确认安装是否成功，再检查 npm 全局目录：
npm list -g --depth=0npm prefix -g登录失败或超时
确认 API Key 配置正确后，重新运行：
ncm-cli login如果仍然无法登录，建议对照官方安装配置说明检查账号和开放平台配置。
相关技能包
如果希望让 AI Agent 调用网易云音乐能力，可以进一步了解网易云音乐发布的 Agent Skills 项目。使用前仍然需要先完成 ncm-cli 的安装、配置和登录。
文章分享
如果这篇文章对你有帮助，欢迎分享给更多人！
Ubuntu 下使用网易云音乐：ncm-cli 入门
https://chachaprj.top/posts/2026-10-09/相关文章智能推荐
1
Ubuntu 下使用 nvidia-smi 管理显卡功耗
实用工具在 Ubuntu 上使用 nvidia-smi 查看显卡功耗范围，并通过 nvidia-powerd 设置功耗上限。
2
Ubuntu 下使用 Easy Effects 优化耳机听感
实用工具记录 Ubuntu 下使用 Easy Effects 调整立体声宽度、军鼓亮度，以及贝斯和大鼓低频的过程。
3
Ubuntu 流量监控工具 vnStat：手机热点流量统计与使用教程
实用工具在 Ubuntu 上安装和使用 vnStat，按小时、天和月份统计手机热点的上传与下载流量。
4
200G 流量仍然不够用怎么办？——五元月租校园网的分流方案
实用工具利用 scrcpy 和两台安卓设备，将校园网与移动数据分工使用，缓解移动流量不足的问题。
5
在树莓派 4B 上部署百度网盘 ARM64 图形客户端
实用工具记录将 baidunetdisk-arm64-vnc 部署到树莓派 4B 的完整过程，包括 Docker 安装、ARM64 镜像转运、端口冲突和 NTFS 下载盘兼容性处理。
随机文章随机推荐