PocketBase 自建后端服务：Docker 部署替代 Firebase

痛点：想快速搭后端，但工具太沉重#

每次想做个小项目——个人博客后台、记账应用、TODO 工具——都会面临同样的问题：

• Firebase — 好用但绑定 Google，免费额度有限，数据不在自己手里
• Supabase — 开源但部署复杂，PostgreSQL + GoTrue + Realtime 好几个组件
• Appwrite — 功能全但太重，Docker 部署要拉好几个镜像
• 自己写后端 — Python/Node/Go 选框架、配数据库、写 CRUD、搞认证……项目还没开始已经累了

有没有一个方案：一个二进制文件 = 数据库 + API + 认证 + 文件存储 + 管理面板？

PocketBase 就是答案。

PocketBase 是什么？#

PocketBase 是一个用 Go 编写的开源后端即服务——单个可执行文件包含 SQLite 数据库、自动生成 REST API、用户认证、文件存储、管理后台。

核心指标：

为什么能替代 Firebase？

Docker 部署 PocketBase#

1
version: "3.8"
2

3
services:
4
  pocketbase:
5
    image: pocketbase/pocketbase:latest
6
    container_name: pocketbase
7
    ports:
8
      - "8090:8090"  # API + Admin UI
9
    volumes:
10
      - ./pb_data:/pb_data   # 数据库 + 文件存储持久化
11
      - ./pb_public:/pb_public  # 静态文件托管
12
      - ./pb_hooks:/pb_hooks    # Go/JS 钩子（可选）
13
    restart: unless-stopped

1
docker compose up -d

1
docker run -d --name pocketbase \
2
    -p 8090:8090 \
3
    -v $(pwd)/pb_data:/pb_data \
4
    -v $(pwd)/pb_public:/pb_public \
5
    pocketbase/pocketbase:latest

快速构建一个 API#

1
# 任何人都可以读已发布的文章
2
@request.auth.id != "" && published = true
3

4
# 只有作者可以编辑自己的文章
5
@request.auth.id = author.id

1
// 获取文章列表
2
const response = await fetch('http://IP:8090/api/collections/posts/records', {
3
    headers: { 'Authorization': 'Bearer YOUR_TOKEN' }
4
});
5
const data = await response.json();
6

7
// 创建新文章
8
const create = await fetch('http://IP:8090/api/collections/posts/records', {
9
    method: 'POST',
10
    headers: {
11
        'Content-Type': 'application/json',
12
        'Authorization': 'Bearer YOUR_TOKEN'
13
    },
14
    body: JSON.stringify({
15
        title: 'Hello PocketBase',
16
        content: 'This is my first post!'
17
    })
18
});

用 Nginx 反代 + HTTPS#

1
server {
2
    listen 443 ssl;
3
    server_name api.yourdomain.com;
4

5
    # 托管静态前端
6
    root /var/www/pb_public;
7

8
    location / {
9
        proxy_pass http://127.0.0.1:8090;
10
        proxy_set_header Host $host;
11
        proxy_set_header X-Real-IP $remote_addr;
12
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
13
        proxy_set_header X-Forwarded-Proto $scheme;
14

15
        # SSE 实时订阅支持
16
        proxy_set_header Connection '';
17
        proxy_http_version 1.1;
18
        proxy_buffering off;
19
        proxy_cache off;
20
    }
21
}

进阶玩法#

1
// 文章创建后发送通知
2
onRecordAfterCreateRequest((e) => {
3
    const record = e.record;
4
    console.log(`新文章: ${record.get('title')}`);
5

6
    // 调用外部 Webhook
7
    $http.send({
8
        url: 'https://hooks.example.com/new-post',
9
        method: 'POST',
10
        body: JSON.stringify({
11
            title: record.get('title')
12
        })
13
    });
14
}, 'posts');
15

16
// 添加自定义 API 端点
17
routerAdd('GET', '/api/hello', (c) => {
18
    return c.json(200, { message: 'Hello from PocketBase!' });
19
});

1
package main
2

3
import (
4
    "log"
5
    "github.com/pocketbase/pocketbase"
6
    "github.com/pocketbase/pocketbase/core"
7
)
8

9
func main() {
10
    app := pocketbase.New()
11

12
    app.OnRecordAfterCreateRequest().Add(func(e *core.RecordCreateEvent) error {
13
        log.Println("New record created:", e.Record.Id)
14
        return nil
15
    })
16

17
    if err := app.Start(); err != nil {
18
        log.Fatal(err)
19
    }
20
}

1
const eventSource = new EventSource(
2
    'http://IP:8090/api/realtime?token=YOUR_TOKEN'
3
);
4

5
eventSource.addEventListener('PB_CONNECT', (e) => {
6
    console.log('已连接实时频道');
7
});
8

9
eventSource.addEventListener('posts', (e) => {
10
    const record = JSON.parse(e.data);
11
    console.log('文章更新:', record);
12
});

FAQ#

Q：PocketBase 适合生产环境吗？

A：适合。已有大量生产案例，SQLite 在单机场景下表现优异，支持 WAL 模式和高并发读。如果需要多机部署，可用 S3 文件存储 + 只读副本。

Q：数据库文件损坏了怎么办？

A：定期备份 pb_data/data.db 文件即可。PocketBase 内置了自动备份功能，可在管理面板设置每日备份。

Q：支持哪些 OAuth2 登录？

A：Google、GitHub、Discord、Facebook、GitLab、Microsoft 等主流 OAuth2 提供方，在管理面板配置即可。

Q：可以托管前端 SPA 吗？

A：可以。将前端构建产物放入 pb_public 目录，PocketBase 会自动作为静态文件服务器。

Q：性能怎么样？

A：单文件启动仅需 10MB 内存，每秒可处理数千次 API 请求。远低于同功能方案的资源占用。

Q：和 Supabase 比怎么样？

A：PocketBase 胜在极简部署（一个二进制）和低资源占用；Supabase 胜在 PostgreSQL 的关系型能力和 Realtime 的 WebSocket 原生支持。个人项目选 PocketBase，企业级选 Supabase。

总结#

PocketBase 重新定义了后端开发的入门门槛：

1. ✅ 一个二进制 = 全部——数据库 + API + 认证 + 文件存储 + 管理面板，30 秒启动
2. ✅ 零代码生成 REST API——创建数据表即可自动拥有完整的 CRUD 接口
3. ✅ 内置管理面板——可视化操作，非技术人员也能管理数据
4. ✅ 轻量级——10MB 内存，1 核 256MB 服务器就能流畅运行
5. ✅ JS/Go 双钩子系统——需要自定义逻辑时随时扩展

如果你正在为下一个想法的后端发愁，或者想找个轻量级后端做前端演示，PocketBase 是当下最好的选择。

本文由小啪撰写，基于 PocketBase v0.26.0。