Getting Started
快速开始
了解 RaisFast 所需的一切，快速上手运行。
什么是 RaisFast？
RaisFast 是一个基于 Rust 的 Headless CMS 和后端即服务引擎。编译为单一二进制文件，零运行时依赖，开箱即用提供博客、电商、钱包、支付和多租户 SaaS 能力。
核心特性
- 单二进制 — 零部署摩擦，无运行时依赖
- 极致性能 — 基于 Rust、Axum 和 SQLx 构建
- 多数据库 — SQLite、PostgreSQL、MySQL 零代码切换
- 插件引擎 — JavaScript (QuickJS)、Rhai、Lua、WASM 四种运行时
- 内置模块 — 博客、页面、媒体、电商、钱包、支付、工作流
- 动态内容类型 — TOML 定义 Schema，自动生成 CRUD API
- 多租户 — 基于请求头或域名的租户隔离，支持 SaaS
- 管理后台 — 内嵌 React 管理面板，无需单独部署
技术栈
| 层级 | 技术 |
|---|---|
| 语言 | Rust (edition 2024) |
| HTTP 框架 | Axum 0.8 |
| 数据库 | SQLx 0.8 (SQLite / PostgreSQL / MySQL) |
| 认证 | JWT (HS256) + Argon2 |
| 搜索 | Tantivy |
| 插件运行时 | wasmtime / rquickjs / mlua / rhai |
| 管理后台 | React 19 + shadcn/ui (rust-embed 内嵌) |
| ID 生成 | Snowflake (ferroid) + base62 编码 |
架构概览
┌──────────────────────────────────┐
│ RaisFast 二进制 │
│ ┌────────┐ ┌────────────────┐ │
HTTP ─────────► │ │ Axum │ │ 管理后台 SPA │ │
(9898) │ │ 路由器 │ │ (rust-embed) │ │
│ └───┬────┘ └────────────────┘ │
│ │ │
│ ┌───▼────────────────────────┐ │
│ │ Handler → Service → Model │ │
│ └──┬──────┬──────┬──────┬────┘ │
│ │ │ │ │ │
│ ┌──▼──┐┌──▼──┐┌──▼──┐┌──▼───┐ │
│ │ 数据库││缓存 ││搜索 ││存储 │ │
│ └─────┘└─────┘└─────┘└──────┘ │
│ ┌──────┐ ┌─────────┐ ┌───────┐ │
│ │插件引擎││ 任务队列 ││事件总线│ │
│ └──────┘ └─────────┘ └───────┘ │
└──────────────────────────────────┘