adrianmusante/pocketbase

PocketBase Docker镜像

镜像概述和主要用途

PocketBase™ 是一个开源后端，集成了嵌入式数据库（SQLite）、实时订阅功能、内置认证管理、便捷的仪表板UI及简单的REST风格API。本Docker镜像提供容器化部署方案，简化PocketBase实例的搭建与管理流程。

官方文档

• PocketBase 官方文档

Docker仓库

推荐从https://hub.docker.com/r/adrianmusante/pocketbase%E6%8B%89%E5%8F%96%E9%A2%84%E6%9E%84%E5%BB%BA%E9%95%9C%E5%83%8F%E3%80%82%E5%8F%AF%E9%80%9A%E8%BF%87%E6%A0%87%E7%AD%BE%E6%8C%87%E5%AE%9A%E7%89%88%E6%9C%AC%EF%BC%8CDocker Hub Registry提供https://hub.docker.com/r/adrianmusante/pocketbase/tags/%EF%BC%8C%E5%B8%B8%E7%94%A8%E6%A0%87%E7%AD%BE%E5%8C%85%E6%8B%AC%EF%BC%9A

• https://github.com/adrianmusante/docker-pocketbase/blob/main/pocketbase/Dockerfile

配置

环境变量

启动镜像时，可通过环境变量调整实例配置，支持在docker-compose.yml或docker run命令中设置。

设置方式

• Docker Compose：在docker-compose.yml的应用配置段添加变量：

  yaml
  pocketbase:
    ...
    environment:
      - USER_DEFINED_KEY=custom_value
    ...
  

• 手动执行：使用--env参数指定变量：

  console
  $ docker run -d --name pocketbase -p 80:8090 \
    --env USER_DEFINED_KEY=custom_value \
    --volume /path/to/persistence:/pocketbase \
    adrianmusante/pocketbase:latest
  

环境变量详情

通用配置

• POCKETBASE_DEBUG: 启用verbose模式，默认值：false
• POCKETBASE_PORT_NUMBER: 服务器端口号，默认值：8090
• POCKETBASE_OPTS: 启动额外参数，无默认值
• POCKETBASE_ADMIN_EMAIL: 管理员***，无默认值
• POCKETBASE_ADMIN_PASSWORD: 管理员密码，支持通过Docker secrets或POCKETBASE_ADMIN_PASSWORD_FILE指定文件路径存储，无默认值
• POCKETBASE_ADMIN_UPSERT: 设为true时启动前更新管理员信息，false仅首次创建，默认值：true

加密配置

• POCKETBASE_ENCRYPTION_KEY: 用于加密数据库中的应用设置，保护OAuth2密钥、SMTP密码等敏感数据（默认明文存储）
• POCKETBASE_ENCRYPTION_KEY_FILE: 替代POCKETBASE_ENCRYPTION_KEY，可指定Docker密钥名称或密钥文件绝对路径，默认值：POCKETBASE_ENCRYPTION_KEY

目录配置

• POCKETBASE_WORKDIR: 持久化基础目录，默认值：/pocketbase
• POCKETBASE_DATA_DIR: 数据存储目录，默认值：${POCKETBASE_WORKDIR}/data
• POCKETBASE_MIGRATION_DIR: 迁移文件目录，默认值：${POCKETBASE_WORKDIR}/migrations
• POCKETBASE_PUBLIC_DIR: 静态文件服务目录，默认值：${POCKETBASE_WORKDIR}/public
• POCKETBASE_HOOK_DIR: JS应用钩子目录，默认值：${POCKETBASE_WORKDIR}/hooks

使用示例

Docker Run 部署

console
$ docker run -d --name pocketbase -p 80:8090 \
  --env POCKETBASE_ADMIN_EMAIL=admin@example.com \
  --env POCKETBASE_ADMIN_PASSWORD=SecurePass123 \
  --volume /local/data:/pocketbase \
  adrianmusante/pocketbase:latest

Docker Compose 配置

创建docker-compose.yml：

yaml
version: '3.8'

networks:
  pocketbase_network:
    driver: bridge

services:
  pocketbase:
    image: adrianmusante/pocketbase:latest
    container_name: pocketbase
    restart: unless-stopped
    ports:
      - "80:8090"
    environment:
      - POCKETBASE_DEBUG=false
      - POCKETBASE_PORT_NUMBER=8090
      - POCKETBASE_ADMIN_EMAIL=admin@example.com
      - POCKETBASE_ADMIN_PASSWORD=SecurePass123
      - POCKETBASE_ADMIN_UPSERT=true
    volumes:
      - ./pocketbase_data:/pocketbase
    networks:
      - pocketbase_network

启动服务：

console
$ docker-compose up -d