Spotify Player

🎵 无浏览器Spotify服务器控制方案

无需OAuth回调的Spotify CLI工具,通过浏览器Cookie认证让无图形界面的Linux服务器远程控制Spotify播放,完美解决headless环境的授权难题。

收藏
7.5k
安装
2.5k
版本
1.0.3
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

Spogo 是一款专为无图形界面Linux服务器设计的Spotify命令行控制工具,采用Cookie认证机制绕过传统OAuth流程,无需本地浏览器回调即可完成授权。

安装流程

1. 安装Go 1.21+环境
2. 执行 go install github.com/steipete/spogo/cmd/spogo@latest

3. 配置Cookie认证:从浏览器DevTools提取sp_dcsp_t两个关键Cookie

4. 创建TOML配置文件和JSON格式的Cookie存储文件

主要功能

  • 搜索播放: spogo search track "query" + spogo play spotify:track:ID
  • 播放控制: 暂停、继续、上一首、下一首
  • 设备管理: 列出并切换播放设备
  • 状态查询: JSON格式输出便于脚本集成

关键技术特点

  • Cookie认证: 复制浏览器Cookie即可使用,无需OAuth重定向
  • 无头环境适配: 专为SSH远程服务器、Docker容器等无浏览器环境设计
  • Connect API优先: 无速率限制,优于Web API

显著优点

1. 解决OAuth痛点: 传统Spotify CLI需localhost回调,远程服务器无法完成;Cookie方案彻底绕过此限制
2. 极简部署: 单Go二进制文件,无依赖

3. Premium功能完整: 支持Connect API的全部播放控制

4. JSON输出: 便于自动化脚本和监控系统集成

潜在缺点与局限性

1. Cookie有效期风险: 约1年有效期,用户登出或改密即失效,需手动重新获取
2. 初始设备激活依赖: 若Spotify无活跃会话,需浏览器播放任意曲目后才能切换设备(文档提供浏览器回退方案)

3. Premium门槛: 免费账户无法使用

4. Cookie安全存储: 明文JSON存储敏感Cookie,需确保文件权限正确

5. 区域限制: 需正确配置market参数否则曲目可能不可用

适合人群

  • 远程服务器管理员: 通过SSH管理无图形界面服务器的用户
  • 自动化场景: 需要脚本化控制Spotify的CI/CD或家庭自动化系统
  • Docker/容器用户: 在隔离环境中运行Spotify控制
  • 隐私敏感用户: 不愿在服务器上配置完整浏览器环境

常规风险

  • Cookie泄露: sp_dc为长期有效凭证,若~/.config/spogo/cookies/目录权限不当可能导致账户被盗用
  • 会话劫持: Cookie文件无加密,建议配合LUKS或文件系统加密使用
  • 依赖Spotify Web接口: 非官方API,Spotify可能随时变更Cookie策略或接口

Spotify Player 内容

手动下载zip · 2.3 kB
SKILL.mdtext/markdown
请选择文件