Linux 一键安装

0.2.9-rc.4 Linux 发行版。 本页下载指向 rc.4，保留此前四项安装／就绪修复，并修复 Issue #17 上下文恢复。安装请使用新目录，本版不扩展跨版本原地升级范围。

首次启动默认等待最多 600 秒。若提示“still preparing”，进程仍保留，重新运行 NextTavern.sh 或安装器的 --action start 可继续等待同一个进程；需要停止时使用 NextTavern.sh stop 或安装器的 --action stop。更慢的存储可在启动前设置 NEXTTAVERN_READY_TIMEOUT_MS 为正整数毫秒，例如 900000；它只控制安装器就绪等待，与模型首响应设置分别生效。

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

NextTavern-Setup.sh 是 0.2.9 的 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 会直接说明原因并停止，不会装到一半失败。

安装

先从下载取得 0.2.9 脚本。全新安装运行：

sh NextTavern-Setup.sh

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

从 0.2.5 迁移请先导出并使用新目录。 旧会话不兼容，小说稿不包含完整状态。保留旧 home／workspace 备份，使用 --root "$HOME/NextTavern-0.2.9" 建立新安装，不复制旧会话数据库。再次运行脚本时也须传入同一个新根目录；默认路径如果已有旧安装，不能用它当作本次迁移路径。

已有 0.2.8 的玩家请按首页的官方插件更新流程操作。0.2.9 保持同一宿主与会话线，本补丁未新增安装器原地升级能力。

常用参数：

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 --root "$HOME/NextTavern-0.2.9" --action stop；根目录须与实际安装一致。

仅停用或卸载插件： 使用官方设置里的 dsh-nexttavern 总开关，或停服务后在该安装的 DSH_HOME 下运行 dsh plugin --profile web remove dsh-nexttavern。详情见更新、卸载与回滚。受控卸载保留用户资料，不删除整个目录。

回到旧版： 停止新服务，使用保留的旧安装及对应备份；不要混用两个实例的会话、receipt 和 pin，新会话不能转换为旧会话。

完全删除便携安装： 先停止服务，单独备份根目录内的 home 与 workspace，再删除该安装的桌面条目、启动器和根目录。默认桌面条目是 ~/.local/share/applications/nexttavern.desktop、nexttavern-stop.desktop 及 ~/Desktop/NextTavern.desktop。删除根目录会连同故事、角色卡、笔记、导出文件与模型配置一起删除。

我们还不能保证的事

构建支持不等于真机验收。 本轮没有在干净 Linux x86_64／aarch64 环境逐一验证安装器；服务器实际安装使用官方插件路径，不能替代这些检查。
不支持 musl 发行版。 Alpine 等系统请自行安装 Node.js 22+ 并使用手动安装。
安装需要网络。 首次安装要下载便携运行时、主包与依赖；本版没有承诺完整离线安装。
桌面图标依赖桌面环境。 脚本写入的是标准 XDG 条目，但不保证每个桌面环境都会立刻刷新。
本机服务不代表公网可用。 想从手机或外网访问，请按手机电脑公网访问指南显式配置。

下载

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

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