EeveeSpotifyReincarnated原理揭秘：如何实时拦截Spotify Bootstrap请求实现免费Premium？-育师

【免费下载链接】EeveeSpotifyReincarnated

Enhancing your Spotify experience on iOS

项目地址：https://gitcode.com/gh_mirrors/ee/EeveeSpotifyReincarnated

EeveeSpotifyReincarnated 是一款面向 iOS 的 Spotify 增强插件（Tweak），它的核心原理是实时拦截 Spotify 的 Bootstrap 请求，在内存中改写返回的账户配置数据，从而让免费账号获得 Premium 体验，并顺带实现去广告、自定义歌词等增强功能。这篇文章用通俗的方式拆解它的工作流程，无需编程基础也能看懂。

一、先搞清楚：Bootstrap 请求是什么？

每次打开 Spotify 时，App 都会先向服务器发送一个路径包含v1/bootstrap的请求，用来"报到"并拉取当前账号的状态。这个响应里包含两样关键东西：

账户属性（Account Attributes）：比如账号类型是free还是premium、订阅到期时间、播放权限等；
功能开关（Assigned Values）：一组远程控制的功能标志位，控制广告是否显示、混音（Crossfade）是否可用、升级弹窗何时出现……

Spotify 客户端完全信任这份数据来决定"你是什么样的用户"。EeveeSpotifyReincarnated 做的事情，就是在数据从网络到达 App 逻辑层的最后一刻动手脚，把"免费"偷偷改成"Premium"。判断一个请求是不是 Bootstrap，靠的是 URL+Extension.swift 中简单直接的isBootstrap检测。

二、拦截点：Hook 住网络层的 URLSession 代理

iOS 上所有网络请求都走URLSession，而 Spotify 用SPTDataLoaderService这个类处理核心数据加载。EeveeSpotifyReincarnated 基于 Orion 框架的ClassHook机制对这个类做了"方法交换"，接管了三个关键回调：

didReceiveData：发现是 Bootstrap 请求时，不把数据交给原逻辑，而是先存进缓冲区（URLSessionHelper）；
didCompleteWithError：请求完成后，从缓冲区取出完整响应，开始"手术"；
改完之后，再调用原始方法把改写过的数据回注给 Spotify。

核心拦截代码位于 DynamicPremium+ModifyBootstrap.x.swift。

💡 一个容易忽略的细节：某些地区（如 gae2）的 Bootstrap 响应走的是另一个代理类HttpClientURLSession，所以项目还配了第二道保险 HttpClientURLSessionHooks.x.swift，避免"漏网之鱼"让免费版文案溜进来。

三、核心流程：从捕获到"变身"Premium 的 4 步

整个"免费变 Premium"的过程可以概括为四个步骤：

第 1 步：缓冲原始响应

Bootstrap 的数据到达时先被暂存（L42-L45），等待请求完整结束再统一处理，避免数据只到一半就动手。

第 2 步：智能判断，不折腾付费用户

项目会先解析响应里的账号类型：如果你本来就开了 Premium，插件会自动停用改写并弹出提示（L71-L75），只对免费账号启用请求修补模式。

第 3 步：改写账户属性——"身份"换 Premium

modifyAttributes 函数把关键属性逐一替换：

type、player-license、catalogue全部改为premium；
on-demand（随时点播）、unrestricted（无限制）、high-bitrate（高音质）置为真；
subscription-enddate设为一年后的日期，避免 App 检查到期；
删除一系列会触发"智能校验"导致强制登出的字段（如smart-shuffle、on-demand-trial）。

第 4 步：改写功能开关——广告、升级弹窗全灭

DynamicPremium+ModifyingFunctions.swift 里维护了一份数百条的功能开关替换清单（propertyReplacements），作用是"广撒网"：

🚫 关闭几乎所有广告位：首页横幅、搜索页广告、Marquee 全屏品牌广告、播客/有声书广告、开屏广告……；
🚫 关闭升级推广弹窗与"限时免费"话术；
✅ 强制开启crossfade_enabled（歌曲淡入淡出）和automix_enabled（自动混音）这两个 Premium 播放体验；
🎤 强制开启歌词分享按钮（enable_lyrics_share）等 Premium 专属 UI。

最后，改写后的数据被重新序列化成 Protobuf 字节流，回注给 Spotify——App 读到的已经是"Premium 版本"的自己了。

四、可选增强：整包覆写配置（Overwrite Configuration）

除了逐条改写，EeveeSpotifyReincarnated 还支持一种更彻底的策略：用一份打包好的 Premium 配置快照整体替换服务器下发的功能配置。

快照文件就是资源包里的 resolveconfiguration.bnk，9.1.76 及以上版本则使用 resolveconfiguration_9_1_76.bnk；
版本匹配逻辑由 BundledConfigurationPolicy.swift 负责，自动选择对应快照；
加载入口在 BundleHelper.swift；
覆写时会保留与当前账号绑定实时生效的开关（如消息功能），防止"换了配置却少了聊天入口"这类副作用，见 ServerSidedFeaturePolicy.swift。

五、配套防线：改写只是"上半场"

只改 Bootstrap 还不够，Spotify 还有别的途径发现"你不是 Premium"。项目为此布了多道防线：

会话保护：SessionProtection.x.swift 拦截logout()等登出方法以及 Ably 撤销消息，防止服务器判定异常后把你"踢下线"；
多端点修补：SpotifyResponsePatcher.swift 继续处理customize、套餐卡片、Premium 徽标等后续请求；
广告端点拦截：URL+Extension.swift 中的isAdRelated识别并屏蔽几十个广告/推广类接口。

⚠️ 但项目也明确标注了服务器端硬性限制（README.md）：极高音质、歌单离线下载、远程参加 Jam、AI DJ、Spotify Connect 直连等功能由后端鉴权，客户端无法伪造，属于"永远不会生效"的选项。

六、用户视角：在哪里开关这些能力？

所有能力都集中在插件内置的设置页（Spotify 头像 → EeveeSpotify → Patching）中：

开关	作用
Do not patch Premium	总开关。关闭时才会执行请求拦截改写
Overwrite configuration	是否启用上文第四节的"整包覆写"策略
True shuffle	真正的随机播放（非 Spotify 伪随机）

界面实现见 EeveePatchingSettingsView.swift，注意修改后需要重启 Spotify App 才能生效。

七、小结：一句话看懂原理

EeveeSpotifyReincarnated = 网络层 Hook + Protobuf 解析 + 配置数据改写 + 多防线保会话。

它不登录你的账号、不发送伪造请求，而是在响应数据"进门"前的最后一刻完成改写，因此实现方式轻量、隐蔽，也几乎不依赖账号状态。整个机制的总入口位于 Tweak.x.swift，通过PremiumBootstrapGroup等 Hook 分组在不同 Spotify 版本（iOS 14/15/9.1.x）下做兼容激活。

理解了这个原理，你就能明白：为什么某些功能（如离线下载）插件无能为力，而播放与 UI 层面的 Premium 体验却能"免费"获得——边界就在"服务器鉴权 vs 客户端配置"之间。

📌 温馨提示：本文仅用于技术研究交流，请遵守当地法律法规与 Spotify 服务条款，合理使用该项目。