HiveCode · Linux 节点

安装 Headless Runtime

让 Linux 主机持续运行项目和智能体，从手机或浏览器连接同一工作现场。

Ubuntu 20.04+、Debian 11+ 使用 DEB；CentOS Stream 9/10、openEuler 22.03/24.03 使用独立包，需通过目标主机能力检测。要求 x64 / ARM64、glibc ≥ 2.31、运行中的 systemd 及用户总线。CentOS 7、openEuler 20.03 不支持。安装时使用 root 或具备 sudo 权限的账户，并保持网络连接。

一键安装 · Beta

服务器处理器架构服务器操作系统

正在查询 Runtime 安装包…

方式一：一键脚本

方式二：npm

已有 Node.js 18+ 和 npm 时使用。两种入口安装同一个 Runtime；默认自动选择 DEB 或独立包，后台运行使用独立安装目录。

npx --yes @hivecode/install --headless

正在查询 npm 安装器发布状态…

需要手动选择时，可向安装器传入 --method deb 或 --method standalone；默认 --method auto --channel beta。脚本传参示例：curl -fsSL https://hivekernel.com/install.sh | bash -s -- --method standalone。更换安装方式前请先卸载原安装，保留项目和状态数据。

查看安装脚本 ↗下载安装脚本 ↓

连接你的账号

安装后在服务器执行以下命令，按提示在浏览器中登录并完成节点认领：

sudo -u hivecode-runtime -H /usr/local/bin/hivecode-runtime runtime claim

使用 root 直接安装且没有 sudo 时，可执行 runuser -u hivecode-runtime -- /usr/local/bin/hivecode-runtime runtime claim。认领后进入控制台，选择在线节点。第三方智能体仍需安装并完成对应服务授权。

进入控制台 ↗

配置与更新

服务配置位于 /etc/hivecode/runtime.env，运行状态保存在 /var/lib/hivecode-runtime。项目目录需允许 hivecode-runtime 账户访问。修改配置后执行 sudo systemctl restart hivecode-runtime.service。更新时重新运行上方安装命令。

停止或卸载

停止服务：sudo systemctl stop hivecode-runtime.service。卸载 DEB：sudo apt-get remove hivecode-runtime；卸载独立包：sudo /opt/hivecode-runtime/uninstall.sh。两者均保留项目和状态数据。以 root 操作时可省略 sudo。