Keragi 部署文档

Keragi 服务端由 wasmx 宿主与按需加载的 WASM 资源组成; Web 客户端是独立的静态前端。本文档只讲安装、配置、部署与运维,不包含源码。

快速部署

从下载页获取本地安装包,用最短步骤启动服务端宿主与 Web 客户端。

安装服务端

Linux x86_64 宿主安装、目录结构、初始化与启停。

运行环境与数据库

服务器平台支持范围、SQLite 默认数据库与其他平台/数据库计划。

开发与设备接入

自定义 WASM 资源(含简单示例),以及传感器、执行器、继电器等设备的接入方式与安全边界。

数据与安全

端到端加密与密钥边界、安全模型、服务端/客户端安全建议与免责声明。

数据存储

安全视角的数据存储:服务端只中转密文、客户端保存消息与密钥,以及删除数据的风险。

配置

wasmx.json、.env、端口、资源前缀与密钥配置。

WASM 资源包

按需安装核心资源、conn 连接器与 agix AI 引擎。

Web 客户端部署

部署 Web 前端静态产物,并连接你的服务端地址。

许可与收费

当前许可、后续可能的订阅或商业授权,以及版本升级和收费范围说明。

部署示例

一台 Linux 机器的完整部署示例与验证步骤。

获取安装包

可以在下载页获取服务端宿主、WASM 资源包和 Web 客户端静态产物, npm 目前提供宿主与 userx;其他资源包请在后续版本使用 npm,当前请使用下载页的 .tgz 离线安装。

当前服务端宿主仅支持 Linux x86_64,数据库默认使用 SQLite; Windows、macOS、Linux ARM64、ESP32 与外部数据库将在后续版本支持,详见运行环境与数据库。 桌面 / Android 客户端敬请期待。