
核心定位
PocketBase 是一个开源后端解决方案,将实时数据库、身份认证、文件存储和管理后台整合进单个可执行文件。它面向需要快速搭建后端能力的开发者,无需配置多套服务即可获得基础数据管理功能。
主要能力
实时数据库
内置基于 SQLite 的数据层,支持通过 SDK 或 REST API 进行 CRUD 操作。数据变更可通过实时订阅推送到客户端,适用于协作编辑、即时消息、看板等需要同步状态的场景。字段类型涵盖文本、数字、布尔、日期、文件、关系等常见需求。
认证体系
提供邮箱密码、OAuth2(Google、GitHub、Facebook 等)、匿名认证等方式。认证状态与数据访问规则直接关联,可在集合级别定义读写权限。令牌管理、密码重置、邮箱验证等功能已内置,无需额外集成。
文件存储
文件字段与数据记录绑定,上传后自动处理存储与访问路径。本地部署时文件保存在服务器磁盘,也可对接 S3 兼容的对象存储。图片支持动态缩放与裁剪参数。
管理后台
自带 Web 管理界面,用于创建集合、定义字段、编辑数据、管理用户、查看日志。非技术人员也能通过该界面维护内容,降低运营协作成本。
部署与扩展
| 项目 | 说明 |
|---|---|
| 形态 | 单个二进制文件,无外部依赖 |
| 运行方式 | 直接执行,或作为 Go 框架库嵌入 |
| 扩展方式 | 通过 Go 编写自定义路由、钩子、迁移 |
| 适用环境 | Linux、macOS、Windows,支持 Docker |
PocketBase 以 Go 语言编写,编译后不依赖运行时环境。部署时只需上传一个文件并启动进程,适合轻量级项目、原型验证或内部工具。对于复杂业务逻辑,可通过 Go 代码扩展,但需注意其扩展机制与常规框架存在差异。
适用边界
PocketBase 适合以下场景:
- 中小型项目、MVP 原型、内部管理系统
- 需要实时数据同步但不想自建 WebSocket 基础设施
- 团队规模较小,希望减少后端运维负担
以下情况需谨慎评估:
- 超大规模写入或复杂事务场景,SQLite 的并发模型存在天然限制
- 需要多地域分布式部署或细粒度水平扩展
- 团队不具备 Go 语言能力,且业务逻辑深度依赖服务端自定义代码
上手方式
访问 pocketbase.io 下载对应平台的二进制文件,解压后执行 ./pocketbase serve 即可启动。浏览器打开本地管理后台(默认 http://127.0.0.1:8090/_/),创建首个集合后即可通过 REST API 或官方 SDK(JavaScript / Dart)进行数据读写。官方文档覆盖数据建模、认证配置、文件处理与 Go 扩展等主题,建议按文档顺序完成一次端到端示例。
相关导航


Quick Reference

tailwindcss

社会化营销案例库

awesome-wechat-weapp

react-pdf

acme.sh

