CloudStream实操教程：5分钟搭好你的专属流媒体中心

CloudStream实操教程：5分钟搭好你的专属流媒体中心

【免费下载链接】cloudstreamAndroid app for streaming and downloading media.项目地址: https://gitcode.com/GitHub_Trending/cl/cloudstream

手机里装了五个播放器，每个都带广告，还各自为政找不到内容？CloudStream 是一个基于扩展系统的 Android 流媒体应用，本体不带任何视频源，全靠你安装扩展来接入内容——这既是最初的门槛，也是它最灵活的地方。按这篇教程走完，你会得到一个能播放、能下载、能投屏的无广告私人影音库。

30秒认识它

• 本体只是个播放器框架：不内置任何媒体源，装好扩展后才有内容可看
• 完全无广告、无追踪：官方明确不做任何统计收集
• 手机和 Android TV 通用：同一套代码覆盖两类设备，遥控器也能操作
• 支持 Chromecast 投屏和离线下载：边看边存，断网也能播
• 多账号体系：可建多个资料，书签和观看历史各自独立

跟普通播放器最大的区别在于：它不替你决定看什么，你装什么扩展，它就看什么。

动手前，先过一遍自检

• 系统版本：Android 6.0（API 23）及以上。低于这个版本装不上，建议升级系统或换机
• 未知来源权限：需在"设置 → 安全"里为浏览器或文件管理器开启。装的时候系统会弹出提示，按引导点"允许"即可
• 存储空间：至少预留 100MB 装应用本体；打算用离线下载的话，建议再留几个 GB

从零跑通

第1步：拿到安装包

从项目发布页下载最新 APK。如果你熟悉 Android 开发，也可以自己从源码编译：

git clone https://gitcode.com/GitHub_Trending/cl/cloudstream cd cloudstream ./gradlew assembleDebug

第2步：安装 APK

在文件管理器里打开下载目录，点击 APK 文件，按提示允许"未知来源"安装，点击"安装"。

第3步：确认装好了

桌面上出现 CloudStream 图标即成功。点进去后，你会先落在账号选择页而不是播放页——这是正常的，它用账号体系区分手机、TV 等多设备。

应用权限声明在 AndroidManifest.xml，TV 设备兼容性配置也在其中，遇到安装问题可以先看一下。

装好只是开始：首次启动必做

第1件：建一个账号

在账号选择页点"创建账号"，起个名字就行。多设备之间共用书签、观看历史都靠它，这一步不能跳过。

第2件：安装扩展（最重要）

打开应用 → 进入"设置" → "扩展" → 点右上角"添加仓库"，把扩展源地址粘贴进去。先加官方仓库，再按需加社区源。装完扩展后，首页对应分类才会出现内容入口。扩展系统的实现入口在 plugins 目录，想看插件怎么跑的可以翻这里。

第3件：配一下播放偏好

设置 → 播放器里，把视频源按画质偏好排序，顺手选一个默认字幕语言。之后每次播放都会自动挑最顺眼的那一路源。

让体验再上一个台阶

Chromecast 投屏：客厅电视不想装应用时的最优解。播放页点右上角投屏图标，选设备即连，前提是两者在同一 Wi-Fi 下。

离线下载：把整季剧集存进手机，出差高铁上照样看。设置 → 下载 → 选存储位置（内部存储或 SD 卡），然后播放页长按剧集选择集数开始下载。

TV 模式：TV 版 APK 装好后，遥控器上下键导航、数字键直接搜片名，比手机上手还快。

个人中心默认背景图就在 res/drawable 目录，想换头像背景可以看看里面有哪些备选。

卡住了？对照排查

症状：装完扩展还是看不到内容最可能原因：仓库没加载成功，或扩展被禁用了 解决动作：回到"设置 → 扩展"，确认仓库前有已勾选状态，没有就点进仓库重装一次

症状：视频能进播放页但一直转圈最可能原因：当前扩展的视频源失效或网络受限 解决动作：在播放页顶部切换其他源（每部作品通常有多路源），全部失败则到扩展页更新该插件到最新版

症状：下载中途中断最可能原因：系统杀掉了后台下载服务 解决动作：在系统设置里把 CloudStream 的电池优化设为"不限制"，并允许后台运行

写在最后

CloudStream 的思路是把"看什么"的决定权交给你，扩展装多少、从哪来，全由你说了算。装好官方仓库跑通第一次播放之后，剩下的就是按自己的口味慢慢加源了。

遇到问题可以去项目 Discord 社区提问，或在 GitHub Issues 里搜搜有没有人踩过同样的坑。挑个晚上闲下来，给它装个扩展试试吧。

【免费下载链接】cloudstreamAndroid app for streaming and downloading media.项目地址: https://gitcode.com/GitHub_Trending/cl/cloudstream