安装

本指南面向负责安装 Trove 的人员，无需编程经验。

所需条件

• 运行 Linux 的计算机（推荐 Ubuntu 22.04 或更高版本）
• 至少 4 GB RAM（8 GB 或更多更佳）
• 至少 10 GB 可用磁盘空间
• 仅安装期间需要互联网连接——之后 Trove 完全离线运行

第一步 — 安装 Trove

打开终端并运行：

curl -LsSf https://raw.githubusercontent.com/stur86/trove/main/install.sh | bash

这将下载安装程序，获取最新版本的 Trove 并完成配置。需要几分钟。

之后提示命令未找到？

如果安装程序完成后看到 trove: command not found，运行其打印的命令（类似 export PATH="$HOME/.local/bin:$PATH"），然后打开新的终端窗口。

第二步 — 运行安装向导

在刚刚安装 Trove 的同一台计算机上运行安装向导。安装页面只能从该计算机访问——这是有意为之。

trove setup

然后在同一台计算机上打开浏览器并访问：

http://localhost:7071

向导将引导您完成六个步骤：

1. 语言 — 选择界面语言
2. 欢迎 — 确认您的硬件以及 Trove 将安装的内容
3. 安装 Ollama — 下载 AI 运行时（如已安装则跳过）
4. 选择模型 — 选择 Gemma 4 模型；只显示您的硬件可以运行的模型。此步骤需要互联网连接，可能需要 10–30 分钟。
5. 管理员账户 — 为管理面板设置用户名和密码
6. 安装服务 — 注册 Trove 以在启动时自动运行

完成后，仪表板会显示要提供给用户的地址。

第三步 — 为用户提供可靠的地址

Trove 启动时会显示类似 http://192.168.1.42:7770 的地址。其他设备的用户在任意浏览器中打开它——无需安装应用。

地址可能会改变，因为家用和办公路由器会自动重新分配地址。如果地址改变，用户会看到"无法访问该网站"的错误。

通过静态 IP 解决此问题

为服务器计算机设置固定（"静态"）IP 地址可防止地址改变。只需在路由器设置中操作一次。

1. 打开路由器管理页面——通常是 http://192.168.1.1 或 http://192.168.0.1（查看路由器上的标签）。
2. 找到名为 DHCP、LAN 或 IP 预留的部分。
3. 在已连接设备列表中找到 Trove 服务器，为其分配固定地址。
4. 保存并在提示时重启路由器。

如需帮助，请联系您的 IT 支持——这是一项常规任务。

启动和停止 Trove

如果在安装时安装了服务，Trove 会在启动时自动运行。也可以手动控制：

systemctl --user status trove    # 检查是否在运行
systemctl --user restart trove   # 重启
systemctl --user stop trove      # 停止

如果跳过了服务，在需要时手动启动 Trove：

trove start

按 Ctrl + C 停止。要使服务在无人登录时也保持运行（对无图形界面的服务器有用）：

loginctl enable-linger $USER   # 一次性设置; 可能需要 sudo

模型选择指南

模型	最低 RAM	音频	最适合
Gemma 4 E2B	4 GB	是	配置较低的计算机，响应最快
Gemma 4 E4B	6 GB	是	均衡——推荐的默认选项
Gemma 4 26B	10 GB	否	更好的质量，速度与 E4B 相近
Gemma 4 31B	20 GB	否	最高质量，需要高性能计算机

故障排除

"trove: command not found" 运行 export PATH="$HOME/.local/bin:$PATH" 后重试。要永久生效，将该行添加到 ~/.bashrc。

安装页面无法加载 确保您在运行 trove setup 的同一台计算机上，且该命令仍在终端中运行。

其他设备无法访问 Trove 检查 trove start（或服务）是否正在运行。确保所有设备在同一 Wi-Fi 或有线网络中。如果地址持续变化，请在路由器上设置静态 IP（见第三步）。

模型下载非常慢 根据网络连接情况，首次下载可能需要 10–30 分钟。只会发生一次。