trailbase
SHA-256一个亚毫秒级、单文件自托管的 Firebase 替代品,集 REST 与实时 API、多数据库、WebAssembly 运行环境、认证和管理后台于一体,基于 Rust、SQLite 和 Wasmtime 构建。
更快更简单的 Firebase 替代品,一个可执行文件搞定后端。
核心功能
- 单文件可执行,部署超简单
- 亚毫秒级响应,无需额外缓存
- 类型安全的 REST 和实时 API
- 内置 WebAssembly 运行时,可编写自定义逻辑
- 支持多数据库、地理空间查询
避坑指南
- •目前处于 Alpha 阶段,可能存在不稳定或 API 变更。许可证为 OSL-3.0,虽然它宽松地定义“衍生作品”,但建议阅读并咨询律师。对 WebAssembly 组件的支持还在完善中。
适用场景
- 快速搭建后端为移动应用或 Web 应用提供 API
- 替代 Firebase 实现自托管,避免厂商锁定
- 需要低延迟实时通信的场景(如聊天、协作)
- 边缘计算或资源受限环境下的轻量后端
详细介绍
TrailBase 是一个基于 Rust、SQLite 和 Wasmtime 构建的单文件可执行后端,作为 Firebase 的开源替代品,提供亚毫秒级的类型安全 REST 和实时 API,支持多数据库、WebAssembly 运行时、地理空间数据、服务端渲染(SSR)、认证和管理界面。它消除了对专用缓存的需求,易于自托管。支持 Linux、macOS 和 Windows 的预编译二进制文件,也可通过 Docker 或一键安装脚本部署。客户端库覆盖 JavaScript/TypeScript、Dart/Flutter、Rust、C#/.NET、Swift、Kotlin、Go 和 Python。
常见问题与排障 (1)
故障排除为什么 TrailBase 仪表板会删除我在 config.textproto 中手动添加的 redirect_uri_allowlist 条目?
这是一个已知的bug,仪表盘的生成的proto代码会剥离未知的配置字段,因为其缺少用于redirect_uri_allowlist的UI元素。修复方案正在准备中,并将在下一个版本中发布。作为临时变通方案,如果依赖手动配置,请不要通过仪表盘保存认证设置,或者使用文件监听器在每次更改后重新注入相关行。
标签
快速上手
安装软件
双击下载的安装程序,按提示完成安装
下载:访问 GitHub Releases 页面或使用命令 curl -sSL https://trailbase.io/install.sh | bash
解压并运行:trail run(首次运行会自动创建管理员账户并打印凭据)
登录管理后台:打开 http://localhost:4000/_/admin/ 使用终端输出的凭据登录
- 下载:访问 GitHub Releases 页面或使用命令 curl -sSL https://trailbase.io/install.sh | bash
- 解压并运行:trail run(首次运行会自动创建管理员账户并打印凭据)
- 登录管理后台:打开 http://localhost:4000/_/admin/ 使用终端输出的凭据登录
已提供 SHA-256 校验码,下载后可自行核对文件完整性
该校验码提取自 GitHub 官方 Release 页面
SHA256 校验码
16fa50371f28d9a79acdd66d426478c1fd08d576041a5e871cca1e75987067a3该校验码提取自 GitHub Release 页面,下载后请自行核对文件完整性
本平台所有 SHA-256 校验码均提取自项目在 GitHub 官方 Release 页面发布的文件,未做任何修改。你可以通过 GitHub Releases 页面自行验证。
开源透明
查看 GitHub 源码卸载说明
直接删除可执行文件和生成的 traildepot 文件夹即可完全卸载。如果通过 Docker 部署,停止容器并删除镜像。
无额外依赖
下载后即可直接使用,无需安装其他运行环境
遇到问题?查看下方 FAQ
1 FAQ