核心用法
spogo-linux 是专为无头Linux服务器设计的Spotify命令行控制器,采用Cookie认证替代传统OAuth,解决远程服务器无法接受localhost回调的痛点。
安装与配置
通过Go工具链安装:go install github.com/steipete/spogo/cmd/spogo@latest。核心配置仅需两步:从浏览器开发者工具提取sp_dc和sp_t两个Cookie,写入JSON文件即可完成认证,无需任何服务器端的回调监听。
主要功能
- 播放控制:搜索曲目、播放/暂停、上下曲切换
- 设备管理:列出可用设备并切换播放目标
- 状态查询:获取当前播放状态,支持JSON输出便于脚本集成
- 浏览器回退:当无活跃会话时,可联动浏览器自动化启动播放
显著优点
- 无OAuth依赖:Cookie认证彻底绕过localhost限制,SSH远程服务器即刻可用
- 零守护进程:纯CLI工具,无后台服务,资源占用极低
- Connect API优先:默认使用无速率限制的Spotify Connect API
潜在局限
- Cookie维护成本:有效期约1年,用户登出或改密即失效,需手动重新提取
- Premium强制要求:免费账户无法使用Connect API
- 初始会话依赖:首次使用或长期闲置后,需通过浏览器创建活跃会话
- 功能边界:仅支持播放控制,不包含音乐下载或离线功能
适合人群
Linux服务器管理员、远程开发环境用户、HomeLab爱好者、需要无图形界面音乐控制的自动化场景
常规风险
Cookie文件包含长期有效的认证凭据,需严格设置文件权限(建议600);共享服务器上存储Cookie存在账号泄露风险;sp_dcCookie价值高,应避免意外提交至版本控制