在流媒体平台普遍采用中心化内容分发的今天，Stremio 以其独特的去中心化 addon 架构走出了一条差异化路线。Stremio Web（GitHub 9.3k stars）作为其官方前端实现，不仅是一个普通的视频播放器，更是一个面向 addon 开发者开放的流媒体内容聚合平台。理解其架构设计，对于构建可扩展的 Web 端流媒体应用具有重要的参考价值。
去中心化 addon 协议与内容发现
Stremio Web 的核心设计哲学是将内容发现与播放分离。平台本身不托管任何视频内容，而是通过加载第三方 addon 来获取影视目录、元数据和播放链接。这种模式类似于浏览器扩展的插件系统，但针对流媒体场景做了专门优化。每个 addon 都是一个独立的 HTTPS 服务，通过标准的 JSON 协议与前端通信。
Addon 的数据结构呈现树状层级：catalogs（目录）→ metas（元数据）→ videos（视频信息）→ streams（播放地址）。当用户在界面中浏览时，Web 客户端首先向所有已启用的 addon 发送目录请求，汇总后呈现统一的发现界面。用户点击某部影片后，系统会并行向相关 addon 查询元数据，再在用户选择具体集数时请求可用流地址。这种分层设计使得 addon 可以专注于自己擅长的内容源，而无需关心前端渲染逻辑。
从技术实现来看，addon 使用 Node.js 和 Stremio Addon SDK 构建。开发者通过定义 manifest.json 来声明 addon ID、支持的资源类型（如 movie、series）以及提供的资源接口。SDK 提供了 addonBuilder 工具类，用于快速注册 stream、meta、catalog 等处理器，并内置了 serveHTTP 方法来启动支持 CORS 的 HTTP 服务。这意味着任何具备基本 Web 开发能力的开发者都可以在几小时内创建一个可用的 Stremio addon。
流媒体渲染管线与播放器集成
Stremio Web 的渲染管线遵循「查询 — 解析 — 代理 — 播放」四阶段模型。当用户点击播放按钮时，前端首先将选中的视频标识发送给对应 addon，addon 返回流地址（可能是 HTTP 直链、磁力链接或种子文件）。对于 HTTP 类型，客户端直接交付给播放器；对于 BitTorrent 类型，则需要经过本地流媒体服务器的预处理。
这一环节是 Stremio 区别于普通 Web 播放器的关键。官方桌面端内置了 BitTorrent 引擎和流媒体服务器，负责将种子数据实时转换为播放器可消费的 HTTP 流。服务器支持转码能力，当原始视频的音轨格式不被目标播放器支持时（如 EAC3 转 AAC），会自动调用 FFmpeg 进行处理。这意味着即使用户在不支持 4K 解码的设备上，也能通过软解碼获得流畅播放。
需要注意的是，Stremio Web 本身不嵌入 Video.js 等通用播放器库。在桌面端，它依赖 Electron 的 Chromium 内核直接调用原生媒体 API；在移动端，则使用 Media3（ExoPlayer）或 VLC 作为播放引擎。Web 客户端若要实现播放功能，通常需要自行集成播放器组件，或使用第三方兼容方案。
BitTorrent 缓存策略与工程实践
BitTorrent 流的本地缓存是 Stremio 架构中最具工程价值的部分。流媒体服务器维护一个磁盘缓存目录，下载种子时会优先将数据写入缓存。当用户进行 seek 操作时，系统优先从磁盘读取已缓存的数据，从而规避网络波动带来的卡顿。这种设计使 Stremio 在中等带宽条件下也能实现近似本地播放的体验。
缓存行为通过 server-settings.json（或 stremio-server.json）配置，关键参数包括 cacheRoot（缓存目录路径）和 cacheSize（缓存大小上限）。默认策略采用 LRU 驱逐：当新流开始时，若缓存总大小超过上限，系统会删除最久未访问的已缓存种子。需要特别说明的是，cacheSize 是一个软性目标而非硬性上限 —— 如果当前播放的视频文件体积超过缓存上限，Stremio 仍会完整下载该文件，导致实际磁盘占用超出预期。对于有大文件播放需求的用户，将缓存目录挂载到 RAMDisk 是常见的优化手段。
然而，HTTP 和 debrid 类型的流目前没有获得同等的缓存待遇。Stremio 的缓存机制仅针对 BitTorrent 生效，HTTP 直链播放时，播放器直接向远程服务器请求数据，seek 操作会触发新的 HTTP Range 请求。这意味着 debrid 用户在拖动进度条时可能遭遇重新缓冲，成为一个待解决的功能需求。
前后端分离与自托管部署
Stremio 架构的另一个亮点是前后端彻底分离。Web 客户端（stremio-web）专注于 UI 渲染和用户交互，而流媒体处理逻辑由独立的 server 组件承担。这种分离允许用户灵活选择部署方案：既可以使用 Stremio 官方托管的服务端，也可以自建 server 实例来实现数据隐私或网络优化。
自托管场景下，用户通常通过 Docker 运行 server 容器，配置 VPN 或 debrid 服务来优化流速。Web 客户端通过 --webui-url 参数指向自建前端，server 则处理所有流请求。这种部署模式完全消除了对云端回调的依赖，实现了真正意义上的本地化使用。
综合来看，Stremio Web 的架构代表了一种去中心化流媒体的工程实现范式。它通过标准化的 addon 协议解耦内容提供，通过本地流媒体服务器统一处理复杂的播放场景，并通过可配置的缓存策略平衡性能与资源消耗。这些设计思路对于构建下一代模块化 Web 应用具有借鉴意义。
资料来源：GitHub Stremio/stremio-web、Stremio Addon Guide