THE TAVERN CODEX安装与升级

Android (Termux) 安装

Android (Termux) 安装：SillyTavern 可以使用 Termux 在 Android 设备上原生运行。 :beer: 有电脑的话，推荐用一键启动器macOS / Windows 。SillyTavern 酒馆中文百科，保留原文与出处，提供像素酒馆相关入口和阅读导航。

原文 · sillytaverncn.net ↗授权迁移 · 保留原文作者与许可核对 2026-11-03纯文本 ↗

本页章节 9

阅读说明

下方保留源站教程正文，部分版本、价格和产品信息可能随时间变化，请以当前应用与上游文档为准。本站与 SillyTavern 为独立产品，不将其扩展视为像素酒馆可完全兼容的功能。

SillyTavern 可以使用 Termux 在 Android 设备上原生运行。

:beer: 有电脑的话，推荐用一键启动器

macOS / Windows 双平台，零依赖安装。手机党也可以先用启动器在电脑上跑起来，再用手机浏览器远程连接。

:arrow_right: 下载一键启动器

安装 Termux

提示

避免从 Google Play Store 安装 Termux，该版本已不再维护。建议使用 F-Droid（推荐）或 GitHub releases 获取最新版本。

从 F-Droid 或 GitHub releases 下载 Termux。
安装下载的 APK 文件。
打开 Termux 并运行您的第一个命令：
```
termux-change-repo
```
选择 "Mirror group" 并选择离您最近的服务器。您可以触摸屏幕或使用 Unexpected Keyboard 进行滑动手势操作。
更新 Termux：
```
pkg update && pkg upgrade
```

安装依赖项

安装所需的软件包：

pkg install git nodejs-lts nano

注意

如果您运行的是 32-bit Android，请查看下面的常见错误部分以了解额外的步骤。

安装 SillyTavern

克隆 SillyTavern 仓库（如何选择分支）：

Release 分支：

git clone https://github.com/SillyTavern/SillyTavern -b release

Staging 分支：

git clone https://github.com/SillyTavern/SillyTavern -b staging

运行 SillyTavern

要运行 SillyTavern，导航到克隆的目录并运行启动脚本：

cd ~/SillyTavern
bash start.sh

要更新 SillyTavern，导航到 SillyTavern 目录并运行：

cd ~/SillyTavern
git pull --rebase --autostash

请参阅下面的别名部分以创建快捷方式来简化此过程。

常见错误

Unsupported platform: android arm LEtime-web

32-bit Android 需要一个无法通过 npm 安装的外部依赖项。

使用以下命令安装它：

pkg install esbuild

然后继续执行上述安装步骤。

性能调优

说明

有关提高性能的一般提示，请参阅相应的 FAQ 部分。

由于 Android 设备的硬件限制，您可能需要调整以下 SillyTavern config.yaml 设置以获得更好的内存、存储和 CPU 使用率：

performance:
  # 避免加载所有角色数据直到需要时
  lazyLoadCharacters: true
  # 禁用磁盘缓存以减少存储使用
  useDiskCache: false
backups:
  chat:
    # 可选：禁用自动聊天备份以节省存储空间
    enabled: false

提示

使用 Termux 附带的 nano 文本编辑器来编辑 config.yaml 文件：nano ~/SillyTavern/config.yaml

可选：创建别名

您可以为常用命令创建快捷方式，以便更轻松地工作。

打开编辑器修改您的 .bashrc 文件：
```
nano ~/.bashrc
```

添加以下行来创建别名：

# 更新 Termux 软件包
alias pkgup="pkg update && pkg upgrade"
# 启动 SillyTavern
alias st='cd ~/SillyTavern && bash start.sh'
# 更新 SillyTavern
alias stup='cd ~/SillyTavern && git pull --rebase --autostash'

保存文件并退出编辑器（在 nano 中，按 CTRL + X，然后按 Y，然后按 Enter）。
要应用更改，运行：
```
source ~/.bashrc
```

现在您可以使用以下命令：

st 启动 SillyTavern
stup 更新 SillyTavern
pkgup 更新 Termux 软件包

来源、许可与维护

原文由 sillytaverncn.net 维护。本页面经站点运营方授权迁移并重新排版，不移除原文中的作者、贡献者和许可说明。

查看完整许可与致谢、迁移与链接修复记录、上游文档贡献者及 SillyTavern 官方文档。原文中的第三方项目各自保留其权利。