不用从零写后端！PocketBase 开箱即用，原型开发效率直接翻倍

后端开发提速！PocketBase开箱即用，开发效率直接翻倍

做开发的人，大多都有过这样的无奈时刻：明明只是想做一个简单的小项目、工具原型或者个人后台，却要被繁琐的后端基础配置拖住脚步。从零搭建服务器环境、安装配置数据库、手写繁琐的CRUD接口、开发登录鉴权功能、调试文件存储逻辑，一套基础后端流程走下来，耗费大半天时间，真正的业务开发却迟迟无法推进。

尤其是独立开发者、技术爱好者和学生，没有团队后端支撑，既要兼顾前端页面，又要折腾后端底层架构，大量时间浪费在重复的造轮子工作中，开发效率极低，很多优质的创意和想法，都卡在繁琐的后端部署环节被迫搁置。

其实，后端开发完全不用这么繁琐。今天给大家分享的PocketBase，就是为解决这类痛点而生的轻量开源后端神器。它摒弃了传统后端复杂的搭建逻辑，将SQLite数据库、用户鉴权、文件存储、可视化管理后台、RESTful API接口一站式集成，真正实现开箱即用。无需搭建复杂数据库、无需手写基础接口，几分钟即可部署完成，直接拥有一套完整可用的后端服务。

无论是快速验证产品原型、开发个人小工具、搭建内部管理系统，还是学习后端开发实战，PocketBase都能极致简化开发流程，砍掉90%的重复工作，让后端开发效率直接翻倍。搭配cpolar内网穿透，还能无需公网IP实现外网远程访问、调试接口，随时随地使用自建私有后端服务，彻底告别繁琐的后端搭建与部署难题。

image-20260902175653136

1.PocketBase是什么？

PocketBase是一款由Go语言开发、单文件即可运行的开源自托管BaaS后端工具，专门用来解决小项目、原型开发中后端重复造轮子的痛点。传统开发一个项目后端，需要部署数据库、编写CRUD接口、实现登录鉴权、处理文件上传，整套基础工作会占用大量开发时间。而PocketBase把SQLite嵌入式数据库、用户鉴权体系、文件存储、可视化管理后台、RESTful API全部打包进单个可执行程序，不需要额外安装数据库、中间件，部署完成直接就可以使用整套后端服务。

它支持数据表自定义、OAuth第三方登录、实时数据订阅，前端直接调用自动生成的API，不用手写后端接口，开发者可以把全部精力放在业务与页面开发上。部署完成后配合cpolar内网穿透，无需公网IP就可以对外暴露API与管理后台，随时随地远程调试自己的后端项目。

⚡核心特点

  • 📦 单二进制文件，部署简单，资源占用低，服务器要求低
  • 🗄️内置SQLite数据库，数据存为文件，备份迁移十分方便
  • 🔐自带完整用户鉴权，支持账号密码、OAuth第三方登录
  • 📃自动生成REST API，增删改查接口开箱即用
  • 🖥️内置可视化管理后台，可视化管理数据表、用户、文件
  • ⚡支持实时数据订阅，轻松实现数据实时更新效果

✨适合谁用

  1. 独立开发者、个人创作者：快速验证产品MVP原型，不想花大量时间搭建后端基础环境，专注做产品功能。
  2. 前端开发者：缺少后端配合，直接拿PocketBase当作后端，快速完成完整全栈项目。
  3. 学生、全栈学习者：做课程设计、练手项目，省去复杂数据库部署，专注学习前后端交互逻辑CSDN。
  4. 小团队：开发内部工具、管理系统，快速搭建带登录、数据存储的业务后台。
  5. 小型移动端、小程序项目：直接调用自动API，快速完成数据存储与用户登录。

❗不适合：超大规模高并发集群业务，它更适合中小型项目场景PocketBase。

⚙️工作原理

PocketBase本质是一个Go编写的一体化服务程序，单个二进制文件内部封装了全部组件，不需要分开安装数据库、Web服务、鉴权服务。 运行程序之后，内部嵌入式SQLite数据库负责存储全部业务数据；管理后台页面直接内置在程序内，浏览器访问即可可视化建表、管理数据；当前端发起网络请求，PocketBase 自动根据数据表定义生成REST接口，自动完成数据校验、权限判断、数据库读写；同时内置鉴权模块处理登录、Token校验，WebSocket实现实时数据推送。所有数据全部保存在本地pb_data文件夹，备份直接复制文件夹即可。 我们只需要定义数据表结构，不用编写接口代码，前端直接调用接口完成业务；搭配cpolar内网穿透，还可以把本地服务暴露公网，实现远程接口调用与后台管理。

🖥️适用场景

产品原型快速验证、个人小工具开发、小型Web / 移动端项目、内部管理后台、学习后端接口开发。

2.PocketBase下载部署

2.1 二进制方式

# 创建目录
mkdir -p /opt/pocketbase
cd /opt/pocketbase

# 下载amd64二进制包
wget https://github.com/pocketbase/pocketbase/releases/latest/download/pocketbase-linux-amd64.zip

unzip pocketbase-linux-amd64.zip
chmod +x pocketbase

image-20260901141544207

image-20260901141615134

测试运行：

./pocketbase serve --http 0.0.0.0:8090

image-20260901141630026

浏览器访问 http://服务器IP:8090/_/，能打开后台代表正常，Ctrl+C停止。

  • http://192.168.42.140:8090 → 404（根路径无内容）
  • http://192.168.42.140:8090/_/ → 管理后台面板
  • http://192.168.42.140:8090/api/ → REST API 接口

93e00e5c7075750b4d3dfdda5fffc588

2.2 docker方式

docker run 快速启动

# 创建数据存放目录
mkdir -p /opt/pocketbase
cd /opt/pocketbase

# 启动PocketBase，端口8090
docker run -d \
  --name pocketbase \
  --restart always \
  -p 8090:8090 \
  -v $(pwd)/pb_data:/pb_data \
  -v $(pwd)/pb_public:/pb_public \
  -v $(pwd)/pb_migrations:/pb_migrations \
  pocketbase/pocketbase:latest

访问地址：http://服务器IP:8090/_/ 进入后台管理面板

方式 2：docker‑compose.yml（推荐，适合写教程）

新建 /opt/pocketbase/docker-compose.yml

version: "3.8"
services:
  pocketbase:
    image: pocketbase/pocketbase:latest
    container_name: pocketbase
    restart: always
    ports:
      - "8090:8090"
    volumes:
      - ./pb_data:/pb_data
      - ./pb_public:/pb_public
      - ./pb_migrations:/pb_migrations

启动命令

cd /opt/pocketbase
docker-compose up -d

查看运行状态

docker ps |grep pocketbase

3.配置systemd服务

systemd开机自启配置不变

vi /etc/systemd/system/pocketbase.service
[Unit]
Description=PocketBase backend service
After=network.target

[Service]
Type=simple
WorkingDirectory=/opt/pocketbase
ExecStart=/opt/pocketbase/pocketbase serve --http 0.0.0.0:8090
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target
systemctl daemon-reload
systemctl start pocketbase
systemctl enable pocketbase
systemctl status pocketbase

防火墙放行端口

firewall-cmd --add-port=8090/tcp --permanent
firewall-cmd --reload

4.Pocketbase的配置与使用

4.1 创建管理员账号

两种创建管理员账号方式

方式 1：浏览器网页初始化（推荐）

访问 http://192.168.42.140:8090/_/，按照页面提示填写邮箱密码创建超级管理员。

image-20260901141923345

方式 2：命令行直接创建（网页打不开时用）

./pocketbase superuser upsert test@test.com 12345678

image-20260901142344037

登录成功！

image-20260901142515282

4.2 新建集合

点击“+ New collection”新建一个名为blog的集合：

image-20260902172421269

然后在页面左侧可以看到新的集合，点击“+ New record”新增一条记录：

image-20260902172453465

image-20260902172539770

PocketBase自带自动API生成能力，用户几乎无需手动编写代码，即可得到一套功能完整的RESTful接口。点击「> API Preview」，就能够查看接口文档，同时还可获取JavaScript、Dart两种语言的调用示例。

image-20260902172733907

在浏览器中输入以下信息查看全部 blog：192.168.42.140:8090/api/collections/blog/records?perPage=50

image-20260902172752398

返回状态为403，这是因为没有放开blog集合的API权限。打开该集合的设置页面：

image-20260902172810135

image-20260902173157368

再次打开相应的API访问规则，保存后再次查看全部blog：

image-20260902173328083

4.3 其他设置

PocketBase的后台Logs日志页面中，可以直观查看系统全部请求记录。截图里能看到正常的集合查询、文件资源访问、管理员登录请求，同时也存在几类异常：访问favicon.ico返回404属于浏览器默认请求，不影响业务；blog集合接口返回403，提示仅超级管理员可操作，说明该集合未开放匿名访问权限，而同环境下blog1集合访问权限配置正常；系统还反复出现定时清理过期OTP、MFA会话的警告，根源为数据库查询超时，后台清理任务执行失败。

image-20260902174914725

PocketBase后台设置里的Export collections（导出集合）页面，该功能用于导出全部数据表配置JSON，可迁移导入到其他PocketBase实例环境。左侧导航栏选中Export collections，左边勾选框已经全选，包含users、_superusers、blog、blog1以及系统内置的_authOrigins、_externalAuths、_mfas、_otps集合；右侧预览框展示集合的 JSON 配置文本，包含集合 ID、权限规则（listRule/viewRule 等）、字段定义、字段校验约束等完整元数据；右下角提供Download as JSON按钮，点击即可把这套集合配置下载为JSON文件，实现表结构跨环境迁移，该导出只导出集合表结构与权限配置，不会导出实际业务数据记录。

image-20260902174848999

PocketBase后台设置中的Import collections（导入集合）页面，用于导入之前导出的集合JSON配置，完成表结构迁移。可以直接粘贴集合配置文本，也可点击Load from JSON file按钮加载本地JSON文件；中间是JSON文本输入框，右下角Review按钮待导入内容后才会激活。页面提示，也可使用Go或JS迁移脚本，以更精细、支持版本管控的方式管理集合，该功能仅导入集合表结构、字段与权限规则，不会导入业务记录数据。

image-20260902174031397

PocketBase后台设置里的SQL console（SQL 控制台）页面，属于Debug调试分类，支持直接手写SQL语句操作底层SQLite数据库，可用于查询、调试、修复数据。

image-20260902174222183

PocketBase SQL控制台执行EXPLAIN QUERY PLAN语句，成功输出SQLite查询执行计划，结果显示该查询会对 users表执行全表扫描SCAN users，可借助该功能分析SQL执行路径，用于优化查询性能。

image-20260902174404965

PocketBase的Mail settings邮件设置页面用于配置系统通知邮件，可设置发件人名称与发件邮箱，官方推荐开启SMTP邮件服务器，配置完成后点击Send test email即可发送测试邮件校验配置，若不开启SMTP则依赖服务器本地邮件服务，容器部署环境大多无法正常发送邮件。

image-20260902174519125

PocketBase的Files storage文件存储页面用于管理上传附件的存储后端，默认采用本地文件系统，具备性能高、便于备份管理的特点，磁盘空间有限的场景可以开启Use S3 storage开关对接S3兼容对象存储，配置完毕后点击Save changes保存设置。image-20260902174603197

PocketBase的Backups备份页面用于数据备份和恢复，当前暂无备份记录，可点击Initialize new backup手动生成备份，通过Backup options配置备份参数，也支持上传备份文件进行恢复，是生产环境保障数据安全的核心功能。

image-20260902174645591

PocketBase的Crons页面用于查看系统已注册的定时任务，展示数据库优化、MFA清理、OTP清理、日志清理等内置任务及cron执行规则，该页面仅做查看，自定义定时任务需要通过Go或JavaScript代码编写注册，支持界面手动触发已有任务。

image-20260902174729792

PocketBase本地运行默认仅内网可访问，结合cpolar内网穿透工具，只需对PocketBase默认的8090端口建立http隧道，无需公网IP与路由器端口映射，就能生成公网HTTPS地址，实现外网访问PocketBase后台管理面板与REST API接口，适合开发调试、对外演示，生产环境建议配置固定域名并做好账号安全防护。

5.安装cpolar实现随时随地开发

5.1 什么是cpolar？

cpolar是一款安全高效的内网穿透工具，无需公网IP或复杂配置，只需一条命令，即可将本地服务器、Web服务或任意端口映射到公网，让你随时随地远程访问内网应用，特别适合开发调试、远程运维和应急部署等场景。

5.2 部署cpolar

cpolar 可以将你本地电脑中的服务（如 SSH、Web、数据库）映射到公网。即使你在家里或外出时，也可以通过公网地址连接回本地运行的开发环境。

❤️以下是安装cpolar步骤：

官网在此：https://www.cpolar.com

使用一键脚本安装命令：

sudo curl https://get.cpolar.sh | sh

image-20250725104019896

安装完成后，执行下方命令查看cpolar服务状态：（如图所示即为正常启动）

sudo systemctl status cpolar

22e5adfaf290a17fc3384bb296055259

Cpolar安装和成功启动服务后，在浏览器上输入虚拟机主机IP加9200端口即:【http://ip:9200】访问Cpolar管理界面，使用Cpolar官网注册的账号登录,登录后即可看到cpolar web 配置界面,接下来在web 界面配置即可：

打开浏览器访问本地9200端口，使用cpolar账户密码登录即可,登录后即可对隧道进行管理。

8a6698b1bf26d64ba3645827fbfb1c29

6.配置公网地址

登录cpolar web UI管理界面后,点击左侧仪表盘的隧道管理——创建隧道：

  • 隧道名称：可自定义，本例使用了:Pocketbase，注意不要与已有的隧道名称重复
  • 协议：http
  • 本地地址：8090
  • 域名类型：随机域名
  • 地区：选择China Top

image-20260902175324090

创建成功后，打开左侧在线隧道列表,可以看到刚刚通过创建隧道生成了公网地址，接下来就可以在其他电脑或者移动端设备（异地)上，使用地址访问。

image-20260902175335117

访问成功。

image-20260902175402779

7.保留固定公网地址

使用cpolar为其配置二级子域名（cpolar官网-安全的内网穿透工具 | 无需公网ip | 远程访问 | 搭建网站），该地址为固定地址，不会随机变化。

image-20250918151358733

点击左侧的预留，选择保留二级子域名，地区选择china Top，然后设置一个二级子域名名称，我使用的是，大家可以自定义。填写备注信息，点击保留。

image-20260902175446835

登录cpolar web UI管理界面，点击左侧仪表盘的隧道管理——隧道列表，找到所要配置的隧道，点击右侧的编辑。

image-20260902175501301

修改隧道信息，将保留成功的二级子域名配置到隧道中

  • 域名类型：选择二级子域名
  • Sub Domain：填写保留成功的二级子域名
  • 地区: China Top

点击更新

image-20260902175522397

更新完成后，打开在线隧道列表，此时可以看到随机的公网地址已经发生变化，地址名称也变成了保留和固定的二级子域名名称。

image-20260902175546794

最后，我们使用固定的公网地址在任意设备的浏览器中访问，可以看到成功访问的页面，这样一个永久不会变化的二级子域名公网网址即设置好了。

image-20260902175627822

总结

PocketBase是一款轻量的后端BaaS工具，内置账号认证、集合数据表、文件存储、邮件服务、数据备份、定时任务、SQL控制台等全套后台能力，无需从零编写接口代码，可视化后台即可完成表结构设计、权限配置与数据管理；本地部署后搭配cpolar内网穿透，无需公网IP就能把本地PocketBase暴露到外网，方便调试接口、访问管理面板，大幅降低后端开发工作量，显著提升项目开发效率。

感谢您对本篇文章的喜爱，有任何问题欢迎留言交流。cpolar官网-安全的内网穿透工具 | 无需公网ip | 远程访问 | 搭建网站

Share:

鸽子

鸽子

我是鸽子，是这个网站的文章编辑之一！喜欢研究各种有趣的开源项目。希望大家喜欢我的文章！

发表回复

目录

On Key

推荐文章