关于 PocketBase
PocketBase 是紧凑型后端应用，将嵌入式 SQLite、认证、REST API、实时订阅、文件存储和管理 UI 集成在一起。其部署模型面向一个可执行文件和本地数据目录，而不是为典型项目单独运维数据库服务器。
本地 PocketBase 流程会结合 `pb_data` 目录启动可执行文件，测试 collection、API rules、hooks、migrations 和实时 client。源码扩展或自定义构建需要 Go；只有浏览器 Origin 或 OAuth 回调测试需要时才加入反向代理和 HTTPS。
核心能力
- 嵌入式 SQLite
- Collection API Rules
- 认证
- 实时订阅
- 文件存储
- JavaScript 与 Go Hooks
常见使用场景
- 小型产品后端
- 原型 API
- 实时管理工具
- 自包含内部应用
PocketBase 将多数本地状态保存在一个服务中
其嵌入式数据存储使许多项目不需要独立 SQL 服务，但客户端集成仍可能要求稳定的本地 Origin。
- PocketBase 可执行文件与 pb_data
- 运行后端并在本地保留嵌入式 SQLite 数据和文件存储。
- Migration 与 Hook 流程
- `pb_migrations` 保存 collection 变更，并针对本地数据测试 JavaScript 或 Go 扩展行为。
- 可选 HTTPS Proxy
- OAuth provider、安全 cookie 或需要 HTTPS 回调 URL 的浏览器 client 会用到它。
FlyEnv 如何提供帮助
匹配项目运行时
为 PocketBase 选择项目所需的运行时版本。
管理本地服务
仅在项目需要时启动数据库、缓存和其他服务。
保持项目隔离
让不同项目使用各自的版本和服务配置。
配置本地域名
需要时可通过本地域名和 HTTPS 访问项目。
配置本地环境
项目安装请遵循上游官方文档；FlyEnv 负责管理其所需的运行时、数据库、Web 服务器和辅助服务。
- 1按照 PocketBase 官方文档安装项目和依赖。
- 2在 FlyEnv 中选择项目需要的运行时版本。
- 3启动项目配置中指定的数据库服务。
- 4仅在项目需要时启动缓存、搜索或其他辅助服务。
- 5按需配置本地 Web 服务器、域名和 HTTPS。
- 6将相关服务加入启动组，方便重复启动。
准备好本地运行 PocketBase 吗？
使用 FlyEnv 管理本地 PocketBase 环境所需的运行时、数据库、Web 服务器和服务。