postgrest/postgrest Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

PostgREST

镜像概述

PostgREST是一款能够直接从现有PostgreSQL数据库生成完整RESTful API的工具。它无需手动编写API代码，即可提供比传统开发方式更简洁、符合标准规范且性能更优的API服务。

核心功能与特性

• 自动API生成：直接基于PostgreSQL数据库结构生成RESTful API，无需手动编码
• 标准合规性：严格遵循RESTful设计规范，提供一致的资源访问接口
• 高性能：相比手动开发的API实现，具有更高的运行效率和响应速度
• 灵活配置：通过环境变量进行全面配置，适应不同场景需求

使用场景

适用于需要快速为PostgreSQL数据库提供API接口的各类场景：

• 后端服务快速开发与部署
• 数据库数据服务化接口构建
• 简化前后端数据交互流程
• 原型系统或内部工具的API支持

使用方法

配置说明

PostgREST镜像通过环境变量进行配置，所有可用配置参数详见PostgREST官方配置文档。

基础使用示例

基本启动命令

bash
docker run -d \
  --name postgrest \
  -e PGRST_DB_URI="postgres://username:password@postgres-host:5432/dbname" \
  -e PGRST_SERVER_PORT=3000 \
  -p 3000:3000 \
  postgrest/postgrest

关键环境变量说明

• PGRST_DB_URI: PostgreSQL数据库连接URI，格式为postgres://user:password@host:port/dbname
• PGRST_SERVER_PORT: 服务监听端口（默认3000）
• PGRST_DB_SCHEMA: 指定数据库模式（默认"public"）
• PGRST_AUTH_JWT_SECRET: JWT认证密钥（如需启用认证）

完整配置示例

bash
docker run -d \
  --name postgrest \
  -e PGRST_DB_URI="postgres://admin:secret@postgres:5432/mydb" \
  -e PGRST_SERVER_PORT=3000 \
  -e PGRST_DB_SCHEMA="api" \
  -e PGRST_AUTH_JWT_SECRET="myjwtsecret" \
  -e PGRST_OPENAPI_SERVER_PROXY_URI="[***]" \
  -p 3000:3000 \
  --link postgres:postgres \
  postgrest/postgrest

详细文档参考

完整使用指南请查阅PostgREST Docker安装文档。

镜像构建说明

该镜像采用Nix工具从scratch构建，而非传统Dockerfile，确保生成高度安全且经过优化的镜像。因此镜像历史中不会显示构建命令。

注意：arm64架构变体基于Ubuntu构建，上述构建方式不适用于该架构版本。

构建过程详情及镜像检查方法，请参见PostgREST GitHub仓库。