Spotube 国内使用详细教程

核心工作原理#

Spotube 采用”元数据+音频源分离”的技术路线：

• 从 Spotify API 获取歌曲信息、封面、歌词等元数据

• 从 YouTube、Piped 等免费音频源获取实际音轨

• 本地播放，不依赖服务器中转

与 Spotify 的核心区别#

表格

主要优势#

• 完全免费开源，代码透明可审计

• 支持离线下载，文件带完整元数据标签

• 时间同步歌词显示

• 支持 Windows、macOS、Linux、Android 全平台

• 隐私优先：无遥测、无诊断、无用户追踪

官方下载地址#

• 官网： https://spotube.krtirtho.dev/downloads/

• GitHub Releases： https://github.com/KRTirtho/spotube/releases

Windows 系统#

方法一：直接下载安装包（推荐新手）

1. 访问 GitHub Releases 页面

2. 下载 Spotube-windows-x86_64-setup.exe 文件

3. 双击运行安装程序，按提示完成安装

方法二：包管理器安装

1
# 使用 Winget（Windows 10/11 自带）
2
winget install --id KRTirtho.Spotube
3

4
# 或使用 Chocolatey
5
choco install spotube
6

7
# 或使用 Scoop
8
scoop bucket add extras
9
scoop install spotube

macOS 系统#

方法一：DMG 安装包

1. 从 GitHub Releases 下载 Spotube-macos-universal.dmg

2. 双击打开 DMG 文件

3. 将 Spotube 拖入 Applications 文件夹

方法二：Homebrew 安装

1
brew tap krtirtho/apps
2
brew install --cask spotube

Linux 系统#

Debian/Ubuntu：

1
# 下载 .deb 包后安装
2
sudo apt install ./Spotube-linux-x86_64.deb

Arch/Manjaro：

1
# 使用 yay
2
yay -Sy spotube-bin
3

4
# 或使用 pamac
5
sudo pamac install spotube-bin

Fedora/OpenSUSE：

1
# Fedora
2
sudo dnf install ./Spotube-linux-x86_64.rpm
3

4
# OpenSUSE
5
sudo zypper in ./Spotube-linux-x86_64.rpm

Flatpak（通用）：

1
flatpak install com.github.KRTirtho.Spotube

Android 系统#

方法一：GitHub APK（推荐）

1. 从 GitHub Releases 下载 Spotube-android-all-arch.apk

2. 在手机设置中启用”未知来源安装”权限

3. 打开 APK 文件完成安装

方法二：F-Droid 安装

从 F-Droid 应用商店搜索安装

步骤 1：语言切换#

1. 启动 Spotube 后，点击右上角设置图标（齿轮状）

2. 找到 Language / 语言 选项

3. 选择 简体中文 或 繁體中文

4. 界面自动切换为中文

步骤 2：主题设置#

1. 进入设置 → 外观

2. 可选择：

   • 亮色主题：适合日间使用

   • 暗色主题：适合夜间使用

   • 纯黑主题：OLED 屏幕省电模式

3. 可自定义主题强调色

步骤 3：音频源配置（重要）#

1. 进入设置 → 音频源

2. 默认音频源为 YouTube

3. 国内用户建议：

   • 主音频源：选择 Piped 或 Invidious（YouTube 的隐私友好前端）

   • 备用音频源：选择 YouTube

4. 可添加自定义 Piped/Invidious 实例地址

步骤 4：音质设置#

1. 进入设置 → 播放

2. 音频质量选项：

   • 低（约 64 kbps）

   • 中（约 128 kbps）

   • 高（约 256 kbps）

3. 建议选择”高”以获得最佳听感

4. 如遇网络卡顿，可适当降低音质

4.1 安装 Spotify 插件（关键步骤）#

重要说明： 2025年 Spotube 重构后，需手动安装 Spotify 插件才能访问个人歌单和推荐。

操作步骤：

1. 打开 Spotube，进入设置

2. 找到 元数据提供者插件 / Metadata Provider Plugins

3. 点击 浏览插件 / Browse Plugins

4. 找到 spotube-plugin-spotify 插件，点击安装

5. 安装完成后，返回设置页面

6. 点击 连接 Spotify 账户

7. 选择登录方式：

   • 方式 A：浏览器授权登录（推荐）

   • 方式 B：手动输入 Cookie（详见下文）

方式 B：手动获取 Cookie 登录

1. 使用 Chrome 浏览器访问 accounts.spotify.com

2. 登录你的 Spotify 账号

3. 按 F12 打开开发者工具

4. 切换到 Application（应用程序） 标签页

5. 左侧找到 Cookies → accounts.spotify.com

6. 复制以下两个值：

   • sp_dc 的 Value 值

   • sp_key 或 sp_gaid 的 Value 值

7. 回到 Spotube，将这两个值粘贴到对应输入框

8. 点击提交完成关联

4.2 音乐搜索与播放#

搜索歌曲：

1. 点击底部导航栏的搜索图标

2. 输入歌曲名、歌手名或专辑名

3. 支持中英文搜索

4. 点击搜索结果即可播放

浏览推荐：

1. 进入浏览页面

2. 可查看：

   • 个性化推荐歌单

   • 新发行歌曲

   • 热门榜单

   • 你关注的艺术家新动态

4.3 播放列表管理#

创建播放列表：

1. 进入音乐库 → 播放列表

2. 点击右上角 + 按钮

3. 输入播放列表名称

4. 在歌曲页面点击 … → 添加到播放列表

导入 Spotify 播放列表：

1. 复制 Spotify 播放列表的分享链接

2. 在 Spotube 中进入文件 → 导入

3. 选择 Spotify 播放列表

4. 粘贴链接，点击导入

4.4 离线下载功能#

下载单曲：

1. 在播放界面，找到进度条右侧的下载图标

2. 点击开始下载

3. 下载完成后，图标变为已完成状态

批量下载：

1. 在播放列表或专辑页面

2. 点击右上角 … → 下载全部

3. 支持同时下载多首歌曲

管理下载文件：

• 下载位置：默认为 ~/Music/Spotube/Downloads/

• 可在设置 → 存储中修改下载路径

• 下载的文件为 MP3 格式，带完整 ID3 标签（封面、歌词、艺术家信息）

4.5 歌词显示与同步#

1. 播放歌曲时，点击播放界面的歌词图标

2. 自动显示时间同步歌词

3. 支持滚动跟随当前播放位置

4. 部分歌曲支持双语歌词显示

问题分析#

国内用户使用 Spotube 面临的主要网络障碍：

• Spotify API 访问受限

• YouTube 音频源无法直接访问

• 部分插件下载失败

解决方案一：使用代理工具（推荐）#

操作步骤：

1. 配置你的代理软件（Clash/V2Ray/Shadowsocks 等）

2. 确保代理模式为全局模式或规则模式

3. 在 Spotube 设置中通常无需额外配置

4. 系统代理生效后，Spotube 会自动使用

解决方案二：使用 Piped/Invidious 实例#

Piped 实例（推荐）：

Piped 是 YouTube 的隐私友好前端，部分实例在国内可直连。

配置方法：

1. 在设置 → 音频源中选择 Piped

2. 点击添加自定义实例

3. 输入可用的 Piped 实例地址（需自行搜索最新可用实例）

4. 保存后设为主音频源

Invidious 实例：

类似 Piped，同样需要在设置中配置可用的实例地址。

解决方案三：使用 NewPipe（仅 Android）#

Android 用户可使用 NewPipe 作为音频源：

1. 在 Spotube 设置 → 音频源中

2. 选择 NewPipe 作为音频引擎

3. NewPipe 对 YouTube 有更好的兼容性

网络环境检测#

如何判断网络是否正常：

1. 打开 Spotube 后，首页能正常显示推荐内容

2. 搜索歌曲能返回结果

3. 点击播放后，进度条正常推进

4. 如出现长时间加载或”Something went wrong”提示，通常是网络问题

问题 1：首页空白，显示”Something went wrong”#

原因： 无法连接到 Spotify API 或音频源

解决方案：

1. 检查代理是否正常工作

2. 尝试切换音频源（YouTube ↔ Piped ↔ Invidious）

3. 清除 Spotube 缓存：设置 → 存储 → 清除缓存

4. 重启应用

问题 2：歌曲加载很久或自动跳过#

原因： 音频源匹配失败或网络不稳定

解决方案：

1. 进入设置 → 音频源，切换不同的音频源

2. 降低音质设置（高 → 中）

3. 开启预缓冲功能：设置 → 播放 → 启用预缓冲

4. 检查网络连接稳定性

问题 3：无法登录 Spotify 账户#

原因： Cookie 失效或网络问题

解决方案：

1. 重新获取 sp_dc 和 sp_key Cookie 值

2. 确保浏览器已成功登录 Spotify

3. 使用浏览器授权登录方式替代 Cookie 登录

4. 尝试使用访客模式（无需登录，但无法同步个人歌单）

问题 4：下载的歌曲无法播放#

原因： 下载不完整或文件损坏

解决方案：

1. 在下载管理中删除该歌曲

2. 重新下载

3. 检查存储空间是否充足

4. 更换下载音质设置

问题 5：歌词不显示或不同步#

原因： 歌词插件未安装或匹配失败

解决方案：

1. 进入设置 → 插件，确认歌词插件已安装

2. 尝试安装 LRCLib 插件以获得更精准的歌词

3. 在播放界面手动调整歌词偏移量

4. 部分小众歌曲可能无歌词数据

使用建议#

• 定期更新到最新版本以获得最佳体验

• 善用播放列表功能整理喜爱的歌曲

• 利用离线下载功能，在网络良好时提前缓存

• 探索插件市场，发现更多实用功能

注意事项#

• Spotube 为开源项目，稳定性可能不及商业软件

• 音频源来自第三方平台，音质可能存在差异

• 部分新发行歌曲可能暂时无法匹配到音源

• 建议保留 Spotify 账号以获得完整元数据同步

适用版本： Spotube v5.1.1 及以上

官方资源：https://github.com/KRTirtho/spotube