首先感谢KuekHaoYang对KVideo的开发，仓库地址：https://github.com/KuekHaoYang/KVideo

最近发现了一个非常酷的开源项目 *KVideo*——一个基于 Next.js 构建的现代化视频聚合播放平台，拥有独特的“液态玻璃”UI 设计。既然是 Next.js 项目，能不能不依赖电脑，直接在安卓手机上跑起来呢？

答案是肯定的！利用 *Termux* 这款强大的终端模拟器，我们完全可以在手机上搭建一个本地 Node.js 环境。虽然过程踩了不少坑，但最终成功运行的那一刻，成就感拉满。本文将详细记录从 0 到 1 的部署过程，希望能帮到同样喜欢折腾的朋友。

1. 安装 Termux

千万不要在 Google Play 商店下载 Termux，那里的版本已经很久没更新了，兼容性很差。

  • 正确姿势：去 F-Droid 官网下载安装最新版 Termux。

  • 初始化

    安装后打开，更新一下软件源：

    pkg install nodejs git

2. 安装核心环境

在安装依赖，由于国内网络环境，直接 npm install 经常会出现 ECONNRESET 错误。

  • 解决方案：切换到淘宝 NPM 镜像源，速度飞快且稳定。
# 切换镜像源
npm config set registry https://registry.npmmirror.com
# 清理残留 rm -rf node_modules package-lock.json
# 重新安装
npm install --ignore-scripts

KVideo 是基于 Node.js 的，我们需要安装它以及 Git 工具来拉取代码：

pkg install nodejs git

安装玩后可输入

node -v
npm -v

查看是否安装成功。

3. 克隆项目代码

使用 git 命令将 KVideo 的源码拉取到本地：

git clone https://github.com/KuekHaoYang/KVideo.git
cd KVideo

4. 安装依赖

注意，这里用通用代码部署会遇到兼容性问题，这一部分会解决这些问题，如果本篇文章给出的解决方案不可行，请

直接运行 npm install 会报错，因为项目包含 Cloudflare 的部署工具（workerd），它不支持安卓平台。

解决方案：使用 --ignore-scripts 参数跳过安装脚本，只下载必要的代码包。

npm install --ignore-scripts

KVideo 默认使用 Next.js 16，其默认的 Turbopack 打包器在安卓 ARM64 架构下存在兼容性问题（turbo.createProject is not supported），导致无法启动开发模式。

解决方案：我们需要手动降级到 Next.js 15，它使用兼容性更好的 Webpack。

# 降级 Next.js 到 15.x
sed -i 's/"next": "16.1.1"/"next": "^15.1.0"/g' package.json
# 为了稳妥，同步降级 React 到 18.x
sed -i 's/"react": "19.2.0"/"react": "^18.3.1"/g' package.json
sed -i 's/"react-dom": "19.2.0"/"react-dom": "^18.3.1"/g' package.json

5. 启动项目

万事俱备，启动服务！

npm run dev

当终端出现 Ready on http://localhost:3000 时，说明服务已成功启动。

6. 订阅源

这个就得大家各显神通了，我不参与哈（）

更多信息请前往KVideo 在这边提供源吧，在Github上直接放还是太危险了 - 搞七捻三 / 搞七捻三, Lv1 - LINUX DO观看

本文同步发布于 在手机上搭建KVideo | 红石の空间站

📌 转载信息
转载时间： 2026/1/1 01:50:04