免费 Termux (0.118.1) 下安装 SillyTavern（带 CLEWD 支持）及数据备份教程 - 零基础小白版 资源荟萃

[Scare]

​

Termux (0.118.1) 下安装 SillyTavern（带 CLEWD 支持）及数据备份教程 - 零基础小白版
引言：
欢迎来到SillyTavern的安装教程！SillyTavern是一款功能强大的开源聊天机器人前端界面，而CLEWD则为它提供了更灵活的API管理和上下文控制。本教程专为零基础小白用户设计，将手把手带您在Android Termux环境中完成SillyTavern和CLEWD的安装与配置。
[此处插入SillyTavern界面截图 - 图片占位符：SillyTavern_Screenshot]
1. 准备工作

• 1.1 Termux安装与基本配置
  • 步骤1：下载安装Termux 0.118.1
    • 您可以从F-Droid应用商店或GitHub发布页面下载Termux 0.118.1版本的APK文件。（提供下载链接）
    • 安装完成后，打开Termux应用。
    • [此处插入从F-Droid下载Termux的截图 - 图片占位符：Termux_Download_FDroid]
  • 步骤2：初始化设置
    • 首次启动Termux时，会进行初始化设置。请耐心等待，并按照提示授予Termux必要的存储权限。
    • [此处插入Termux请求存储权限的截图 - 图片占位符：Termux_Storage_Permission]
  • 步骤3：更换软件源 (推荐)
    • 为了提高下载速度，建议更换为国内的Termux软件源。执行以下命令：
      
      termux-change-repo
      
      
    • 选择合适的软件源镜像，例如清华大学或中科大镜像。
    • [此处插入termux-change-repo命令执行后的截图 - 图片占位符：Termux_Change_Repo]
• 1.2 安装基础环境
  • 步骤1：更新软件包列表
    • 执行命令：
      
      pkg update && pkg upgrade
      
      
    • pkg update 用于更新软件包列表，pkg upgrade 用于升级已安装的软件包。
    • [此处插入pkg update && pkg upgrade命令执行后的截图 - 图片占位符：Termux_Update_Upgrade]
  • 步骤2：安装必要软件包
    • 执行命令：
      
      pkg install git nodejs python ffmpeg
      
      
    • git 用于版本控制，nodejs 用于运行JavaScript，python 用于运行Python脚本，ffmpeg 用于处理多媒体文件。
    • [此处插入pkg install命令执行后的截图 - 图片占位符：Termux_Install_Packages]
• 1.3 安装Python虚拟环境工具 (推荐)
  • 步骤1：安装virtualenv
    • 执行命令：
      
      pip install virtualenv
      
      
    • virtualenv 可以创建独立的Python环境，避免不同项目之间的依赖冲突。
    • [此处插入pip install virtualenv命令执行后的截图 - 图片占位符：Termux_Install_Virtualenv]

2. 安装 SillyTavern

• 2.1 克隆项目代码
  • 步骤1：克隆SillyTavern仓库
    • 执行命令：
      
      git clone GitHub - SillyTavern/SillyTavern: LLM Frontend for Power Users.
      
      
    • git clone 命令会将SillyTavern的代码下载到您的Termux环境中。
    • [此处插入git clone命令执行后的截图 - 图片占位符：Termux_Clone_SillyTavern]
  • 步骤2：进入SillyTavern目录
    • 执行命令：
      
      cd SillyTavern
      
      
    • cd 命令用于切换当前目录。
    • [此处插入cd SillyTavern命令执行后的截图 - 图片占位符：Termux_CD_SillyTavern]
• 2.2 安装依赖
  • 步骤1：创建虚拟环境 (可选)
    • 如果您安装了virtualenv，可以创建一个独立的Python环境：
      
      virtualenv env
      
      
    • [此处插入virtualenv env命令执行后的截图 - 图片占位符：Termux_Create_Virtualenv]
  • 步骤2：激活虚拟环境 (可选)
    • 执行命令激活虚拟环境：
      
      source env/bin/activate
      
      
    • [此处插入source env/bin/activate命令执行后的截图 - 图片占位符：Termux_Activate_Virtualenv]
  • 步骤3：安装npm依赖
    • 执行命令：
      
      npm install
      
      
    • npm install 命令会下载并安装SillyTavern运行所需的所有依赖包。请耐心等待安装完成。
    • [此处插入npm install命令执行后的截图 - 图片占位符：Termux_Install_NPM_Dependencies]

3. 安装 CLEWD 支持

• 3.1 克隆 CLEWD 仓库
  • 步骤1：返回上一级目录
    • 执行命令：
      
      cd ..
      
      
    • [此处插入cd …命令执行后的截图 - 图片占位符：Termux_CD_Parent]
  • 步骤2：克隆CLEWD仓库
    • 执行命令：
      
      git clone https://github.com/CLEWD/CLEWD.git
      
      
    • [此处插入git clone CLEWD命令执行后的截图 - 图片占位符：Termux_Clone_CLEWD]
  • 步骤3：进入CLEWD目录
    • 执行命令：
      
      cd CLEWD
      
      
    • [此处插入cd CLEWD命令执行后的截图 - 图片占位符：Termux_CD_CLEWD]
• 3.2 安装依赖
  • 步骤1：安装npm依赖
    • 执行命令：
      
      npm install
      
      
    • [此处插入CLEWD npm install命令执行后的截图 - 图片占位符：Termux_Install_CLEWD_Dependencies]
• 3.3 配置 CLEWD
  • 步骤1：启动CLEWD服务
    • 执行命令：
      
      node clewd.js
      
      
    • CLEWD服务启动后，会显示运行地址，默认为 http://localhost:8181。 请记住这个地址。
    • [此处插入node clewd.js命令执行后的截图 - 图片占位符：Termux_Start_CLEWD]

4. 配置 SillyTavern

• 4.1 进入 SillyTavern 项目目录
  • 步骤1：切换目录
    • 执行命令：
      
      cd ../SillyTavern
      
      
    • [此处插入cd …/SillyTavern命令执行后的截图 - 图片占位符：Termux_CD_SillyTavern_Again]
• 4.2 启动 SillyTavern
  • 步骤1：启动SillyTavern
    • 执行命令：
      
      npm start
      
      
    • SillyTavern启动后，会提示访问地址，默认为 http://localhost:8000。
    • [此处插入npm start命令执行后的截图 - 图片占位符：Termux_Start_SillyTavern]
• 4.3 连接 CLEWD
  • 步骤1：打开SillyTavern设置
    • 在浏览器中访问 http://localhost:8000，进入SillyTavern界面。
    • 找到并点击“设置”或“Settings”选项。
    • [此处插入SillyTavern设置界面截图 - 图片占位符：SillyTavern_Settings]
  • 步骤2：配置API扩展
    • 在设置界面中找到“API扩展”或类似的选项。
    • 在API扩展设置中，输入CLEWD服务的地址，例如 http://localhost:8181。
    • 点击保存或应用设置。
    • [此处插入SillyTavern API扩展设置截图 - 图片占位符：SillyTavern_API_Extension]

5. 启动和使用

• 5.1 每次启动步骤
  • 步骤1：启动CLEWD
    
    cd ~/CLEWD; node clewd
    
    • [此处插入简化启动CLEWD命令执行后的截图 - 图片占位符：Termux_Simplified_Start_CLEWD]
  • 步骤2：启动SillyTavern
    
    cd ~/SillyTavern; npm start
    
    • [此处插入简化启动SillyTavern命令执行后的截图 - 图片占位符：Termux_Simplified_Start_SillyTavern]
  • 步骤3：访问SillyTavern
    • 在浏览器中访问 http://localhost:8000。
• 5.2 自定义启动脚本 (简化启动)
  • 步骤1：创建启动脚本
    • 执行命令创建脚本文件：
      
      nano ~/start_sillytavern.sh
      
      
    • [此处插入nano ~/start_sillytavern.sh命令执行后的截图 - 图片占位符：Termux_Create_Start_Script]
  • 步骤2：编辑脚本内容
    • 在nano编辑器中，输入以下内容：
      
      #!/data/data/com.termux/files/usr/bin/bash
      # 启动 CLEWD
      cd ~/CLEWD
      nohup node clewd.js > ~/clewd.log 2>&1 &
      # 启动 SillyTavern
      cd ~/SillyTavern
      nohup npm start > ~/sillytavern.log 2>&1 &
      echo "SillyTavern 和 CLEWD 已启动！"
      
      
    • [此处插入编辑启动脚本的截图 - 图片占位符：Termux_Edit_Start_Script]
    • 解释：
      • #!/data/data/com.termux/files/usr/bin/bash 指定脚本解释器。
      • nohup ... & 命令让程序在后台运行，即使关闭Termux也不会停止。
      • > ~/clewd.log 2>&1 将CLEWD的输出重定向到clewd.log文件。
      • > ~/sillytavern.log 2>&1 将SillyTavern的输出重定向到sillytavern.log文件。
  • 步骤3：保存脚本并退出
    • 按 Ctrl + O 保存，按 Enter 确认文件名，按 Ctrl + X 退出nano编辑器。
  • 步骤4：赋予脚本执行权限
    • 执行命令：
      
      chmod +x ~/start_sillytavern.sh
      
      
    • [此处插入chmod +x ~/start_sillytavern.sh命令执行后的截图 - 图片占位符：Termux_Chmod_Start_Script]
  • 步骤5：手动启动脚本
    • 执行命令：
      
      ~/start_sillytavern.sh
      
      
    • [此处插入~/start_sillytavern.sh命令执行后的截图 - 图片占位符：Termux_Run_Start_Script]
  • 步骤6：设置脚本开机自启 (可选)
    • 编辑 ~/.bashrc 文件：
      
      nano ~/.bashrc
      
      
    • 在文件末尾添加一行：
      
      ~/start_sillytavern.sh
      
      
    • [此处插入编辑~/.bashrc文件的截图 - 图片占位符：Termux_Edit_Bashrc]
    • 保存并退出，然后重新启动Termux，脚本将自动运行。

6. 数据备份教程

• 6.1 SillyTavern数据备份
  • 步骤1：找到数据目录
    • SillyTavern的数据默认存储在 ~/SillyTavern/public/chats 目录。
    • [此处插入SillyTavern数据目录的截图 - 图片占位符：SillyTavern_Data_Directory]
  • 步骤2：使用Termux文件管理器备份
    • 执行 termux-setup-storage 命令，授予Termux访问存储的权限。
    • [此处插入termux-setup-storage命令执行后的截图 - 图片占位符：Termux_Setup_Storage]
    • 使用 cp 命令复制 chats 目录到其他位置：
      
      cp -r ~/SillyTavern/public/chats /sdcard/SillyTavern_Backup
      
      • 将 /sdcard/SillyTavern_Backup 替换为您希望备份到的路径。
    • [此处插入cp命令备份SillyTavern数据的截图 - 图片占位符：Termux_Backup_SillyTavern_Data]
  • 步骤3：使用第三方文件管理器备份
    • 您也可以使用Android的第三方文件管理器（如ES文件浏览器、Solid Explorer等）访问Termux的家目录 (~/)，找到 SillyTavern/public/chats 目录并手动复制到其他位置。
  • 建议： 将备份数据保存到外部存储卡、云盘（如Google Drive、Dropbox）或电脑上。
• 6.2 CLEWD数据备份 (可选)
  • 如果CLEWD有重要的配置或数据需要备份，请参考CLEWD的文档了解其数据存储位置，并使用类似的方法进行备份。

7. 常见问题及图文解决

• Q1: CLEWD服务无法启动
  • 问题原因： 端口 8181 被占用 或 依赖安装错误。
  • 解决方法1：检查端口占用
    • 执行命令查看端口占用情况：
      
      netstat -tulnp | grep 8181
      
      
    • 如果端口被占用，尝试关闭占用端口的程序或更改CLEWD的端口号。
    • [此处插入netstat命令检查端口占用的截图 - 图片占位符：Termux_Check_Port_Usage]
  • 解决方法2：重新安装依赖
    • 进入CLEWD目录：
      
      cd ~/CLEWD
      
      
    • 删除 node_modules 目录：
      
      rm -rf node_modules
      
      
    • 重新安装依赖：
      
      npm install
      
      
    • [此处插入重新安装CLEWD依赖的截图 - 图片占位符：Termux_Reinstall_CLEWD_Dependencies]
• Q2: Termux内存不足
  • 问题原因： Termux应用存储空间不足。
  • 解决方法：使用Termux:API将数据转移到外部存储。
    • 安装Termux:API：
      
      pkg install termux-api
      
      
    • 执行命令创建符号链接：
      
      termux-setup-storage
      ln -s /sdcard/termux-data ~/termux-data
      
      
    • 将SillyTavern和CLEWD的数据目录移动到 ~/termux-data 目录下。
    • [此处插入使用Termux:API转移数据的截图 - 图片占位符：Termux_Move_Data_External]
• Q3: 如何升级 SillyTavern 或 CLEWD？
  • 步骤1：进入对应目录
    • 进入SillyTavern目录：
      
      cd ~/SillyTavern
      
      
    • 或进入CLEWD目录：
      
      cd ~/CLEWD
      
  • 步骤2：使用git拉取最新代码
    • 执行命令：
      
      git pull
      
      
    • [此处插入git pull命令执行后的截图 - 图片占位符：Termux_Git_Pull]
  • 步骤3：重新安装依赖
    • 执行命令：
      
      npm install
      
      
    • [此处插入重新安装依赖的截图 - 图片占位符：Termux_Reinstall_Dependencies_After_Update]

结尾：
希望本教程能够帮助您顺利在Termux上安装和使用SillyTavern及CLEWD。如果您在操作过程中遇到任何问题，欢迎随时提问！