文档

在 Linux 服务器上把 Beluga 安装为常驻服务的要求和最新命令，以及如何从界面连接 Claude、Codex 或 Cursor。

归档通过支持窗口下载。同一份代码仍可从公开仓库自由克隆。

入门

六个命令即可安装

在 Linux 服务器上按顺序执行。它们会克隆公开仓库、构建应用、创建登录信息，并安装常驻服务和监控程序。

安装 Beluga
git clone https://github.com/haikostudio/belugabuildtool.git beluga
cd beluga
npm install
npm run build
node scripts/set-credentials.mjs
sudo scripts/installer-services.sh

之后 Beluga 会监听 127.0.0.1:7070。Caddy 等反向代理可通过 HTTPS 将它开放到你的域名。

01

一台持续运转的机器

需要一台 Debian 或 Ubuntu Linux 服务器、Node.js 22 或更高版本以及 git。只有公开 HTTPS 地址才需要 Caddy 等反向代理。

02

公开仓库

公开仓库可通过 HTTPS 直接克隆，无需邀请。本页提供的归档包含同一项目，适合希望直接下载的人。

03

服务器上的人工智能工具

至少安装一种支持的命令行工具：Claude Code、Codex 或 Cursor。启动助手会显示服务器上缺少什么。

04

您自己的账户

从界面连接 Claude 或 Codex，或者添加 Cursor 密钥。同一引擎的多个账户可按可用情况分担工作。

故障排除

当东西坏了的时候

最常出现的三个失败，每一个都回答为一行。

01

服务启动，然后停止

使用 systemctl 和 journalctl 查看状态与日志，找出阻塞服务的路径、用户或依赖。

02

构建因“tsc：未找到”而停止

执行 NODE_ENV=development npm install --include=dev 重新安装依赖，再运行 npm run build。

03

没有引擎可用

启动助手会说明是工具缺失，还是账户需要重新连接。按显示的命令操作，再返回界面。

准备好安装了吗？

下载归档或克隆公开仓库，然后按顺序执行六条命令。