Linux 一键安装

返回首页 · Windows 安装 · 手动安装 · 反馈问题

NextTavern-Setup.sh 是 0.2.5 新增的 Linux 一键安装脚本。它是一个自包含的 shell 脚本：不需要预装 Node.js，不需要 root，也不需要系统包管理器——脚本自己下载并校验一份便携的 Node.js 运行时，然后把工作区、桌面入口和启动／停止入口准备好。

需要什么，不需要什么

需要	不需要
一个 POSIX shell（`sh` 即可）。	不需要 root 或 `sudo`。
`curl` 或 `wget`（二者有其一）。	不需要 `apt`／`dnf`／`pacman` 等系统包管理器。
`tar`，以及 `sha256sum`、`shasum` 或 `openssl` 中的任意一个。	不需要预装 Node.js，也不受系统 Node 版本影响。
可用的网络（首次安装需要下载运行时和主包）。	不需要 Visual C++ 运行库之类的 Windows 特有依赖。

支持范围：x86_64 与 aarch64，glibc 发行版。 基于 musl 的发行版（例如 Alpine）不在支持范围内，脚本检测到 /etc/alpine-release 会直接说明原因并停止，不会装到一半失败。

安装

一条命令即可：

sh NextTavern-Setup.sh

脚本会依次做这些事：检查架构与基本工具 → 下载便携 Node.js 运行时并校验 SHA-256 → 解压到安装目录的 runtime 下 → 准备 harness、home、workspace 等目录 → 启动本地服务并打开浏览器。第一次进入时，按提示选择工作区、填写自己的模型供应商，然后在新建会话的预设菜单里切到“角色扮演模式”。

再次运行同一个脚本不会重装：如果已经装好了，它会直接打开现有安装。

常用参数：

sh NextTavern-Setup.sh --root "$HOME/NextTavern"   # 换一个安装目录
sh NextTavern-Setup.sh --proxy http://127.0.0.1:7890   # 走代理下载
sh NextTavern-Setup.sh --source github   # 用 GitHub 源而不是镜像
sh NextTavern-Setup.sh --action stop   # 停止服务
sh NextTavern-Setup.sh --help   # 查看全部参数

另有 --no-open（不自动打开浏览器）与 --no-shortcut（不创建桌面入口）。

安装到哪儿

默认安装到 ~/.local/share/NextTavern（遵循 XDG_DATA_HOME，可用 --root 覆盖）。

目录	用途
`runtime`	便携 Node.js 运行时、安装配方与启动引擎。
`harness`、`home`	本地服务本体，以及你的 DSH 配置目录。
`workspace`	角色扮演工作区：角色卡、故事资源和导出文件。
`downloads`	已下载并校验过的文件，重试与再次安装时复用。
`logs`	安装与服务日志。
`backups`、`temp`	升级备份与临时文件。

安装目录里还会生成 NextTavern.sh，它是有执行权限的启动器：直接运行它是启动，./NextTavern.sh stop 是停止。

桌面入口与启停

安装后会在 ~/.local/share/applications 写入两个桌面条目：

NextTavern —— 启动服务并打开浏览器。
Stop Next Tavern —— 停止后台服务。

如果你的 ~/Desktop 目录存在，脚本还会在那里放一份 NextTavern.desktop 副本。桌面环境对 .desktop 文件的支持各有差异；如果图标没有立刻出现，注销再登录一次，或者直接使用安装目录里的 NextTavern.sh。

停止服务也可以直接在终端里做：

sh NextTavern-Setup.sh --action stop

停止时不会删除任何故事、笔记或设置。

下载来源、代理与缓存

来源：默认走镜像源，通常更稳定；--source github 可切换到 GitHub 直连。
代理：--proxy 传入的地址会同时用于运行时下载和后续的依赖安装，并记录在生成的启动器里。
缓存：Node.js 运行时会按 SHA-256 校验后才解压；校验通过的文件留在 downloads 下，重复安装或重试时直接复用。

如果下载中断或校验失败，脚本会依次尝试镜像和官方来源，全部失败时给出明确提示并保留已下载的文件——填好 --proxy 后重跑同一条命令即可继续，不用重新下载。

端口与日志

端口。 服务只监听 127.0.0.1，端口在 3510–3599 之间自动选择一个空闲值，并写入安装根目录的 running.json。脚本不提供固定端口参数；如果你需要固定端口（例如做反向代理转发），请改走手动安装路径，在那里可以显式指定 --port。

日志。 都在安装根目录的 logs 下：

文件	内容
`install.log`	安装各阶段的记录。
`server.stdout.log`	本地服务的标准输出，启动地址也在其中。
`server.stderr.log`	本地服务的错误输出。
`launcher.log`	通过桌面入口或启动器启动时的输出。

如果启动失败，脚本会提示服务已退出或未在 90 秒内就绪，此时先看 logs/server.stderr.log。

卸载与回滚

停止：用 Stop Next Tavern 桌面条目，或 sh NextTavern-Setup.sh --action stop。

卸载：停服务后，删除 ~/.local/share/applications/nexttavern.desktop、nexttavern-stop.desktop 以及 ~/Desktop/NextTavern.desktop，再删除整个安装根目录。

你的故事在哪。 角色卡、故事文本、笔记、导出文件和模型配置都在安装根目录的 workspace 与 home 里；删除安装目录会一并删除它们，想保留内容就先单独备份这两个目录。

我们还不能保证的事

这个安装器是 0.2.5 新增的。 上面列出的架构与发行版范围就是已经测试过的范围；其他发行版、其他架构或容器环境没有逐一验证。
不支持 musl 发行版。 Alpine 等系统请自行安装 Node.js 22+ 并使用手动安装。
安装需要网络。 首次安装要下载便携运行时与主包，离线环境请走手动安装。
桌面图标依赖桌面环境。 脚本写入的是标准 XDG 条目，但不保证每个桌面环境都会立刻刷新。
本机服务不代表公网可用。 想从手机或外网访问，请按手机电脑公网访问指南显式配置。

下载

下载后先校验再运行是个好习惯：

sha256sum NextTavern-Setup.sh   # 与 SHA256SUMS 中的对应行比对
sh NextTavern-Setup.sh