11notes/postgres

POSTGRES!size!https://raw.githubusercontent.com/11notes/static/refs/heads/main/img/markdown/transparent5x2px.png!pulls!https://raw.githubusercontent.com/11notes/static/refs/heads/main/img/markdown/transparent5x2px.png%5B](https://github.com/11notes/docker-postgres/issues)!https://raw.githubusercontent.com/11notes/static/refs/heads/main/img/markdown/transparent5x2px.png!swiss_made

以无root权限方式运行PostgreSQL

简介 📢

PostgreSQL是一款功能强大的开源对象关系型数据库管理系统，以其可靠性、丰富的功能集和对标准的严格遵循而闻名。它同时支持SQL（关系型）和JSON（非关系型）查询，拥有庞大且活跃的社区支持。

概要 📖** 用途**：此镜像以postgres用户身份运行PostgreSQL，默认数据库名为postgres，初始密码由用户设置。设计初衷是满足99.9%的容器化PostgreSQL使用场景，无需复杂的数据库名、用户名配置。此外，若设置POSTGRES_BACKUP_SCHEDULE，镜像还会启用简单的备份调度功能，支持增量备份。

支持的PostgreSQL版本：15、16、17和18

独特价值主张 💶** 为何选择此镜像而非其他现有镜像？**答案如下：

• 以https://github.com/11notes/RTFM/blob/main/linux/container/image/rootless.md%E6%96%B9%E5%BC%8F%E8%BF%90%E8%A1%8C%EF%BC%88%E7%94%A8%E6%88%B7ID/%E7%BB%84ID%E4%B8%BA1000:1000%EF%BC%89
• 内置健康检查
• 运行于只读模式
• 发布前后自动扫描CVE漏洞
• 通过安全且固定的CI/CD流程构建
• 镜像体积极小
• 支持独立执行完整备份和增量备份

如果您重视安全性、简洁性和极致优化，此镜像可能适合您的需求。

对比 🏁

以下是本镜像与其他常用或原始镜像的对比：

| 镜像 | 磁盘大小 | 默认用户 | https://github.com/11notes/%E6%94%AF%E6%8C%81%E7%9A%84%E6%9E%B6%E6%9E%84 | | ---: | ---: | :---: | :---: | :---: | | 11notes/postgres | 49MB | 11notes/postgres | ❌ | amd64, arm64, armv7 | | postgres | 280MB | 0:0 | ❌ | 386, amd64, arm64v8, armv7, ppc64le, riscv64, s390x |

卷 📁

• /postgres/etc - 配置文件目录
• /postgres/var - 数据库文件目录

配置示例 ✂️

如果希望使用密钥而非环境变量，请查看[compose.secrets.yml](https://github.com/11notes/docker-compose.postgres/blob/master/compose.secrets.yml%E3%80%82

yaml
name: "db"

x-lockdown: &lockdown
  # 防止对镜像本身的写访问
  read_only: true
  # 防止容器内进程获取更多权限
  security_opt:
    - "no-new-privileges=true"

services:
  postgres:
    image: "11notes/postgres:18"
    <<: *lockdown
    environment:
      TZ: "Europe/Zurich"
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
      # 每天03:00执行完整压缩备份
      POSTGRES_BACKUP_SCHEDULE: "0 3 * * *"
      # 仅保留最近5个备份
      POSTGRES_BACKUP_RETENTION: 5
    ports:
      - "5432:5432/tags?name=1000,gid=1000"
      - "/postgres/log:uid=1000,gid=1000"
    restart: "always"

volumes:
  postgres.etc:
  postgres.etc:
  postgres.var:
  postgres.backup:

networks:
  frontend:

如需更改容器镜像的默认UID/GID，请参考https://github.com/11notes/RTFM/blob/main/linux/container/image/11notes/how-to.changeUIDGID.md#change-uidgid-the-correct-way%E3%80%82

默认设置 🗃️

• https://hub.docker.com/r/11notes/postgres/tags?name=18

仓库 ☁️

docker pull 11notes/postgres:18
docker pull ghcr.io/11notes/postgres:18
docker pull quay.io/11notes/postgres:18

源代码 💾

• https://github.com/11notes/docker-postgres

基础镜像 🏛️

• https://hub.docker.com/r/11notes/alpine

构建工具 🧰

• https://github.com/postgres/postgres
• https://github.com/11notes/docker-util

通用提示 📌

• 使用Traefik、Nginx、HAproxy等反向代理进行TLS终结并保护端点
• 使用Let’s Encrypt的DNS-01挑战获取有效的SSL证书

ElevenNotes™️

本镜像的使用风险由用户自行承担。更新镜像版本前请务必备份数据。查看https://github.com/11notes/docker-postgres/releases%E4%BA%86%E8%A7%A3%E9%87%8D%E5%A4%A7%E5%8F%98%E6%9B%B4%E3%80%82%E5%A6%82%E6%9C%89%E4%BD%BF%E7%94%A8%E9%97%AE%E9%A2%98%EF%BC%8C%E8%AF%B7%E6%8F%90%E4%BA%A4https://github.com/11notes/docker-postgres/issues%E3%80%82%E8%8B%A5%E6%9C%89%E7%96%91%E9%97%AE%E6%88%96%E5%BB%BA%E8%AE%AE%EF%BC%8C%E8%AF%B7%E5%88%9B%E5%BB%BAhttps://github.com/11notes/docker-postgres/discussions%E8%80%8C%E9%9D%9Eissue%E3%80%82%E6%82%A8%E5%8F%AF%E4%BB%A5%E5%9C%A8https://github.com/11notes?tab=repositories%E4%B8%8A%E6%89%BE%E5%88%B0%E6%88%91%E7%9A%84%E5%85%B6%E4%BB%96%E4%BB%93%E5%BA%93%E3%80%82

创建于 2025年11月11日 08:50:54 (CET)