supabase/postgres 是基于 PostgreSQL 的 Docker 镜像,预集成了多种实用扩展,方便快速部署。以下是启动步骤及内置扩展说明。
更多信息可查看 GitHub 仓库。
1. 创建配置文件
新建 docker-compose.yml 文件,根据镜像版本选择以下配置:
14.1.0 之前版本
yamlversion: '3' services: db: image: supabase/postgres ports: - "5432:5432" environment: POSTGRES_PASSWORD: postgres
14.1.0 及之后版本
yamlversion: '3' services: db: image: supabase/postgres ports: - "5432:5432" command: postgres -c config_file=/etc/postgresql/postgresql.conf environment: POSTGRES_PASSWORD: postgres
2. 启动服务
执行以下命令启动数据库(添加 -d 参数可后台运行):
bashdocker-compose up
服务启动后,数据库将在 5432 端口可用。
环境变量说明
该镜像基于 PostgreSQL 官方镜像 构建,因此支持 PostgreSQL 镜像的所有环境变量。
镜像已预安装以下扩展,无需额外配置即可使用:
| 扩展 | 版本 | 描述 |
|---|---|---|
| Postgres contrib modules | - | 包含 pg_stat_statements 等实用工具,建议启用 |
| PostGIS | 3.1.4 | Postgres 最流行的地理信息扩展,支持空间数据处理 |
| pgRouting | v3.3.0 | PostGIS 扩展模块,提供地理空间路由功能 |
| pgTAP | v1.1.0 | Postgres 单元测试工具 |
| pg_cron | v1.4.1 | 在 Postgres 内运行定时任务 |
| pgAudit | 1.6.1 | 生成合规性审计日志 |
| pgjwt | commit | 在 Postgres 中生成 JSON Web Token (JWT) |
| pgsql-http | 1.3.1 | Postgres HTTP 客户端,支持发送 HTTP 请求 |
| plpgsql_check | 2.0.6 | PL/pgSQL 代码检查工具 |
| pg-safeupdate | 1.4 | 防止误操作导致的数据更新或删除 |
| wal2json | 2.4 | 逻辑复制解码的 JSON 输出插件 |
| PL/Java | 1.6.3 | 支持在 Postgres 中编写 Java 函数 |
| plv8 | commit | 支持在 Postgres 中编写 JavaScript 函数 |
| pg_plan_filter | commit | 仅允许符合条件的 SQL 语句执行 |
| pg_net | v0.3 | 提供异步网络操作的 SQL 接口 |
| rum | 1.3.9 | GIN 索引的替代方案,优化全文搜索 |
| pg_hashids | commit | 将数字生成唯一标识符 |
| pg_sodium | v1.3.0 | 基于 libsodium 的现代加密 API |
若未找到所需扩展,可通过 此链接 提交建议,以便纳入未来版本。
以下是 supabase/postgres 相关的常用 Docker 镜像,适用于 关系型数据库、复杂查询、数据完整性 等不同场景:
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 版本下载页面。


探索更多轩辕镜像的使用方法,找到最适合您系统的配置方式
通过 Docker 登录认证访问私有仓库
无需登录使用专属域名
Kubernetes 集群配置 Containerd
K3s 轻量级 Kubernetes 镜像加速
VS Code Dev Containers 配置
Podman 容器引擎配置
HPC 科学计算容器配置
ghcr、Quay、nvcr 等镜像仓库
Harbor Proxy Repository 对接专属域名
Portainer Registries 加速拉取
Nexus3 Docker Proxy 内网缓存
需要其他帮助?请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单
manifest unknown
no matching manifest(架构)
invalid tar header(解压)
TLS 证书失败
DNS 超时
410 Gone 排查
402 与流量用尽
401 认证失败
429 限流
D-Bus 凭证提示
413 与超大单层
来自真实用户的反馈,见证轩辕镜像的优质服务