本站支持搜索的镜像仓库:Docker Hub、gcr.io、ghcr.io、quay.io、k8s.gcr.io、registry.gcr.io、elastic.co、mcr.microsoft.com
当前的 Postgres Docker 镜像基于 Ubuntu,由 Canonical 提供,会持续接收安全更新,并自动滚动至更新的 Postgres 或 Ubuntu 版本。本仓库可免费使用,且不受每用户速率限制。
PostgreSQL 是一款功能强大的开源对象关系型数据库系统。它完全符合 ACID 标准,全面支持外键、连接、视图、触发器及存储过程(支持多种语言)。支持多数 SQL:2008 数据类型,包括 INTEGER、NUMERIC、BOOLEAN、CHAR、VARCHAR、DATE、INTERVAL、TIMESTAMP 等,还可存储图片、音频、视频等二进制大对象。提供 C/C++、Java、.Net、Perl、Python、Ruby、Tcl、ODBC 等原生编程接口,文档完善。更多信息见 PostgreSQL 官网。
!LTS
LTS 通道提供最长 5 年免费安全维护。
!ESM
ESM 通道通过 Canonical 受限仓库 提供最长 10 年客户安全维护。
| 通道标签(Channel Tags) | 支持截止时间 | 当前版本 | 架构 |
|---|---|---|---|
14-22.04_beta | 2027-04 | Ubuntu 22.04 LTS 上的 Postgres 14 | amd64、arm64、ppc64el、s390x |
12-20.04_beta | 2025-04 | Ubuntu 20.04 LTS 上的 Postgres 12.4 | amd64、arm64、ppc64el、s390x |
track_risk |
通道标签按稳定性排序:stable(稳定)、candidate(候选)、beta(测试)、edge(边缘)。更具风险的通道默认隐含可用,例如若列出 beta,则可拉取 edge;若列出 candidate,则可拉取 beta 和 edge;若列出 stable,则四个通道均可用。镜像会按 edge → beta → candidate → stable 顺序逐步发布。
若需商业再分发,或需要 ESM 通道及未列出的版本/通道,请 联系 Canonical 团队(或发送邮件至 [邮箱已删除])。
docker run -d --name postgres-container -e TZ=UTC -p 30432:5432 -e POSTGRES_PASSWORD=My:s3Cr3t/ ubuntu/postgres:14-22.04_beta
启动后,可通过 localhost:30432 访问 PostgreSQL 服务。
| 参数 | 描述 |
|---|---|
-e TZ=UTC | 设置时区。 |
-e POSTGRES_PASSWORD=secret | 设置默认超级用户(postgres)的密码。注意:本地连接数据库无需密码,但外部主机(如其他容器)访问时需密码。此参数为必填项,且不可为空。 |
-e POSTGRES_USER=john | 创建具有超级用户权限的新用户,需与 POSTGRES_PASSWORD 配合使用。 |
-e POSTGRES_DB=db_test | 设置默认数据库名称。 |
-e POSTGRES_INITDB_ARGS="--data-checksums" | 传递参数至 postgres initdb 命令。 |
-e POSTGRES_INITDB_WALDIR=/path/to/location | 设置 Postgres 事务日志位置,默认存储在主数据目录(PGDATA)的子目录中。 |
-e POSTGRES_HOST_AUTH_METHOD=trust | 为 host 类型连接(所有数据库、用户、地址)设置认证方式。若传递此参数,会在 pg_hba.conf 中添加:host all all all $POSTGRES_HOST_AUTH_METHOD。 |
-e PGDATA=/path/to/location | 设置数据库文件存储位置,默认路径为 /var/lib/postgresql/data。 |
-p 30432:5432 | 将 Postgres 服务暴露至 localhost:30432。 |
-v /path/to/postgresql.conf:/etc/postgresql/postgresql.conf | 挂载本地 配置文件(示例配置见 此处)。 |
可通过添加初始化脚本自定义数据库配置,支持 *.sql、*.sql.gz 和 *.sh 文件,需放置于容器内 /docker-entrypoint-initdb.d 目录。脚本执行规则:
*.sql 文件(使用 POSTGRES_USER 权限);*.sh 脚本;*.sh 脚本。注意:若 PGDATA 目录已存在数据(非空),初始化脚本将不执行。
docker logs -f postgres-container
docker exec -it postgres-container /bin/bash
psql 客户端连接$ docker network create postgres-network # 创建网络 $ docker network connect postgres-network postgres-container # 连接容器至网络 $ docker run -it --rm --network postgres-network ubuntu/postgres:14-22.04_beta psql -h postgres-container -U postgres # 运行客户端
执行后输入密码(如示例中的 My:s3Cr3t/),即可登录数据库。
适用于任何 Kubernetes 环境;若未部署 Kubernetes,推荐安装 MicroK8s,并执行 microk8s.enable dns storage,再通过 snap alias microk8s.kubectl kubectl 设置 kubectl 别名。
postgres-deployment.yml 中设置 containers.postgres.image 为目标通道标签(如 ubuntu/postgres:14-22.04_beta);kubectl create configmap postgres-config --from-file=main-config=postgresql.conf kubectl apply -f postgres-deployment.yml
部署完成后,可通过 localhost:30306 访问 Postgres 服务。
若发现镜像 bug 或需请求功能,请在以下链接提交 issue:
[***]
标题格式:postgres: <问题摘要>。提交时需包含所用镜像的 digest,可通过以下命令获取:
docker images --no-trunc --quiet ubuntu/postgres:<tag>
以下通道(标签)不再更新,请升级至新版本,或联系支持团队(若无法升级)。
| 通道 | 版本 | 停止维护时间 | 升级路径 |
|---|---|---|---|
| Ubuntu 21.10 上的 Postgres 13.1 | 2022-07 | ||
| Ubuntu 21.04 上的 Postgres 13.1 | 2022-01 | ||
track |
以上内容基于 Canonical 提供的官方镜像文档整理,确保安全性与可操作性。


免费版仅支持 Docker Hub 加速,不承诺可用性和速度;专业版支持更多镜像源,保证可用性和稳定速度,提供优先客服响应。
免费版仅支持 docker.io;专业版支持 docker.io、gcr.io、ghcr.io、registry.k8s.io、nvcr.io、quay.io、mcr.microsoft.com、docker.elastic.co 等。
当返回 402 Payment Required 错误时,表示流量已耗尽,需要充值流量包以恢复服务。
通常由 Docker 版本过低导致,需要升级到 20.x 或更高版本以支持 V2 协议。
先检查 Docker 版本,版本过低则升级;版本正常则验证镜像信息是否正确。
使用 docker tag 命令为镜像打上新标签,去掉域名前缀,使镜像名称更简洁。
探索更多轩辕镜像的使用方法,找到最适合您系统的配置方式
通过 Docker 登录方式配置轩辕镜像加速服务,包含7个详细步骤
在 Linux 系统上配置轩辕镜像源,支持主流发行版
在 Docker Desktop 中配置轩辕镜像加速,适用于桌面系统
在 Docker Compose 中使用轩辕镜像加速,支持容器编排
在 k8s 中配置 containerd 使用轩辕镜像加速
在宝塔面板中配置轩辕镜像加速,提升服务器管理效率
在 Synology 群晖NAS系统中配置轩辕镜像加速
在飞牛fnOS系统中配置轩辕镜像加速
在极空间NAS中配置轩辕镜像加速
在爱快ikuai系统中配置轩辕镜像加速
在绿联NAS系统中配置轩辕镜像加速
在威联通NAS系统中配置轩辕镜像加速
在 Podman 中配置轩辕镜像加速,支持多系统
配置轩辕镜像加速9大主流镜像仓库,包含详细配置步骤
无需登录即可使用轩辕镜像加速服务,更加便捷高效
需要其他帮助?请查看我们的 常见问题 或 官方QQ群: 13763429