Spotify Player

核心用法

Spogo 是专为无头 Linux 服务器设计的 Spotify 命令行控制工具，通过浏览器 Cookie 认证绕过 OAuth 本地回调限制。用户从浏览器 DevTools 提取 sp_dc 和 sp_t 两个 Cookie，写入 JSON 文件即可完成认证，无需 GUI 或本地浏览器。

主要功能

• 搜索播放：spogo search track 查找曲目，spogo play 控制播放/暂停/切歌
• 设备管理：spogo device list/set 切换播放设备（需 Premium）
• 状态查询：JSON 格式输出便于脚本集成

显著优点

1. 零OAuth依赖：Cookie 认证彻底解决远程服务器无法接收回调的问题
2. 原生 CLI 设计：Go 编写，单二进制文件，依赖极少
3. 无速率限制：默认使用 Spotify Connect API，不受 Web API 429 限制
4. 会话持久：Cookie 有效期约1年，配置一次长期可用

潜在缺点与局限性

• Premium 强制要求：免费账户无法使用 Connect API
• Cookie 维护负担：用户需手动提取/更新，Spotify 登出或改密即失效
• 设备会话依赖：首次使用需通过浏览器或已激活设备建立会话，否则报 "missing device id"
• 功能边界：无 Web API 时无法访问完整曲库，高阶操作需配合浏览器自动化

适合人群

• 远程服务器管理员（VPS/云主机/Homelab）
• 无 GUI 的 Linux 用户（服务器版 Ubuntu/Debian）
• 脚本化音乐工作流开发者
• 需要 SSH 环境下 Spotify 控制的工程师

常规风险

• Cookie 泄露风险：sp_dc 是高权限令牌，JSON 文件需 600 权限保护
• 账户关联风险：Cookie 认证绑定具体 Spotify 账户，多用户场景需隔离配置
• 服务条款灰色地带：非官方 OAuth 流程，存在账户限制理论风险（未见实际案例）
• 会话劫持：Cookie 长期有效，服务器被入侵则 Spotify 账户受控

核心用法

spogo-linux 是一个纯文档型 Skill，专为解决 headless Linux 服务器上 Spotify 控制的痛点而生。它指导用户安装并配置 spogo CLI 工具——一个用 Go 编写的 Spotify 命令行客户端，通过浏览器 Cookie 认证替代传统 OAuth 流程，完美解决远程服务器无法接收 localhost 回调的难题。

典型工作流

1. 安装 Go 环境（如未安装）
2. 通过 `go install` 获取 spogo 二进制
3. 从浏览器 DevTools 提取 `sp_dc` 和 `sp_t` 两个 Cookie
4. 创建 TOML 配置 + JSON Cookie 文件
5. 终端执行播放/搜索/设备控制命令

显著优点

• 突破 OAuth 限制：无需 localhost 可达性，远程服务器秒级认证
• 无守护进程：单次命令即走，资源占用极低
• Premium 体验完整：支持搜索、播放控制、设备切换、状态查询
• JSON 输出友好：便于脚本集成和自动化流程

潜在局限

• Cookie 手工维护：有效期约 1 年，过期需重新提取；用户登出或改密即失效
• Premium 强制门槛：免费账户无法使用 Connect API
• 设备状态依赖：遇 "missing device id" 需先通过浏览器启动会话
• Go 环境前置：目标服务器需预装或自行安装 Go 工具链

适合人群

• 在 VPS/云服务器/树莓派等无 GUI 环境运行的开发者
• 需要远程脚本化控制 Spotify 的自动化场景
• 拒绝 Docker 或复杂依赖，追求轻量方案的极简主义者

常规风险

• Cookie 文件安全：~/.config/spogo/cookies/default.json 包含长期有效凭证，需 chmod 600 严格设限
• 会话失效处理：401 错误时需人工重新获取 Cookie，无法无人值守长期运行
• 非官方工具风险：spogo 为个人开源项目（steipete），非 Spotify 官方维护，API 变更可能导致功能中断

---

安全等级 S 依据：Skill 本身为零代码纯文档，无网络调用、无依赖、无敏感信息泄露，经六维扫描全项通过。