核心用法
ncm-cli-setup 是一个自动化部署脚本,用于安装和配置 ncm-cli——网易云音乐的命令行客户端。该工具支持音乐搜索、播放控制、歌单管理及 TUI 界面操作。
完整安装流程包括四步:
1. 环境准备:通过 npm 全局安装 ncm-cli,并检测/安装 mpv 播放器(跨平台脚本自动识别包管理器)
2. API 配置:在网易云音乐开放平台申请 appId 和 privateKey 并配置
3. 播放器选择:可选轻量跨平台的 mpv 或 macOS 专属的 orpheus(网易云音乐客户端)
4. 账户登录:执行登录命令完成授权
显著优点
- 全平台支持:安装脚本智能识别 macOS/Homebrew、Linux(apt/dnf/pacman)、Windows(winget/Scoop) 等环境
- 灵活部署:服务器环境可跳过播放器安装,保留搜索/歌单管理等核心功能
- 双播放器方案:mpv 轻量通用,orpheus 深度集成官方客户端
潜在局限
- 依赖门槛:需 Node.js >= 18,且 mpv 安装可能因系统权限或网络问题失败
- API 申请繁琐:必须注册网易云开放平台开发者账号,存在审核周期
- 登录稳定性:登录超时问题需手动重试,无自动重连机制
适合人群
- 命令行爱好者、开发者、服务器运维人员
- 追求轻量化音乐播放的 macOS/Linux 用户
- 需要后台音乐服务或自动化歌单管理的场景
常规风险
- npm 全局安装可能引发权限问题,建议使用 nvm 或检查 PATH 配置
- mpv 安装脚本需 Python 3 环境,部分精简系统可能缺失
- API Key 涉及个人账户授权,需妥善保管 privateKey