技能介绍

解决什么问题

当一个前端或移动端团队需要一套后端能力——用户体系、文件上传、数据持久化、以及实时数据推送——常见的做法是引入多个独立服务，再加上数据库、部署脚本和监控。这些组件各自需要维护版本、处理升级、暴露安全端口，也意味着一套新的运维与权限问题。

本技能针对这个场景，把这类后端能力整合到一个可执行文件中。你不需要分别部署 API 服务、数据库引擎和文件存储，也不需要为此搭建独立的消息队列。对于原型验证、内部工具、个人项目，以及希望降低环境搭建复杂度的团队，这种形态可以直接减少部署步骤和故障排查范围。

技能如何工作

该技能围绕 PocketBase 这个用 Go 编写的开源后端展开。它以单个二进制文件形式发布，运行时自带一个嵌入式 SQLite 数据库，并提供一套类 REST 的接口用于读写数据。

实时能力：客户端可以订阅特定数据集合的变化，当底层记录发生写入或更新时，服务端会主动推送变更，无需客户端轮询。
内置用户与文件管理：包含注册、登录、密码重置等认证相关接口，以及文件上传与存储管理，省去了单独实现鉴权与对象存储的工作量。
管理后台：附带一个可视化 UI，便于直接查看数据、管理用户和调试接口，而不必完全依赖命令行或第三方工具。

使用时，下载并在本地解压后运行 pocketbase serve 即可启动服务，默认监听本地端口。如果你需要通过 Go SDK 调用它，可以先用 go mod init myapp && go mod tidy 初始化模块并拉取依赖。配套的 JavaScript SDK 覆盖浏览器、Node.js 和 React Native 三类运行环境，方便在前后端之间保持一致的调用方式。

适用边界与注意点

嵌入式数据库的局限：SQLite 在单机读写场景下表现良好，但并发写入、跨节点扩展和高吞吐写入并不是它的强项。如果你的服务预期承载大量写入或需要水平扩容，需要评估是否可以替换为外部数据库。
以单机部署为前提：单个二进制的设计目标是简化分发和部署，而不是提供分布式集群能力。多实例部署、服务发现、负载均衡等需要自行规划。
生产环境的安全配置：开箱即用的默认设置面向快速上手，用于生产前需要自行处理反向代理、HTTPS、访问控制以及备份策略。
升级依赖上游项目：该技能的能力来自 PocketBase 本体，版本演进、缺陷修复和长期维护都取决于上游项目的更新节奏。