运行环境与数据库
Keragi 服务端由 wasmx 宿主运行 WASM 资源。宿主是原生二进制，平台与数据库能力由宿主决定；WASM 资源本身与 CPU 架构无关。
1. 服务器平台
当前版本只发布 Linux x86_64 宿主。
| 平台 | 状态 | 说明 |
|---|---|---|
| Linux x86_64 | 支持 | 裸机、虚拟机、容器均可 |
| Linux ARM64 | 后续版本 | 规划中 |
| Windows x86_64 | 后续版本 | 规划中 |
| macOS（Intel / Apple Silicon） | 后续版本 | 规划中 |
| ESP32 / 嵌入式设备 | 暂不支持 | 运行环境与资源模型不同，需要专门适配 |
| 其他服务器架构 | 敬请期待 | 按实际需求评估 |
- 下载页只提供 Linux x86_64 安装包。
- Node.js 只用于安装壳
@keragi/wasmx；宿主运行时不依赖 Node.js。 - 同一台 Linux 机器可以运行多个宿主实例（例如主服务器 + 连接器服务器），但需要为每个实例配置不同的端口、数据库目录和
JWT_SECRET使用方式（连接器需与主服务器一致）。
2. 数据库
当前版本默认使用 SQLite，不需要额外安装或维护数据库服务。
- 配置项：
WASMX_DB=sqlite://data/keragi.db - 数据库文件位于部署目录的
data/ - 不同 WASM 资源会使用各自独立的 SQLite 文件（例如
data/userx.db、data/conn.db） - 备份：停止服务后备份整个
data/目录即可 - 单机部署、小团队或中等并发场景，默认 SQLite 配置即可满足
其他数据库的支持计划：
| 数据库 | 状态 |
|---|---|
| SQLite | 默认支持 |
| PostgreSQL | 后续版本 |
| MySQL / MariaDB | 后续版本 |
| 其他数据库 | 敬请期待 |
当前版本只支持
sqlite://连接串。请不要把WASMX_DB指向 PostgreSQL / MySQL，否则宿主会启动失败；外部数据库支持将在后续版本提供。