5 步跑通 Stremio:从克隆到流畅播放的完整上手指南
【免费下载链接】stremio-webStremio - Freedom to Stream项目地址: https://gitcode.com/GitHub_Trending/st/stremio-web
Stremio Web 是 Stremio 的官方网页版流媒体中心,靠插件(Addon,相当于给播放器挂上不同片源的扩展)聚合电影、剧集和频道。你刚把它 clone 下来、跑起来却不知道下一步该干嘛?这篇带你从装依赖到调好播放,一次跑通。
第一次启动只需三条命令
先确认环境:Node.js 22 以上、pnpm 11 以上。然后三步走:
git clone https://gitcode.com/GitHub_Trending/st/stremio-web pnpm install pnpm start浏览器打开http://localhost:8080。首次进入是一个引导页(Intro),按提示创建或登录一个 Stremio 账户,随后会落到主看板(Board)——这就是它第一次正常工作给你看的画面。
想用 Docker 也可以:
docker build -t stremio-web .再docker run -p 8080:8080 stremio-web。
接入第一个插件,让片源进来
你要做什么:装一个提供片单目录的插件,这样 Discover 里才有内容可看。去哪做:左侧导航进 Addons 页。怎么做:在搜索/输入框里粘贴插件的 manifest 地址(官方元数据插件 Cinemeta 就是一类这种以manifest.json结尾的地址),回车确认安装。
装完之后回 Discover,顶部会多出该插件提供的分类目录,点开就能看到片单。插件本质上就是一个返回片单和流的 HTTP 服务,源码侧的处理逻辑在 插件目录 里。
完成一次完整播放
你要做什么:从片单点开一部片,走到能出声为止。去哪做:在 Discover 或 Board 里点进任意一部作品,会进入 MetaDetails 详情页。能看到什么:详情页下方列着可播放的流(stream,一个可直接播放的地址),点其中一条就进播放器。
播放器是纯键盘优先的,先记四个:Space播放/暂停、方向键快进快退、F全屏、Esc返回。完整键位在 快捷键定义 里都有。
把追的片收进个人库
你要做什么:把想追的作品存下来,下次接着看。去哪做:在详情页点 "Add to Library"。能看到什么:作品进 Library 后,Board 顶部的 Continue Watching 会出现你的续播进度,点它就能从上次停下的地方继续。
把卡顿压下去的三个开关
愿意折腾的看这里,真正有用的三处在 设置 里:
- 换流 / 换服务器:Settings → Streaming,可以管理片源服务器 URL,并调整缓存大小(从 0 到无限)和转码 profile。转码 profile 会根据你设备支持的硬件加速(H264/H265 等)挑一个,弱网或老设备上开转码通常更稳。
- 换下载策略:同一个 Streaming 页有 torrent profile(default / soft / fast / ultra fast),带宽紧张选 soft,带宽富裕想快就选 fast,别一上来就 ultra fast 把网络打满。
- 字幕延迟:播放中按
G/H微调字幕快慢,C开关字幕,+/-调字号,不用回设置页。
跨设备同步你的进度
用同一个 Stremio 账户在另一台设备(手机、电视盒子、另一台电脑)登录,Library 和 Continue Watching 会跟着账户走,进度自动对齐。你本地不需要额外配置,同步由账户态驱动,UI 只负责渲染。
播放出问题的五类症状
- 症状:Discover 一片空白 / 一直转圈→ 检查插件 URL 是不是指向
manifest.json,以及网络能否访问该插件服务。 - 症状:某个流加载半天不动→ 回详情页换一条流,或去 Streaming 页把 torrent profile 调低一档。
- 症状:字幕对不上嘴型→ 播放中按
G(提前)/H(延后)微调,别改系统时间。 - 症状:按了键没反应 / 想不起快捷键→ 按
Ctrl + /直接弹出快捷键面板。 - 症状:换台设备进度没了→ 多半是没登录账户,登录后进度才会跟随同步。
照这张清单做完
pnpm install && pnpm start跑通,在 8080 看到主看板- 接入第一个插件,Discover 里出现新分类
- 完成一次播放,并用
F进全屏、Space暂停 - 把一部作品 Add to Library,确认 Board 出现续播
- 按需开转码 profile / 调缓存大小,把卡顿压下去
- 用同一账户在第二台设备登录,验证进度同步
【免费下载链接】stremio-webStremio - Freedom to Stream项目地址: https://gitcode.com/GitHub_Trending/st/stremio-web
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考