PocketBase Docker镜像

镜像概述和主要用途

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

***文档

• PocketBase ***文档

Docker仓库

推荐从Docker Hub Registry拉取预构建镜像。可通过标签指定版本，Docker Hub Registry提供版本列表，常用标签包括：

• 0, 0.30, latest (pocketbase/Dockerfile)

配置

环境变量

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

设置方式

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

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

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

  $ 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 部署

$ docker run -d --name pocketbase -p 80:8090 \
  --env POCKETBASE_ADMIN_EMAIL=*** \
  --env POCKETBASE_ADMIN_PASSWORD=SecurePass123 \
  --volume /local/data:/pocketbase \
  adrianmusante/pocketbase:latest

Docker Compose 配置

创建docker-compose.yml：

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=***
      - POCKETBASE_ADMIN_PASSWORD=SecurePass123
      - POCKETBASE_ADMIN_UPSERT=true
    volumes:
      - ./pocketbase_data:/pocketbase
    networks:
      - pocketbase_network

启动服务：

$ docker-compose up -d