跳转到内容
danmu_api 图文教程

手机 Termux 部署

目标：在手机 Termux 里跑起 danmu_api，并改好 TOKEN 和 ADMIN_TOKEN。

命令已拆成单条，按顺序执行即可。

第 1 步：先装 Termux

Section titled “第 1 步：先装 Termux”

先装官方还在维护的来源，不要装 Play 商店旧版。

优先这两个入口：

如果你走 GitHub Releases，Termux 官方 README 当前说明是：安卓 7 及以上装 apt-android-7 变体。

装完后直接打开 Termux。

第 2 步：先更新系统，再装 Git、Node.js 和编辑器

Section titled “第 2 步：先更新系统，再装 Git、Node.js 和编辑器”

在 Termux 里按顺序执行：

  1. 先更新软件列表：
Terminal window
pkg update
  1. 再升级已装好的包：
Terminal window
pkg upgrade
  1. 最后安装要用到的工具：
Terminal window
pkg install git nodejs-lts nano iproute2

如果中途看到 Do you want to continue?，直接输入 y 再回车。

装完后再按顺序检查：

  1. 先看 Git：
Terminal window
git --version
  1. 再看 Node.js：
Terminal window
node -v
  1. 再看 npm：
Terminal window
npm -v
  1. 最后看 nano：
Terminal window
nano --version

这几条都能正常显示，再继续。

第 3 步：拉代码并进入目录

Section titled “第 3 步：拉代码并进入目录”

按顺序执行：

  1. 先回到 Termux 工作目录：
Terminal window
cd $HOME
  1. 再拉代码：
Terminal window
git clone https://github.com/huangxd-/danmu_api.git
  1. 最后进入项目目录：
Terminal window
cd danmu_api

这里的 $HOME 就是 Termux 的工作目录。项目放这里最省事，不要先扔进手机下载目录。

第 4 步：安装依赖

Section titled “第 4 步：安装依赖”

执行：

Terminal window
npm install

等依赖装完，不要退出 Termux。

第 5 步：复制出 config/.env

Section titled “第 5 步：复制出 config/.env”

下面两条命令都要在 $HOME/danmu_api 目录里执行，也就是前面已经执行过 cd danmu_api。

按顺序执行：

  1. 先复制出配置文件：
Terminal window
cp config/.env.example config/.env
  1. 再打开它：
Terminal window
nano config/.env

如果提示找不到文件，说明你前一步没有进入 danmu_api 目录，先回第 3 步重来。

第 6 步：只改 TOKEN 和 ADMIN_TOKEN

Section titled “第 6 步：只改 TOKEN 和 ADMIN_TOKEN”

如果你现在还没有看到 config/.env 的内容，就按顺序执行：

  1. 先回到项目目录：
Terminal window
cd $HOME/danmu_api
  1. 再打开配置文件：
Terminal window
nano config/.env

看到文件内容后，先只改这两行：

TOKEN=your-token
ADMIN_TOKEN=your-admin-token

如果你看到的是：

# ADMIN_TOKEN=...

把前面的 # 删掉，再填你自己的值。

  • TOKEN：普通页面和接口要用
  • ADMIN_TOKEN：管理员页面要用

改完后保存退出：

  1. 按 Ctrl + O
  2. 回车
  3. 按 Ctrl + X

第 7 步：启动项目

Section titled “第 7 步：启动项目”

执行：

Terminal window
npm start

默认端口是 9321。

如果你想改端口，用这一种写法启动：

Terminal window
DANMU_API_PORT=8080 npm start

第 8 步：查手机局域网地址

Section titled “第 8 步：查手机局域网地址”

再开一个新的 Termux 会话，执行：

Terminal window
ip -4 addr show | grep 'inet '

你会看到几行地址。 只看局域网地址，通常是下面这种：

  • 192.168.x.x
  • 10.x.x.x
  • 172.16.x.x 到 172.31.x.x

不要拿 127.0.0.1 这个地址给别的设备用。

例如你查到的是 192.168.1.23，那访问地址就是：

http://192.168.1.23:9321

上游当前 Node 本地入口会监听 0.0.0.0，所以同一个 Wi‑Fi 下的其他设备可以直接用这个局域网地址访问。

第 9 步：直接测试

Section titled “第 9 步：直接测试”

先在手机自己浏览器里测试：

http://127.0.0.1:9321/your-token

再给同一个 Wi‑Fi 下的电视、平板或电脑测试：

http://192.168.1.23:9321/your-token

搜索接口：

http://192.168.1.23:9321/your-token/api/v2/search/anime?keyword=凡人修仙传

管理员页面：

http://192.168.1.23:9321/your-admin-token

如果你自己改了端口或 token，就把上面地址一起换掉。

第 10 步：以后主要就改这一个文件

Section titled “第 10 步：以后主要就改这一个文件”
  1. 先回到项目目录：
Terminal window
cd $HOME/danmu_api
  1. 再打开配置文件：
Terminal window
nano config/.env

按上游当前实现，改完 config/.env 后，大多数配置会自动重新加载；如果你改的是端口，重新执行一次 npm start 最稳。

最常见的 3 个问题

Section titled “最常见的 3 个问题”

1）电视或平板打不开手机地址

Section titled “1）电视或平板打不开手机地址”

先确认：

  • 手机和播放器设备在同一个 Wi‑Fi
  • 你填的是局域网 IP，不是 127.0.0.1
  • 手机没有切到移动数据

2）Termux 过一会儿自己停了

Section titled “2）Termux 过一会儿自己停了”

这是安卓电池优化常见问题。 给 Termux 放开电池优化，再重试。

3）npm install 中途被系统杀掉

Section titled “3）npm install 中途被系统杀掉”

手机内存紧时会这样。 先关掉后台大应用，再重新执行一次 npm install。

后面继续看

Section titled “后面继续看”

本页命令已按 huangxd-/danmu_api 当前 README.md、package.json、config/.env.example、danmu_api/server.js 核对；Termux 安装来源按 termux/termux-app README 当前安装说明，Termux 包名按 termux/termux-packages 当前包目录核对。