Skip to content

安卓本地部署教程

说实话,一开始我也觉得在手机上部署酒馆听起来挺复杂的,但其实真的不难,跟着步骤走,你也能成功!

写在前面

  • 整个过程大概需要 10-30 分钟,取决于你的网速
  • 所有命令我都会告诉你怎么复制,不用担心输错
  • 如果遇到问题,可以拉到最后的常见问题部分看看

准备工作

在开始之前,你需要准备好这些东西:

必需软件:

  1. Termux - 这是一个安卓上的命令行工具,我们的酒馆就装在这里面
  2. MT 管理器 - 用来管理酒馆的文件,比如角色卡、背景图片之类的

手机要求:

  • 安卓系统
  • 至少 4GB 运存
  • 至少 10GB 存储空间

下载软件

Termux 下载:

⚠️ 重要提醒:不要在 Google Play 商店下载!那里的版本已经不更新了!

MT 管理器下载:

安装好后,MT 管理器如果提示更新,更新不更新都行,不影响使用。

小贴士

如果安装时提示"未知来源"权限,去手机设置里打开就好。不是每个手机都有这个提示。

开始安装

第一步:打开 Termux 更新软件

打开安装好的 Termux,你会看到一个黑黑的命令行界面,别慌,跟着我操作就好。

首先输入这个命令更新软件列表:

bash
yes | pkg update

这行命令在干什么?

就是让 Termux 去检查一下,看看有没有新版本的软件可用。yes | 的意思是如果弹出什么确认提示,就自动选"是",省得你手动输入。

执行后会看到一堆文字滚动,这是正常的。最后看到几个 Done 就表示成功了。

第二步:升级已安装的软件

接着输入:

bash
yes | pkg upgrade

这行命令在干什么?

把已经装好的软件升级到最新版,避免后面安装酒馆时出现依赖问题。

这一步可能会比较慢,耐心等待就好。

第三步:安装 Git(下载工具)

输入命令:

bash
yes | pkg install git

这行命令在干什么?

安装 Git,这是一个用来从网上下载代码的工具。没有它,我们就没办法下载酒馆的代码。

安装完后,可以输入这个验证一下:

bash
git -v

如果显示版本号(比如 git version 2.xx.x),就说明安装成功啦!

第四步:安装 Node.js(运行环境)

输入命令:

bash
yes | pkg install nodejs

这行命令在干什么?

安装 Node.js,这是运行酒馆必需的环境。简单来说,酒馆是用 JavaScript 写的,Node.js 就是让 JavaScript 能在手机上运行的工具。

同样可以验证一下:

bash
node -v

看到版本号就说明没问题了。

第五步:下载酒馆

这里有两个选择,看你的网络情况:

选择 1:如果你的网络可以访问 Google

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

这是从 GitHub 官方仓库下载,-b release 表示下载稳定版。

选择 2:如果网络不行(国内用户推荐)

bash
git clone https://gitee.com/laopobao/SillyTavern.git -b release

放心使用!这个是国内镜像站,代码和官方的一模一样,只是把服务器放到了国内,所以下载速度快。

怎么知道下载成功了?

看到显示 100%done 就表示下载完成了。

第六步:启动酒馆!

激动人心的时刻到了!

先进入酒馆文件夹:

bash
cd SillyTavern

然后启动酒馆:

bash
bash start.sh

第一次启动会比较慢,可能需要几分钟,不要着急。后面再启动就会快很多。

启动成功后:

正常情况下,手机会自动打开浏览器,进入酒馆的界面。如果没有自动打开,就自己打开浏览器,输入:

http://127.0.0.1:8000

看到这个界面就表示成功了!记得在设置里把语言改成中文哦~

重要提醒

千万要注意

  1. Termux 不能关! 酒馆运行的时候,Termux 必须保持打开状态,你可以把它挂在后台或者小窗显示。
  2. 电池优化要关掉! 很多手机会自动杀后台,建议去电池设置里,把 Termux 的后台限制改成"无限制"。
  3. 不能锁屏休眠! 手机锁屏后如果进入深度休眠,酒馆可能会断连。

日常使用

每次怎么启动?

最简单的方式,打开 Termux,输入:

bash
cd ~/SillyTavern && bash start.sh

这行命令的意思是:先进入酒馆文件夹,然后启动酒馆。

你可以把这行命令保存在手机备忘录里,每次复制粘贴就行。

怎么更新酒馆?

酒馆大概每月会更新一次,更新的方法:

bash
cd ~/SillyTavern && git pull && bash start.sh

这行命令会先下载最新版本,然后自动启动。

更偷懒的方式(推荐)

我平时用的是自定义命令,打开 Termux 只需要输入 qidong 就能启动,gengxin 就能更新,超级方便!

设置方法:

  1. 先退出 Termux(酒馆会停止运行)
  2. 重新打开 Termux
  3. 复制粘贴下面这段命令:
bash
cat << EOF > ~/.bashrc
function qidong() {
cd ~/SillyTavern && echo "正在启动酒馆" && sleep 1 && bash start.sh
}

function gengxin() {
cd ~/SillyTavern && echo "准备更新酒馆" && sleep 3 && git pull && echo "更新完成,准备启动" && sleep 2 && bash start.sh
}
EOF
  1. 然后输入:
bash
source ~/.bashrc

搞定!以后打开 Termux 直接输入 qidonggengxin 就行了,连命令都不用记了~

如果你想改成别的名字,比如 startupdate,可以把 qidonggengxin 替换掉。

常见问题

Q: Termux 总是被系统杀死怎么办?

试试这个命令:

bash
termux-wake-lock

这个可以防止 Termux 被系统杀掉。

Q: 怎么停止酒馆?

在 Termux 里按 Ctrl + C 就行了(手机键盘上通常有 Ctrl 键)。

Q: 下载速度太慢怎么办?

如果是用 GitHub 慢,就换成 Gitee 的国内镜像,速度会快很多。

Q: 存储空间不够了怎么办?

可以用 MT 管理器清理一下酒馆里的缓存文件,或者卸载不用的软件腾出空间。

最后想说

其实安卓部署酒馆真的很简单,只要你按部就班地来,肯定能成功!

如果遇到了什么奇怪的问题,或者想和其他玩家交流,欢迎来我们的 QQ 群:216189515

群里大家都很友好,有问题就问,不用害羞~


下一步:

本站由 白狐狸 基于 VitePress 构建