Skip to content

7.4 billion tokens per month. 34 free LLM providers. 635 free model endpoints. All behind one /v1 endpoint, plus any custom OpenAI-compatible endpoint. Smart routing, automatic failover, encrypted keys. Personal experimentation only.

TypeScript
2.9 KB
Raw Blame

English · 简体中文

Android(Termux)安装

实验性功能,由社区维护。FreeLLMAPI 直接运行在 Android 设备本地。

FreeLLMAPI 可以在 Termux 中运行,无需 Android NDK 工具链。在 Android 上,服务器使用 Node 内置的 SQLite 驱动,而不是原生的 better-sqlite3 包。

要求

  • Android 7 或更新版本
  • 约 1 GB 可用存储空间
  • F-Droid 上的 Termux(Play 商店的版本已过时)
  • Node.js 22.13 或更新版本;推荐 Node 24 LTS

不要混用来自不同商店的 Termux 或其附加包。

安装

更新 Termux 并安装所需的包:

pkg update
pkg upgrade -y
pkg install -y nodejs-lts git

确认 Node 的版本足够新,能提供 node:sqlite:

node --version

然后克隆并启动 FreeLLMAPI:

git clone https://github.com/tashfeenahmed/freellmapi.git
cd freellmapi
npm install --no-audit --no-fund
npm run dev

安装时关于可选包 better-sqlite3 的警告在 Android 上无害。如果 npm 要求批准依赖的安装脚本,批准 esbuild 的脚本后再运行一次 npm install。

在手机浏览器中打开 http://localhost:5173。API 位于 http://localhost:3001/v1。

从其他设备访问

仪表盘包含 API 密钥和管理控制项,只在可信网络中暴露它。

HOST=0.0.0.0 npm run dev:lan

在 Android 的 Wi-Fi 设置中查看手机的局域网地址,或运行:

ip addr show wlan0

在同一网络的另一台设备上打开 http://PHONE_IP:5173。不要把这些开发服务器直接端口转发到公网;需要远程访问时请使用 Tailscale 之类的私有 VPN。

保持进程运行

屏幕关闭后 Android 可能会挂起 Termux。从与 Termux 相同的商店安装 Termux:API 附加组件,然后运行:

pkg install -y termux-api
termux-wake-lock

停止服务器后释放唤醒锁:

termux-wake-unlock

故障排查

node:sqlite 不可用

升级 Termux 的包,并确认 node --version 报告 22.13 或更新版本:

pkg update
pkg upgrade -y
pkg install -y nodejs-lts

concurrently: not found

依赖安装没有完成。再运行一次 npm install --no-audit --no-fund,并处理它报告的第一个非可选错误。

端口已被占用

停止占用 3001 或 5173 端口的进程,或在仓库的 .env 文件中配置另一个 PORT。

屏幕关闭后进程停止

使用 termux-wake-lock,并在 Android 设置中为 Termux 关闭电池优化。

更新

先停止正在运行的开发服务器,然后运行:

git pull --ff-only
npm install --no-audit --no-fund
npm run dev

反馈 Android 相关问题时,请附上 Android 版本、Termux 的来源与版本、设备架构、node --version 的输出以及完整的错误信息。